功能描述
如果您想实现类似于微信的合并转发功能，需要进行以下步骤：
1. 根据原始消息列表创建一条合并消息。
2. 把合并消息发送到对端。
3. 对端收到合并消息后解析出原始消息列表。
合并消息的展示还需要标题和摘要信息，如下图所示：
合并转发 | 合并消息展示 | 点击合并消息下载合并消息列表展示 |
| | |
合并转发消息
创建并发送合并转发消息
我们在创建一条合并消息的时候不仅要设置合并消息列表，还要设置标题和摘要信息，实现流程如下：
1. 调用
createMergerMessage (点击查看详情) 接口创建一条合并消息，创建合并消息的时候需要设置原始消息列表，合并消息标题、合并消息摘要等信息。
属性 | 含义 | 说明 |
msgIDList | 原始消息 ID 列表 | 合并转发的原始消息 ID 列表 |
title | 标题 | 合并消息的标题，如上图所示 “xixiyah 和 Hello 的聊天记录” |
abstractList | 摘要列表 | 合并消息的摘要信息，如上图所示，合并消息需要预先展示原始消息的摘要信息，当用户点击 Cell 后才去展示完整消息内容 |
compatibleText | 兼容文本信息 | 低版本 SDK 如果不支持合并消息，默认会收到一条文本消息，文本消息的内容为 compatibleText |
创建并发送合并消息示例代码如下：
// 需要被转发的消息列表，消息列表里可以包含合并消息，不能包含群 Tips 消息const msgIDList = ["msgid1", "msgid2"];const title = "user1与user2的聊天";// 合并消息标题const abstractList = ["user1:hello", "user2:你好"]; // 合并消息摘要列表const compatibleText = "当前版本不支持该消息"; // 合并消息兼容文本，低版本 SDK 如果不支持合并消息，默认会收到一条文本消息，文本消息的内容为 compatibleTextconst createMergerMessageResult =await TencentImSDKPlugin.v2TIMManager.getMessageManager().createMergerMessage(msgIDList,title, // 合并消息标题abstractList, // 合并消息摘要列表compatibleText,);if (createMergerMessageResult.code == 0) {TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage(id: createMergerMessageResult.data.id,receiver: "",groupID: "",);}
接收合并转发消息
添加监听器
示例代码如下：
TencentImSDKPlugin.v2TIMManager.getMessageManager().addAdvancedMsgListener(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;const download = await TencentImSDKPlugin.v2TIMManager.getMessageManager().downloadMergerMessage(message.msgID,);if(download.code == 0){const messageList = download.data;}}
逐条转发消息
如果您需要转发单条消息，可以先通过
createForwardMessage（点击查看详情）接口创建一条和原消息内容完全一样的转发消息，再调用 sendMessage （点击查看详情）接口把转发消息发送出去。示例代码如下：
// 创建转发消息，转发消息的 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: "");}