contacts

abstract val contacts: Items<Contact>

得到当前容器中能够获取到的联系人序列。

contacts 可能是一个根据 Items.batch 批次发起某种网络请求的真实序列, 也可能是由当前容器内部提前缓存好的伪序列,而不会发起真正的网络请求。

联系人序列不能保证结果为 预期内的 全量 序列,尤其是对于一个 Bot 而言。 因为站在容器对于"联系人"的角度上来说,Contact 大多数情况下代表为一个"会话"。 如果一个联系人与当前容器从未构建过任何会话, 且二者之间没有硬性的"羁绊"(例如互为 好友), 则 contacts 大概率无法包含这个"未曾交流过的"联系人。

在组件支持的情况下,contact 能够在 contacts 中不存在目标的情况下主动创建二者之间的会话。 而此时 contacts 所得到的序列中也会有概率包含这些创建出的会话结果。

因此如果只是为了寻找部分具有明确标识的目标,考虑通过 contact 进行获取。