NIM SDK 的nim_qchat::Message类提供方法支持在发送消息后删除消息。

前提条件

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

实现流程

API 调用时序

sequenceDiagram



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

具体流程

1. 注册回调函数并登录。

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

   注册回调函数的示例代码如下：

   注册消息接收回调

   QChatRegRecvMsgCbParam reg_receive_message_cb_param;
   reg_receive_message_cb_param.cb = [this](const QChatRecvMsgResp& resp) {
       if (resp.res_code != NIMResCode::kNIMResSuccess) {
           // error handling
           return;
       }
       // process response
       // ...
   };
   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. 接收方在收到消息后，调用Delete方法删除消息。

   删除未读消息将影响未读数。

   示例代码如下：

   QChatDeleteMessageParam param;
   param.id_info.server_id = 123456;
   param.id_info.channel_id = 123456;
   param.timestamp = 123456;
   param.msg_server_id = 123456;
   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.cb = [this](const QChatUpdateMsgResp& resp) {
       if (resp.res_code != NIMResCode::kNIMResSuccess) {
           // error handling
           return;
       }
       // process response
       // ...
   };
   Message::Delete(param);
   
   

3. RegUpdatedCb回调触发，将消息删除结果投递至接收方和发送方。