从服务器获取会话和消息
即时通讯 IM 提供消息漫游功能，即将用户的所有会话的历史消息保存在消息服务器，用户在任何一个终端设备上都能获取到历史信息，使用户在多个设备切换使用的情况下也能保持一致的会话场景。
本文介绍用户如何获取和删除服务端的会话和消息。
技术原理
即时通讯 IM SDK 通过 IAgoraChatManager 类获取和删除服务器获取历史消息，提供以下功能：
- 分页获取会话列表以及会话中的最新一条消息；
- 获取服务器保存的指定会话中的消息；
- 单向删除服务端的历史消息；
- 删除服务器端会话和历史消息。
前提条件
开始前，请确保满足以下条件：
实现方法
从服务器分页获取会话列表
你可以调用 getConversationsFromServerByPage 方法从服务端分页获取会话列表，每个会话包含最新一条历史消息。我们建议你在首次安装应用或本地设备上没有会话时调用此方法，其他情况下调用 getAllConversations 获取本地设备上的会话列表。
// pageNum：当前页面，从 1 开始。
// pageSize：每页获取的会话数量。取值范围为 [1,20]。
[AgoraChatClient.sharedClient.chatManager getConversationsFromServerByPage:pageNum pageSize:pageSize completion:^(NSArray<AgoraChatConversation *> * _Nullable aConversations, AgoraChatError * _Nullable aError) {
}];对于使用 getConversationsFromServer 方法未实现分页获取会话的用户，SDK 默认可拉取 7 天内的 10 个会话，每个会话包含最新一条历史消息。如需调整时间限制或会话数量，请联系 sales@agora.io。
从服务器获取指定会话的历史消息
你可以调用 asyncFetchHistoryMessagesFromServer 方法从服务器获取指定会话的消息（消息漫游）。你可以指定消息查询方向，即明确按服务器接收消息的时间顺序或时间倒序获取消息。为确保数据可靠，我们建议你每次获取少于 50 条消息，可多次获取。拉取后默认 SDK 会自动将消息更新到本地数据库。
[[AgoraChatClient sharedClient].chatManager asyncFetchHistoryMessagesFromServer:conversation.conversationId conversationType:conversation.type startMessageId:@"startMsgId" pageSize:10 completion:^(AgoraChatCursorResult<AgoraChatMessage *> * _Nullable aResult, AgoraChatError * _Nullable aError) {
[conversation loadMessagesStartFromId:@"startMsgId" count:10 searchDirection:AgoraChatMessageSearchDirectionUp completion:nil];
}];单向删除服务端的历史消息
你可以调用 removeMessagesFromServerWithTimeStamp 或 removeMessagesFromServerMessageIds 方法单向删除服务端的历史消息，每次最多可删除 50 条消息。消息删除后，该用户无法从服务端拉取到该消息。其他用户不受该操作影响。已删除的消息自动从设备本地移除。
多设备登录时，若你在一台设备上单向删除服务端的历史消息，其他设备会收到 multiDevicesMessageBeRemoved 事件。
示例代码如下：
// 按时间戳删除历史消息
AgoraChatConversation* conversation = [AgoraChatClient.sharedClient.chatManager getConversationWithConvId:@"conversationId"];
[conversation removeMessagesFromServerWithTimeStamp:timeToRemove completion:^(AgoraChatError * _Nullable aError) {
}];
// 按消息 ID 删除历史消息
[conversation removeMessagesFromServerMessageIds:@[@"msgId1",@"msgId2"] completion:^(AgoraChatError * _Nullable aError) {
}];删除服务端会话及其历史消息
你可以调用 deleteServerConversation 方法删除服务器端会话和历史消息。会话删除后，当前用户和其他用户均无法从服务器获取该会话。若该会话的历史消息也删除，所有用户均无法从服务器获取该会话的消息。
示例代码如下：
[AgoraChatClient.sharedClient.chatManager deleteServerConversation:@"conversationId1" conversationType:AgoraChatConversationTypeChat isDeleteServerMessages:YES completion:^(NSString *aConversationId, AgoraChatError *aError) {
}];
