getHistoryMessageList

功能介绍

获取历史消息高级接口

该接口除了支持普通拉取单聊、群聊历史消息外，还支持以下高级特性：

• 支持设置拉取消息的位置：从本地拉取、从云端拉取。
• 支持按照指定的方向拉取：往消息时间更老的方向拉取、往消息时间更新的方向拉取。
• 支持拉取本地指定的消息类型：文本、图片、语音、视频、文件、表情、群 tips 消息、合并消息、自定义消息等。

参数详解

返回值

V2TimValueCallback<List<V2TimMessage>>

{
    code : int
    desc : String
    data : List<V2TimMessage>
}

返回值详解

代码示例

    // 拉取单聊历史消息
    // 首次拉取，lastMsgID 设置为 null
    // 再次拉取时，lastMsgID 可以使用返回的消息列表中的最后一条消息的id
    V2TimValueCallback<List<V2TimMessage>> getHistoryMessageListRes =
        await TencentImSDKPlugin.v2TIMManager
            .getMessageManager()
            .getHistoryMessageList(
      getType: HistoryMsgGetTypeEnum.V2TIM_GET_LOCAL_OLDER_MSG, // 拉取消息的位置及方向
      userID: "userID", // 用户id 拉取单聊消息，需要指定对方的 userID，此时 groupID 传空即可。
      groupID: "groupID", // 群组id 拉取群聊消息，需要指定群聊的 groupID，此时 userID 传空即可。
      count: 10, // 拉取数据数量
      lastMsgID: null, // 拉取起始消息id
      // 仅能在群聊中使用该字段。
      // 设置 lastMsgSeq 作为拉取的起点，返回的消息列表中包含这条消息。
      // 如果同时指定了 lastMsg 和 lastMsgSeq，SDK 优先使用 lastMsg。
      // 如果均未指定 lastMsg 和 lastMsgSeq，拉取的起点取决于是否设置 getTimeBegin。设置了，则使用设置的范围作为起点；未设置，则使用最新消息作为起点。
      lastMsgSeq: -1,
      messageTypeList: [], // 用于过滤历史信息属性，若为空则拉取所有属性信息。
    );
    if (getHistoryMessageListRes.code == 0) {
      //获取成功
    }