会话列表
会话列表
对于单聊、群组聊天和聊天室会话，用户发消息时 SDK 会自动创建会话并将会话添加至用户的会话列表。
环信服务器和本地均存储会话，你可以获取会话列表。服务器默认存储 100 条会话，可存储 7 天。若提升这两个上限，需联系环信商务。
前提条件
开始前，请确保满足以下条件：
技术原理
环信即时通讯 IM 支持从服务器和本地获取会话列表，主要方法如下：
IEMChatManager#getConversationsFromServerWithCursor:pageSize:completion：从服务器获取会话列表。IEMChatManager#getAllConversations:：获取本地所有会话。
实现方法
从服务器分页获取会话列表
你可以调用 IEMChatManager#getConversationsFromServerWithCursor:pageSize:completion 方法从服务端分页获取会话列表，包含单聊和群组聊天会话，不包含聊天室会话。SDK 按照会话活跃时间（会话的最新一条消息的时间戳）的倒序返回会话列表，每个会话对象中包含会话 ID、会话类型、是否为置顶状态、置顶时间（对于未置顶的会话，值为 0）以及最新一条消息。从服务端拉取会话列表后会更新本地会话列表。
提示
- 若使用该功能，需在环信控制台开通该功能，并将 SDK 升级至 4.0.3。只有开通该功能，你才能使用置顶会话和会话标记功能。
- 建议你在首次下载、卸载后重装应用等本地数据库无数据情况下拉取服务端会话列表。其他情况下，调用
getAllConversations:或getAllConversations方法获取本地所有会话即可。 - 通过 RESTful 接口发送的消息默认不创建或写入会话。若会话中的最新一条消息通过 RESTful 接口发送，获取会话列表时，该会话中的最新一条消息显示为通过非 RESTful 接口发送的最新消息。若要开通 RESTful 接口发送的消息写入会话列表的功能，需联系商务。
示例代码如下：
// pageSize: 每页返回的会话数。取值范围为 [1,50]。
// cursor：查询的开始位置。若传入 `nil` 或 `@""`，SDK 从最新活跃的会话开始获取。
NSString *cursor = @"";
[EMClient.sharedClient.chatManager getConversationsFromServerWithCursor:cursor pageSize:20 completion:^(EMCursorResult<EMConversation *> * _Nullable result, EMError * _Nullable error) {
}];
获取本地所有会话
你可以调用 getAllConversations: 方法一次性获取本地所有会话。SDK 从内存中获取会话，若未从本地数据库中加载过，会先从数据库加载到内存中。获取会话后，SDK 按照会话活跃时间（最新一条消息的时间戳）的倒序返回会话，置顶会话在前，非置顶会话在后，会话列表为 List<EMConversation> 结构。
本地会话列表包含单聊和群组聊天会话，至于是否包含聊天室会话，取决于在 SDK 初始化时 EMOptions#isDeleteMessagesWhenExitChatRoom 参数的设置。若设置为 true，即离开聊天室时删除该聊天室的所有本地消息，则本地会话列表中不包含聊天室会话。若设置为 false，即保留该聊天室的所有本地消息，则本地会话列表中包含聊天室会话。
若在初始化时，将 EMOptions#loadEmptyConversations 设置为 YES 允许返回空会话，则会话列表中会包含空会话，否则不包含。
提示
若使用该功能，需将 SDK 升级至 4.0.3。
示例代码如下：
NSArray <EMConversation *>*conversations = [EMClient.sharedClient.chatManager getAllConversations:YES];
你也可以调用 getAllConversations 方法返回 NSArray <EMConversation *> 结构的会话。