转发消息

---

功能简介

ZIM SDK 支持实现以下两种形式的消息转发：

• 合并消息后转发。
• 逐条消息转发。

前提条件

在实现“转发消息”功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，获取到了接入 ZIM SDK 服务所需的 AppID、AppSign。ZIM 服务权限不是默认开启的，使用前，请先在 ZEGO 控制台 自助开通 ZIM 服务（详情请参考控制台的 服务配置 - 即时通讯 - 开通服务），若无法开通 ZIM 服务，请联系 ZEGO 技术支持开通。
• 已集成 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “2 集成 SDK”。

收发合并消息

发送合并消息

发送合并消息步骤如下：

1. 通过 ZIMCombineMessage 对象构造合并消息体。参数包含如下：

   参数	类型	是否必填	说明
   title	String	是	合并消息标题，长度上限默认为 20 字节。如需配置，请联系 ZEGO 技术支持。
   summary	String	是	合并消息概要，长度上限默认为 100 字节。如需配置，请联系 ZEGO 技术支持。
   messageList	List<ZIMMessage>	是	需要合并转发的原始消息列表，不支持信令、弹幕、撤回、系统类型的消息，不支持合并转发非成功的消息。

   ZIM SDK 支持在合并消息内包含其他合并消息。

2. 调用 sendMessage 接口发送合并消息。开发者可参考 收发普通消息 - 发送消息 了解此接口参数详情。

以下为用户在单聊会话中发送合并消息的示例代码：

// 在单聊会话发送合并信息

try {
    // 会话类型，取值为 单聊：peer，房间：room，群组：group
    ZIMConversationType type = ZIMConversationType.peer;
    ZIMMessageSendConfig config = ZIMMessageSendConfig();
    // 需要合并转发的原始消息列表，可从历史消息中获取
    List<ZIMMessage> messageList = [message1,message2];
    ZIMCombineMessage combineMessage = ZIMCombineMessage(title: '标题', summary: '概要', messageList: messageList);
    ZIMMessageSentResult result = await ZIM.getInstance()!.sendMessage(combineMessage, 'conv_id', type, config);
    //  消息发送成功
} on PlatformException catch (onError){
    onError.code;//根据错误码表处理
    onError.message;//错误信息
}

接收合并消息

接收合并消息的回调接口与接收普通消息的回调接口一致，请参考 收发普通消息 - 接收消息 了解具体接口。

以下为用户在单聊会话中接收合并消息的示例代码：

// 用户在单聊会话中接收合并消息
ZIMEventHandler.onReceivePeerMessage = (ZIM zim, List<ZIMMessage> messageList, String fromUserID){
    for(ZIMMessage message in messageList){
    if(message.type == ZIMMessageType.combine){
        // 合并消息
    }
    }
};

查看合并消息详情

消息操作（监听、增加以及拉取历史消息）只会返回合并消息的标题、概要、合并 ID 的信息。因此，当需要了解合并消息包含的子消息时，可以通过调用 queryCombineMessageDetail 接口查询。

操作的结果将通过 ZIMCombineMessageDetailQueriedResult 返回，可知合并消息下具体的子消息内容。

Future<ZIMCombineMessageDetailQueriedResult> queryCombineMessageDetail(ZIMCombineMessage message);

try {
    // 会话类型，取值为 单聊：peer，房间：room，群组：group
    ZIMCombineMessageDetailQueriedResult result = await ZIM.getInstance()!.queryCombineMessageDetail(combineMessage);
    // 查看合并消息，具体的子消息在回调中的 message 的 messageList 里。
    result.message.messageList;
    //  消息发送成功
} on PlatformException catch (onError){
    onError.code;//根据错误码表处理
    onError.message;//错误信息
}

若子消息列表中存在合并消息，要想获取该合并消息下的具体子消息，需再次调用 queryCombineMessageDetail 接口，将通过接口获取到的合并消息作为参数，以此类推，对于嵌套多层的合并消息会存在多次调用的情况。

逐条转发消息

逐条转发消息本质上就是将已发送成功的消息作为参数发送到其它会话，与发送普通消息所用接口相同，开发者可参考 收发普通消息 - 发送消息 了解此接口参数详情。