浏览 SDKs · React Native
平台
SDKsReact Native

删除群聊中指定用户的全部消息

OpenIM React Native SDK 删除群聊中指定用户的全部消息。

复制

删除指定用户在群聊会话中的全部历史消息。此操作通常由群主或管理员发起,用于清理违规用户在群内的发言。

await OpenIMSDK.deleteUserAllMessagesInConv({
  conversationID,
  userID,
});

参数说明

参数类型必填含义
conversationIDstring是目标群聊的会话 ID。
userIDstring是要删除其全部发言的用户 ID。

返回结果

调用成功代表删除请求已被服务端接受并处理完成。操作权限由群内角色及服务端策略校验,非群管理员调用将返回错误。

监听指定用户消息删除

删除完成后会触发 OnDeleteUserAllMsgsInConv 事件。回调携带包含目标 conversationID 和 userID 的数据对象,客户端应根据 conversationID 定位目标会话,并移除该会话中由该 userID 发送的所有消息。

interface DeleteUserAllMsgsData {
  conversationID: string;
  userID: string;
}

const handleUserMessagesDeleted = (data: DeleteUserAllMsgsData) => {
  // 根据 data.conversationID 找到当前会话,并以 data.userID 为过滤条件移除该用户的历史消息
};

// 设置监听
OpenIMSDK.on(
  OpenIMEvent.OnDeleteUserAllMsgsInConv,
  handleUserMessagesDeleted,
);

// 取消监听
OpenIMSDK.off(
  OpenIMEvent.OnDeleteUserAllMsgsInConv,
  handleUserMessagesDeleted,
);

组件销毁、退出登录或切换账号时,取消该监听。