会话列表

对于单聊、群组聊天和聊天室会话，用户发消息时 SDK 会自动创建会话并将会话添加至用户的会话列表。

环信服务器和本地均存储会话，你可以获取会话列表。 服务器默认存储 100 条会话，若提升该上限，需联系环信商务。 如果你的会话条数超过了上限，新会话会覆盖之前的不活跃会话。

前提条件

开始前，请确保满足以下条件：

• 完成 SDK 初始化，并连接到服务器，详见 快速开始。
• 了解环信即时通讯 IM API 的使用限制，详见 使用限制。

技术原理

环信即时通讯 IM 支持从服务器和本地获取会话列表，主要方法如下：

• EMChatManager#fetchConversationsByOptions：从服务器获取会话列表。
• EMChatManager#loadAllConversations：获取本地所有会话。

实现方法

从服务器分页获取会话列表

你可以调用 fetchConversationsByOptions 方法从服务端分页获取会话列表，包含单聊和群组聊天会话，不包含聊天室会话。SDK 按照会话活跃时间（会话的最新一条消息的时间戳）的倒序返回会话列表，每个会话对象中包含会话 ID、会话类型、是否为置顶状态、置顶时间（对于未置顶的会话，值为 0）以及最新一条消息。从服务端拉取会话列表后会更新本地会话列表。

对于每个终端用户，服务器默认存储 100 条会话。超过该限制后，新会话会覆盖旧会话。若会话中的历史消息均过期，会话变成空会话。从服务端拉取会话列表时默认不包含这些空会话，若要包含，需在 SDK 初始化时将 EMOptions#enableEmptyConversation 设置为 true。这种情况下，空会话都会占用会话拉取名额，不管拉取时是否需要。如果拉取会话时不需要空会话且不希望其占用会话列表名额，需要联系商务开通。

提示

1. 若使用该功能，需在环信控制台开通该功能，并将 SDK 升级至 V4.5.0 或以上版本。只有开通该功能，你才能使用置顶会话功能。
2. 建议在 app 安装时或本地没有会话时调用该方法，否则调用 loadAllConversations 获取本地会话即可。
3. 通过 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) {
}