getC2CHistoryMessageList

功能介绍

获取单聊历史消息

在网络正常的情况下会拉取最新的云端数据。如果网络出现异常,SDK 会返回本地存储的历史消息。

本地存储的历史消息无时间限制,但云端存储的历史消息有存储时长的限制:

体验版:免费存储 7 天,不支持延长

专业版:免费存储 7 天,支持延长

旗舰版:免费存储 30 天,支持延长

延长历史消息存储时长是增值服务,您可以登录 即时通信 IM 控制台 修改相关配置,具体计费说明请参加 增值服务资费

富媒体消息(图片、文件、语音等)对应的文件存储时长,与历史消息存储时长保持一致。

消息存储策略

常见问题

参数详解

参数名称 参数类型 是否必填 描述
userID string 单聊用户id
count number 拉取消息的个数,不宜太多,会影响消息拉取的速度,这里建议一次拉取 20 个。但是,Web端不能超过15个。
lastMsgID string 获取消息的起始消息id,如果传 null,起始消息为会话的最新消息

返回模板

V2TimValueCallback<V2TimMessage[]>

{
    code : number
    desc : string
    data : V2TimMessage[]
}

返回值详解

名称 数值类型 描述
code number 请求结果错误码
desc string 请求结果描述
data V2TimMessage[] 获取的单聊历史消息

代码示例

// 拉取单聊历史消息
// 首次拉取,lastMsgID 设置为 null

import { TencentImSDKPlugin } from 'react-native-tim-js';

// 再次拉取时,lastMsgID 可以使用返回的消息列表中的最后一条消息的id
const getC2CHistoryMessageListRes = await TencentImSDKPlugin.v2TIMManager
    .getMessageManager()
    .getC2CHistoryMessageList(
        'userId', // 单聊用户id
        10 // 拉取数据数量
    );
if (getC2CHistoryMessageListRes.code === 0) {
    //拉取成功
}

results matching ""

    No results matching ""