searchLocalMessages

功能介绍

搜索本地消息

web不支持该接口

消息搜索只能搜索本地存储的消息,例如接收到的消息、调用拉取历史消息接口得到的消息等。

消息搜索功能仅 Flutter 3.8.0以上版本支持。

本地消息搜索为 IM 旗舰版功能,购买 旗舰版套餐包 后可使用,详见 价格说明

搜索全部会话的消息

搜索指定会话的消息

搜索典型场景示例

搜索自定义消息

搜索富媒体消息

参数详解

参数名称 参数类型 是否必填 描述
searchParam V2TimMessageSearchParam 搜索设置参数

返回模板

V2TimValueCallback<V2TimMessageSearchResult>

{
    code : number
    desc : string
    data : {
      messageSearchResultItems : V2TimMessageSearchResultItem[]// 符合搜索条件的消息列表
      totalCount : number // 符合搜索条件的消息数量
    }
}

返回值详解

名称 数值类型 描述
code number 请求结果错误码
desc string 请求结果描述
data V2TimMessageSearchResult 符合搜索条件的所有信息

代码示例

import { TencentImSDKPlugin } from 'react-native-tim-js';
// 搜索历史信息
const searchLocalMessagesRes = await TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .searchLocalMessages({
        conversationID: '', // conversationID == null,代表搜索全部会话,conversationID != null,代表搜索指定会话。
        keywordList: [], // 关键字列表,最多支持5个。当消息发送者以及消息类型均未指定时,关键字列表必须非空;否则,关键字列表可以为空。
        type: 0, // 获取历史消息类型
        userIDList: [], // 指定 userID 发送的消息,最多支持5个。
        messageTypeList: [], // 消息类型过滤列表
        searchTimePeriod: 0, // 从起始时间点开始的过去时间范围,单位秒。默认为0即代表不限制时间范围,传24x60x60代表过去一天。
        searchTimePosition: 0, // 搜索的起始时间点。默认为0即代表从现在开始搜索。UTC 时间戳,单位:秒
        pageIndex: 0, // 分页的页号:用于分页展示查找结果,从零开始起步。
        pageSize: 10, // 每页结果数量:用于分页展示查找结果,如不希望分页可将其设置成 0,但如果结果太多,可能会带来性能问题。默认为100。
    });
if (searchLocalMessagesRes.code === 0) {
    // 搜索成功
}

results matching ""

    No results matching ""