功能描述

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

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

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

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

合并转发消息

创建并发送合并转发消息

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

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

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

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

接收合并转发消息

添加监听器

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

示例代码如下：

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

解析消息

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

示例代码如下：

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

逐条转发消息

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

示例代码如下：

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

交流与反馈

欢迎加入 QQ 群进行技术交流和反馈问题，QQ 群：788910197。