浏览 SDKs · Android
平台
SDKsAndroid

按 ID 查找消息

根据客户端消息 ID 列表精确定位查找消息。

复制

根据会话 ID 与一组客户端消息 ID(clientMsgID)精确定位并拉取消息。适用于通知栏点击、自定义业务跳转或离线回执等具备明确消息 ID 的场景。

SearchParams params = new SearchParams();
params.setConversationID("si_user_a_user_b");
params.setClientMsgIDList(Arrays.asList("msg_001", "msg_002"));

List<SearchParams> searchParamsList = Collections.singletonList(params);

OpenIMClient.getInstance().messageManager.findMessageList(
    new OnBase<SearchResult>() {
        @Override
        public void onSuccess(SearchResult result) {
            // result 包含匹配到的消息结果
        }

        @Override
        public void onError(int code, String error) {
            // 处理查找失败
        }
    },
    searchParamsList
);

参数说明

参数类型是否必填说明
baseOnBase<SearchResult>是异步请求回调。
searchParamsList<SearchParams>是查询参数对象列表。每个 SearchParams 必须设置 conversationID 与待查询的客户端消息 ID 列表 clientMsgIDList。

返回结果

成功回调返回 SearchResult 对象,内部包含各会话匹配到的消息列表。客户端应以 clientMsgID 为标识更新本地消息状态或导航定位至对应气泡。

若需要按关键词模糊搜索消息内容,请参阅搜索消息。