tencent cloud

功能描述

如果您想实现类似于微信的合并转发功能，需要进行以下步骤：

1. 根据原始消息列表创建一条合并消息。
2. 把合并消息发送到对端。
3. 对端收到合并消息后解析出原始消息列表。

合并消息的展示还需要标题和摘要信息，如下图所示：

合并转发	合并消息展示	点击合并消息下载合并消息列表展示

合并转发消息

创建并发送合并转发消息

我们在创建一条合并消息的时候不仅要设置合并消息列表，还要设置标题和摘要信息，实现流程如下：

1. 调用 createMergerMessage (Details) 接口创建一条合并消息，创建合并消息的时候需要设置原始消息列表，合并消息标题、合并消息摘要等信息。

创建并发送合并消息示例代码如下：

// 需要被转发的消息列表，消息列表里可以包含合并消息，不能包含群 Tips 消息
const msgIDList = ["msgid1", "msgid2"];
const title =  "user1与user2的聊天";// 合并消息标题
const abstractList = ["user1:hello", "user2:你好"]; // 合并消息摘要列表
const compatibleText = "当前版本不支持该消息"; // 合并消息兼容文本，低版本 SDK 如果不支持合并消息，默认会收到一条文本消息，文本消息的内容为 compatibleText
const createMergerMessageResult =
    await TencentImSDKPlugin.v2TIMManager
        .getMessageManager()
        .createMergerMessage(
          msgIDList,
          title, // 合并消息标题
          abstractList, // 合并消息摘要列表
          compatibleText,
        );
if (createMergerMessageResult.code == 0) {
  TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(
        id: createMergerMessageResult.data.id,
        receiver: "",
        groupID: "",
      );
}

接收合并转发消息

添加监听器

接收方调用 addAdvancedMsgListener (Details) 添加高级消息监听器。
一般建议在比较靠前的时间点调用，例如例如聊天消息界面初始化后，确保 App 能及时收到消息。

示例代码如下：

TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.addAdvancedMsgListener(listener);

解析消息

添加监听器后，接收方会在 onRecvNewMessage 中收到合并消息 V2TimMessage。
可以先通过合并消息元素 V2TimMergerElem (Details) 获取 title 和 abstractList UI 展示。
当用户点击合并消息的时候再调用 downloadMergerMessage(Details) 接口下载合并消息列表 UI 展示。

示例代码如下：

if(message.elemType == MessageElemType.V2TIM_ELEM_TYPE_MERGER){
      message.mergerElem.abstractList;
      message.mergerElem.isLayersOverLimit;
      message.mergerElem.title;
      const download = await TencentImSDKPlugin.v2TIMManager.getMessageManager().downloadMergerMessage(message.msgID,);
      if(download.code == 0){
        const messageList = download.data;
      }
}

逐条转发消息

如果您需要转发单条消息，可以先通过 createForwardMessage (Details) 接口创建一条和原消息内容完全一样的转发消息，再调用 sendMessage (Details) 接口把转发消息发送出去。

示例代码如下：

// 创建转发消息，转发消息的 elem 内容和原消息完全一致
const createForwardMessageRes = await TencentImSDKPlugin.v2TIMManager.getMessageManager().createForwardMessage("msgid");
// 发送消息给用户 "denny"
if(createForwardMessageRes.code == 0){
  TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(id: createForwardMessageRes.data.id, receiver: "denny", groupID: "");
}