会话列表
大约 3 分钟
Flutter 集成文档
会话列表
对于单聊、群组聊天和聊天室会话,用户发消息时 SDK 会自动创建会话并将会话添加至用户的会话列表。
环信服务器和本地均存储会话,你可以获取会话列表。 服务器默认存储 100 条会话,若提升该上限,需联系环信商务。 如果你的会话条数超过了上限,新会话会覆盖之前的不活跃会话。
前提条件
开始前,请确保满足以下条件:
技术原理
环信即时通讯 IM 支持从服务器和本地获取会话列表,主要方法如下:
EMChatManager#fetchConversationsByOptions
:从服务器获取会话列表。EMChatManager#loadAllConversations
:获取本地所有会话。
实现方法
从服务器分页获取会话列表
你可以调用 fetchConversationsByOptions
方法从服务端分页获取会话列表,包含单聊和群组聊天会话,不包含聊天室会话。SDK 按照会话活跃时间(会话的最新一条消息的时间戳)的倒序返回会话列表,每个会话对象中包含会话 ID、会话类型、是否为置顶状态、置顶时间(对于未置顶的会话,值为 0
)以及最新一条消息。从服务端拉取会话列表后会更新本地会话列表。
提示
- 若使用该功能,需在环信控制台开通该功能,并将 SDK 升级至 V4.5.0 或以上版本。只有开通该功能,你才能使用置顶会话功能。
- 建议在 app 安装时或本地没有会话时调用该方法,否则调用
loadAllConversations
获取本地会话即可。 - 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送,获取会话列表时,该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能,需联系商务。
示例代码如下:
EMClient.getInstance.chatManager.fetchConversationsByOptions(
options: ConversationFetchOptions(),
);
获取本地所有会话
你可以调用 loadAllConversations
方法获取本地所有会话。本地会话列表包含单聊和群组聊天会话,至于是否包含聊天室会话,取决于在 SDK 初始化时 EMOptions#deleteMessagesAsExitChatRoom
参数的设置。若设置为 true
,即离开聊天室时删除该聊天室的所有本地消息,则本地会话列表中不包含聊天室会话。若设置为 false
,即保留该聊天室的所有本地消息,则本地会话列表中包含聊天室会话。
若在初始化时,将 EMOptions#enableEmptyConversation
设置为 true
允许返回空会话,则会话列表中会包含空会话,否则不包含。
try {
List<EMConversation> lists =
await EMClient.getInstance.chatManager.loadAllConversations();
// 成功加载会话。
} on EMError catch (e) {
}