getC2CHistoryMessageList
功能介绍
获取单聊历史消息
- 在网络正常的情况下会拉取最新的云端数据。如果网络出现异常，SDK 会返回本地存储的历史消息。
本地存储的历史消息无时间显示，但云端存储的历史消息有存储时长的限制：
- 体验版：免费存储 7 天，不支持延长
- 专业版：免费存储 7 天，支持延长
- 旗舰版：免费存储 30 条，支持延长
参数详解
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| userID | String | 是 | 单聊用户id |
| count | int | 是 | 拉取消息的个数，不宜太多，会影响消息拉取的速度，这里建议一次拉取 20 个。 |
| lastMsgID | String | 否 | 获取消息的起始消息id，如果传 null，起始消息为会话的最新消息 |
返回值
V2TimValueCallback<List<V2TimMessage>>
{
code : int
desc : String
data : List<V2TimMessage>
}
返回值详解
| 名称 | 数值类型 | 描述 |
|---|---|---|
| code | int | 请求结果错误码 |
| desc | String | 请求结果描述 |
| data | List< V2TimMessage > | 获取的单聊历史消息 |
代码示例
// 拉取单聊历史消息
// 首次拉取，lastMsgID 设置为 null
// 再次拉取时，lastMsgID 可以使用返回的消息列表中的最后一条消息的id
V2TimValueCallback<List<V2TimMessage>> getC2CHistoryMessageListRes =
await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.getC2CHistoryMessageList(
userID: "userId", // 单聊用户id
count: 10, // 拉取数据数量
lastMsgID: null, // 拉取起始消息id
);
if (getC2CHistoryMessageListRes.code == 0) {
//拉取成功
}