获取历史消息

功能简介

ZIM SDK 支持单聊消息、群组消息、房间消息等的收发，以及获取历史消息、删除消息等功能。可广泛应用于娱乐社交、电商购物、在线教育、互动直播等多种场景下。

ZIM SDK 支持按照会话维度，获取某个会话下的所有历史消息。本文档介绍了如何使用 ZIM SDK 的接口，实现获取 单聊 历史消息、群组 历史消息和 房间 历史消息的功能。

前提条件

在实现“获取历史消息”功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，获取到了接入 ZIM SDK 服务所需的 AppID、AppSign。ZIM 服务权限不是默认开启的，使用前，请先在 ZEGO 控制台 自助开通 ZIM 服务（详情请参考控制台的 服务配置 - 即时通讯 - 开通服务），若无法开通 ZIM 服务，请联系 ZEGO 技术支持开通。
• 已集成 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “2 集成 SDK”。

使用步骤

ZIM SDK 支持获取 单聊、群组 和 房间 的会话历史记录，通过 queryHistoryMessage 接口，传入参数 conversationID、config，进行获取。

以客户端 A 获取与客户端 B 的单聊会话历史为例：

1. 客户端 A、B 登录 ZIM SDK，并相互发送、接收单聊消息。
2. 客户端 A 需要获取与 B 的会话记录时：
   1. 客户端 A 首先登录 ZIM SDK。
   2. 客户端 A 调用 queryHistoryMessage 接口，传入参数 conversationID、config，开始获取。
   3. 获取的结果，将通过 ZIMMessageQueriedCallback 回调接口通知给客户端 A。

调用接口示例

public void queryHistoryMessage(
    String conversationID,                                 
    ZIMConversationType conversationType,                                 
    ZIMMessageQueryConfig config,                                 
    ZIMMessageQueriedCallback callback
);

参数说明

参数 config，需要通过 ZIMMessageQueryConfig 类的以下参数进行配置：

示例代码

// 1、创建 ZIM 对象，传入 appID、appSign 与 Android 中的 Application
ZIMAppConfig appConfig = new ZIMAppConfig();
appConfig.appID = 12345;  //替换为您申请到的 AppID
appConfig.appSign = "appSign";   //替换为您申请到的 AppSign
zim = ZIM.create(appConfig, application);

// 2、登录
ZIMUserInfo zimUserInfo = new ZIMUserInfo();
zimUserInfo.userID = "xxxx";
zimUserInfo.userName = "xxxx";
zim.login(zimUserInfo, new ZIMLoggedInCallback() {
    @Override
    public void onLoggedIn(ZIMError error) {
          // 开发者可根据 ZIMError 来判断是否登录成功。          
    }
 });

// 3、获取单聊会话历史消息
ArrayList<ZIMMessage> curMessageList = new ArrayList();

String conversationID = "xxxx";

// 从后往前获取会话历史消息，每次获取 30 条
ZIMMessageQueryConfig config = new ZIMMessageQueryConfig();
// 首次获取时 nextMessage 为 null
config.nextMessage = null;
config.messageCount = 30;
config.reverse = true;

ZIMMessageQueriedCallback callback = new ZIMMessageQueriedCallback() {
    @Override
    public void onMessageQueried(ArrayList<ZIMMessage> messageList, ZIMError errorInfo) {
        // 开发者可以通过该回调监听获取获取到消息列表。

        curMessageList.addAll(0, messageList);

        // 手指往下滑动到屏幕最上方一条消息时，获取更早的消息
        if (fetchMore) {
            // 后续分页获取时，nextMessage 为当前获取到的消息列表的最后一条消息
            config.nextMessage = messageList.get(messageList.size() - 1);
            zim.queryHistoryMessage(conversationID, ZIMConversationType.Peer, config, callback);
        }
    }
}
zim.queryHistoryMessage(conversationID, ZIMConversationType.Peer, config, callback);