getConversationList method
获取会话列表
一个会话对应一个聊天窗口,比如跟一个好友的 1v1 聊天,或者一个聊天群,都是一个会话。
由于历史的会话数量可能很多,所以该接口希望您采用分页查询的方式进行调用。
该接口拉取的是本地缓存的会话,如果服务器会话有更新,SDK 内部会自动同步,然后在 V2TIMConversationListener 回调告知客户。
该接口获取的会话列表默认已经按照会话 lastMessage -> timestamp 做了排序,timestamp 越大,会话越靠前。
如果会话全部拉取完毕,成功回调里面 V2TIMConversationResult 中的 isFinished 获取字段值为 true。
最多能拉取到最近的5000个会话。
参数
nextSeq 分页拉取的游标,第一次默认取传 0,后续分页拉传上一次分页拉取成功回调里的 nextSeq
count 分页拉取的个数,一次分页拉取不宜太多,会影响拉取的速度,建议每次拉取 100 个会话
Implementation
Future<V2TimValueCallback<V2TimConversationResult>> getConversationList({
required String nextSeq,
required int count,
}) async {
return TencentCloudChatSdkPlatform.instance.getConversationList(
nextSeq: nextSeq,
count: count,
);
}