NIM SDK 的NIMQChatMessageManager协议提供方法支持在发送消息后删除消息。

前提条件

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

实现流程

API 调用时序

sequenceDiagram



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

具体流程

1. 调用 addDelegate: 方法添加委托（具体回调函数如下）并登录。

   • 发送方在登录圈组前，注册onMessageUpdate:消息更新事件回调函数。
   • 接收方在登录圈组前，注册onRecvMessages:消息接收回调函数和onMessageUpdate:消息更新事件回调函数。

   示例代码如下：

   注册消息接收回调

   - (void)onRecvMessages:(NSArray<NIMQChatMessage *> *)messages
   {
       //your code, deal messages
   }
   

   注册消息更新回调

   - (void)onMessageUpdate:(NIMQChatUpdateMessageEvent *)event
   {
       
   }
   

2. 接收方在收到消息后，调用deleteMessage:completion: 方法删除消息。

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

   
   

   示例代码如下：

   id<NIMQChatMessageManager> qchatMessageManager = [[NIMSDK sharedSDK] qchatMessageManager];
   NIMQChatDeleteMessageParam *param = [[NIMQChatDeleteMessageParam alloc] init];
   param.message = message;
   NIMQChatUpdateParam *updateParam = [[NIMQChatUpdateParam alloc] init];
   updateParam.postscript = @"删除附言";
   param.updateParam = updateParam;
   [qchatMessageManager deleteMessage:param
       completion:^(NSError *__nullable error, NIMQChatUpdateMessageResult *__nullable result) {
       // your code
   }];
   

3. onMessageUpdate:消息更新事件回调触发，接收方和发送方通过该回调获取消息删除结果。