撤回消息

撤回已发送成功的消息。

默认情况下，融云对撤回消息的操作者不作限制。如需限制，可考虑以下方案：

• App 客户端自行限制撤回消息的操作者。例如，不允许 App 业务中的普通用户撤回他人发送的消息，允许 App 业务中的管理员角色撤回他人发送的消息。
• 如需避免用户撤回非本人发送的消息，可以提交工单申请打开IMLib SDK 只允许撤回自己发送的消息。从融云服务端进行限制，禁止用户撤回非本人发送的消息。

调用 recallMessage 撤回指定消息。

提示

Electron 端 融云定义了 ObjectName 为 RC:RcNtf 的撤回通知消息。 recallMessage 会替换聊天记录中的原始消息为一条 objectName 为 RC:RcNtf 的撤回通知消息

const conversation = {
  conversationType: RongIMLib.ConversationType.PRIVATE,
  targetId: '<目标用户ID>',
}
RongIMLib.recallMessage(conversation, {
  messageUId: 'BS4O-QEBR-VJM6-9GPP',
  sentTime: 1632728573423,
})
  .then((res) => {
    if (res.code === 0) {
      console.log(res.code, res.data)
    } else {
      console.log(res.code, res.msg)
    }
  })
  .catch((error) => {
    console.log(error)
  })

参数	类型	说明
conversation	IConversation	会话。不支持系统会话。
options	消息相关	要撤回消息的相关信息。详见下方 options 参数说明。

• options 参数说明

  参数	类型	是否必填	说明
  messageUId	string	是	消息的 UId
  sentTime	number	是	消息的发送时间
  user	IUserProfile	否	撤回消息携带用户信息
  disableNotification	boolean	否	是否发送静默消息
  pushConfig	IPushConfig	否	移动端推送配置（与 Android、iOS 端的 MessagePushConfig 作用相似）
  extra	string	否	撤回消息携带扩展信息。Web SDK 从 5.3.0 版本开始支持该参数。
  isDelete	boolean	否	指定移动端接收方是否需要从本地删除原始消息记录。为 false 时，移动端不会删除原始消息记录，会将消息内容替换为撤回提示（小灰条通知）。为 true 时，移动端会删除原始消息记录，不显示撤回提示（小灰条通知）。Web SDK 从 5.3.1 版本开始支持该参数。