getGroupHistoryMessageList
功能介绍
获取群组历史消息
在网络正常的情况下会拉取最新的云端数据。如果网络出现异常，SDK 会返回本地存储的历史消息。
直播群(AVChatRoom):仅旗舰版支持，可在控制台开启[直播群新成员查看入群前消息量配置]，支持查看24小时内最多20条消息。
会议群（Meeting）和 社群（Community）默认开启拉取到进群前的历史消息。
好友工作群（Work）和 陌生人社交群（Public）需要前往控制台手动开启。
更多关于群消息的限制，详见 消息能力差异
本地存储的历史消息无时间限制，但云端存储的历史消息有存储时长的限制：
体验版：免费存储 7 天，不支持延长
专业版：免费存储 7 天，支持延长
旗舰版：免费存储 30 天，支持延长
延长历史消息存储时长是增值服务，您可以登录 即时通信 IM 控制台 修改相关配置，具体计费说明请参加 增值服务资费 。
富媒体消息（图片、文件、语音等）对应的文件存储时长，与历史消息存储时长保持一致。
参数详解
| 参数名称 | 参数类型 | 是否必填 | 平台 | 描述 |
|---|---|---|---|---|
| groupID | String | 是 | 全部 | 群组id |
| count | int | 是 | 全部 | 拉取消息的个数，不宜太多，会影响消息拉取的速度，这里建议一次拉取 20 个。但是，Web端不能超过15个。 |
| 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>> getGroupHistoryMessageListRes =
await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.getGroupHistoryMessageList(
groupID: "groupID", // 单聊用户id
count: 10, // 拉取数据数量
lastMsgID: null, // 拉取起始消息id
);
if (getGroupHistoryMessageListRes.code == 0) {
//获取成功
}