回复消息

---

功能简介

ZIM SDK 支持会话内回复消息功能，即引用接收到的某一条消息进行针对性的回复，形成起始于该消息的消息回复树状结构。通过此功能，用户可针对某一条消息进行提问、反馈或补充相关背景信息。

概念解释

本功能涉及概念如下：

• 根消息：回复树的起点，通常是某个特定讨论的起始消息。
• 子消息：是指对某条消息的直接或间接回复。
• 源消息：是指某条回复的上一级消息。
• 回复数：根消息收到的回复数量。

以群聊会话消息 A、B 和 C 为例：

1. 消息 B 回复了消息 A，则：
   • 消息 A 是根消息。
   • 消息 A 是消息 B 的源消息。
   • 消息 B 是消息 A 的子消息。
2. 消息 C 回复了消息 B，则：
   • 消息 B 为消息 C 的源消息，
   • 消息 C 是消息 B 的子消息。
3. 消息 B 和消息 C 都是消息 A 的子消息。
4. 消息 A 的回复数是 2。消息 B 没有回复数。

前提条件

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

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

回复一条消息

登录 ZIM 后，用户可以监听 peerMessageReceived 和 groupMessageReceived 回调接收单聊会话和群聊会话的新消息，或调用 queryHistoryMessage 接口拉取历史消息。

此时，用户可以选择其中某条消息进行回复，即将该消息作为 toOriginalMessage 参数，并构造一个消息作为回复内容作为 message 参数，调用 replyMessage 接口。

除了上述必要参数之外，您还可以根据业务需求构造 notification 对象，监听如下回调：

• onMessageAttached：在回复发送前，可以获得一个临时的 ZIMMessage，以便您添加一些业务处理逻辑。
• onMediaUploadingProgress：当发送包含富媒体的消息时，此回调将提供文件上传进度的更新。

发送结果将通过 ZIMMessageSentResult 返回。

// 引用的源消息对象，通过 queryHistoryMessage 或者 peerMessageReceived 和 groupMessageReceived 获取。
var toOriginalMessage = {};

var config = { 
    priority: 1, // 设置消息优先级，取值为 低：1（默认），中:2，高：3
};

var messageTextObj = { type: 1, message: '回复消息内容' };
var notification = {
    onMessageAttached: function(message) {
        // todo: Loading
    },
    onMediaUploadingProgress: (message, currentFileSize, totalFileSize) => {
        // 当发送的回复消息为富媒体消息时，可用于展示文件上传进度
    },
}

zim.replyMessage(messageTextObj, toOriginMessage, config, notification)
    .then(function ({ message }) {
        // 发送成功
    })
    .catch(function (err) {
        // 发送失败
    });

判断消息是否回复其他消息

监听 peerMessageReceived 和 groupMessageReceived 回调在单聊会话和群聊会话中收到新消息后，需要通过判断消息是否存在 repliedInfo（源消息基本信息）：

• 如果存在，则表示这条消息是对其他消息的回复。
• 如果不存在，则表示这条消息是一条独立消息。

当您获取到 repliedInfo，可用于展示源消息的发送用户、发送时间和消息内容等。

// 在单聊会话接收消息
zim.on('peerMessageReceived', function (zim, { messageList, info, fromConversationID }) {
    messageList.forEach((msg) => {
        if (msg.repliedInfo) {
            // 此回复消息引用的源消息的基本信息，用于展示源消息的发送者、发送时间、消息内容等
        }
    });
});

// 在群聊会话接收消息
zim.on('groupMessageReceived', function (zim, { messageList, info, fromConversationID }) {
    messageList.forEach((msg) => {
        if (msg.repliedInfo) {
            // 此回复消息引用的源消息的基本信息，用于展示源消息的发送者、发送时间、消息内容等
        }
    });
});

获取根消息回复数

ZIM 支持主动或被动获取某条根消息的回复数。

主动获取

如需主动获取某条根消息的回复数，可直接通过 ZIMMessage > rootRepliedCount 获取。

被动获取

如需实时了解根消息收到了多少条回复，您可以监听 messageRepliedCountChanged。

// 监听根消息的回复数量变化
// 事件触发时机：当有新的回复消息发送成功后，其回复树的根消息的回复数量会增加 1
zim.on('messageRepliedCountChanged', function (zim, { infos }) {
    infos.forEach(({ count, messageID, conversationID, conversationType }) => {
        // 更新会话的对应 messageID 的消息的 rootRepliedCount
    });
});

监听源消息被删除或撤回

监听 messageRepliedInfoChanged 回调，即可在某条消息被删除或被撤回时，获取该消息的下一级子消息列表，您可以在相关子消息 UI 上展示相关提示。

// 监听回复消息的源消息变更事件
// 事件触发时机：当源消息被 “删除” 和 “撤回” 后，引用其的回复消息的 repliedInfo 属性会发生改变
zim.on('messageRepliedInfoChanged', function (zim, { messageList }) {
    messageList.forEach((msg) => {
        if (msg.repliedInfo) {
            if (msg.repliedInfo.state != 0) {
                // 此回复消息引用的源消息被删除，此时可展示为“消息被删除”
            } else if (msg.repliedInfo.messageInfo.type == 31) {
                // 此回复消息引用的源消息被撤回，此时可展示为“消息已撤回”
            }
        }
    });
});

查询回复列表

调用 queryMessageRepliedList，传入根消息或任意回复，即可查看完整的回复列表，了解回复相关的完整消息列表。

本接口返回的结果将区分根消息（rootRepliedInfo）和回复列表（messageList），回复列表会按照回复的发送时间从前往后排序。

var replyMessage = {}; // 可为根消息或任意回复，一般通过 queryHistoryMessage 接口或者 peerMessageReceived 和 groupMessageReceived 获取

var config = {
    count: 10, // 查询数量，上限请勿超过 100
    nextFlag: 0, // 分页标志，首次查询填 0，后续查询以查询结果返回的 nextFlag 为准
};

zim.queryMessageRepliedList(replyMessage, config)
    .then(({ nextFlag, rootRepliedInfo, messageList }) => {
        // 查询成功
        // nextFlag 不为 0，表示还有数据，可继续分页查询
        // rootRepliedInfo 为根消息信息
        // messageList 表示对根消息的回复列表。
    })
    .catch((err) => {
        // 查询失败
    });

查看源消息的上下文

由于子消息（即作为回复的消息）的 repliedInfo 仅包含可用于 UI 展示的基本源消息数据，用户可能需要前往源消息的原文位置，阅读源消息附近的其他消息。

因此，如需实现此场景，需要借助子消息的 repliedInfo.messageSeq（源消息在会话中的序号）属性。

根据源消息及其附近消息是否缓存于应用内存，ZIM 提供了两种实现方案。

源消息及其附近均缓存于应用内存

当某条源消息及其上下文消息都保存于您应用的内存中时（比如，此前以调用 queryHistoryMessage 获取并缓存了会话历史消息），您可在内存检索该源消息的 messageSeq，自行实现前往源消息原文位置查看上下文的业务逻辑。

源消息或其附近的消息没有缓存于应用内存

当应用内存中没有源消息或其附近的消息时，此时，会话中若有其他用户回复了该源消息，即可：

1. 从该消息的 repliedInfo.messageSeq 获取到源消息的 messageSeq 并作为参数，传入 queryMessages 获取源消息的完整 ZIMMessage 对象。

   var messageSeqs = []; // messageSeq 为源消息的在会话中的序号
   
   var conversationID = '';
   var conversationType = 0; // 会话类型，取值为 单聊：0，群组：2
   
   zim.queryMessages(messageSeqs, conversationID, conversationType)
       .then(({ messageList }) => {
           // 查询成功
       })
       .catch((err) => {
           // 查询失败
       });

2. 将源消息对象作为 nextMessage 参数，传入 queryHistoryMessage，即可以该源消息为锚点，从该源消息往前或往后获取其附近的消息列表，用于 UI 渲染。

   // 本示例以源消息往后查询为例
   var originalMessage = {};
   var config = {
       // originalMessage 为通过 queryMessages 获取到的源消息对象
       nextMessage: originalMessage,
       count: 20,
       reverse: false,
   };
   
   var conversationID = '';
   var conversationType = 0;
   
   zim.queryHistoryMessage(conversationID, conversationType, config)
       .then((res) => {
           //查询成功
       })
       .catch((err) => {
           // 查询失败
       });