NIM SDK 的nim_qchat::Message类提供圈组消息更新的方法，支持在发送消息后更新消息。

前提条件

• 已开通圈组功能。
• 已完成圈组初始化。

实现流程

API 调用时序

sequenceDiagram



note over QChat: 初始化
发送方 ->> QChat: 初始化
接收方 ->> QChat: 初始化
note over QChat: 注册回调函数并登录
发送方 ->> QChat: 登录圈组
接收方 ->> QChat: 注册接收消息回调
接收方 ->> QChat: 注册消息更新回调
接收方 ->> QChat: 登录圈组
note over QChat: 双方都成为同一服务器的成员
note over QChat: 双方都能访问同一频道
note over QChat: 发送方拥有发送消息的权限
note over QChat: 消息收发
发送方 ->> QChat: 在频道发送消息
QChat ->> 接收方: 投递消息(QChatMessage)
发送方 ->> QChat: 更新消息
QChat ->> 接收方: 消息更新响应(QChatUpdateMsgResp)

具体流程

1. 接收方在登录圈组前，注册RegRecvCb消息接收回调函数和RegUpdatedCb消息更新回调函数。

   示例代码如下：

   注册消息接收回调

   QChatRegRecvMsgCbParam reg_receive_message_cb_param;
   reg_receive_message_cb_param.cb = [this](const QChatRecvMsgResp& resp) {
       // process message
   };
   Message::RegRecvCb(reg_receive_message_cb_param);
   

   注册消息更新回调

   QChatRegMsgUpdatedCbParam reg_msg_updated_cb_param;
   reg_msg_updated_cb_param.cb = [this](const QChatMsgUpdatedResp& resp) {
       if (resp.res_code != NIMResCode::kNIMResSuccess) {
           // error handling
           return;
       }
       // process response
       // ...
   };
   Message::RegUpdatedCb(reg_msg_updated_cb_param);
   
   

2. 发送方在发送消息后，调用Update方法更新消息。

   示例代码如下：

   QChatUpdateMessageParam param;
   param.id_info.server_id = 123456;
   param.id_info.channel_id = 123456;
   param.timestamp = 0;
   param.msg_server_id = 123456;
   param.status = kMsgStatusNormal;
   param.msg_body = "message body";
   param.msg_ext = "message ext";
   param.update_info.postscript = "postscript";
   param.update_info.extension = "extension";
   param.update_info.push_content = "push content";
   param.update_info.push_payload = "push payload";
   param.message.anti_spam_info.use_custom_content = false;
   param.message.anti_spam_info.anti_spam_using_yidun = true;
   param.message.anti_spam_info.anti_spam_content = "anti spam content";
   param.message.anti_spam_info.anti_spam_bussiness_id = "anti spam bussiness id";
   param.message.anti_spam_info.yidun_callback_url = "yidun callback url";
   param.message.anti_spam_info.yidun_anti_cheating = "yidun anti cheating";
   param.message.anti_spam_info.yidun_anti_spam_ext = "yidun anti spam ext";
   param.cb = [this](const QChatUpdateMsgResp& resp) {
       if (resp.res_code != NIMResCode::kNIMResSuccess) {
           // error handling
           return;
       }
       // process response
       // ...
   };
   Message::Update(param);
   

3. RegUpdatedCb回调触发，将更新后的消息投递至接收方。