转发消息

---

功能简介

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

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

前提条件

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

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

收发合并消息

发送合并消息

发送合并消息步骤如下：

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

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

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

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

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

// 在单聊会话发送合并信息
ZIMConversationType type = ZIM_CONVERSATION_TYPE_PEER; // 会话类型，取值为 单聊：0，房间：1，群组：2
ZIMMessageSendConfig config;

// 需要合并转发的原始消息列表，可从历史消息中获取
std::vector<std::shared_ptr<ZIMMessage>> messageList;
messageList.push_back(message1);
messageList.push_back(message2);

std::shared_ptr<ZIMCombineMessage> combineMessage = std::make_shared<ZIMCombineMessage>("标题", "概要", messageList);

zim_->sendMessage(
    combineMessage, "conv_id", type, config,
    std::make_shared<zim::ZIMMessageSendNotification>(
        [=](const std::shared_ptr<zim::ZIMMessage> &message) {
            if (message) {
                // 开发者可以通过该回调，监听消息是否开始准备发送。只有当通过本地基础参数检验的消息才会抛出该回调，否则通过 onMessageSent 回调抛出错误。
            }
        }),
    [=](std::shared_ptr<zim::ZIMMessage> message, zim::ZIMError errorInfo) {
        // 开发者可以通过该回调监听消息是否发送成功。
        if (errorInfo.code == zim::ZIMErrorCode::ZIM_ERROR_CODE_SUCCESS) {

        }
    });

接收合并消息

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

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

// 用户在单聊会话中接收合并消息
void onReceivePeerMessage(ZIM& zim, std::vector<ZIMMessage>& messageList, 
                              std::string fromUserID) {
    for (ZIMMessage& message : messageList) {
        if (message.type == ZIMMessageType::ZIM_MESSAGE_TYPE_COMBINE) {
            // 合并消息
        }
    }
}

查看合并消息详情

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

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

virtual void
queryCombineMessageDetail(std::shared_ptr<ZIMCombineMessage> &message,
                            const ZIMCombineMessageDetailQueriedCallback &callback) = 0;

zim_->queryCombineMessageDetail(combineMessage, [=](const std::shared_ptr<ZIMCombineMessage> &message, ZIMError &errorInfo) {
    // 查看合并消息，具体的子消息在回调 message 里的 messageList 中。
});

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

逐条转发消息

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