跳到主要内容

删除会话

删除指定会话

通过调用 removeConversation 方法,删除指定会话。

提示
  • 5.26.0 版本开始,该接口可用于删除超级群会话。
  • 5.26.2 版本开始,新增 deleteRemotely 参数,可用于在 Electron 平台下同步删除远端服务器会话数据。

参数说明

参数类型必填说明
conversationIConversationOption目标会话
deleteRemotelyBoolean是否同步删除远端服务器会话,仅对 Electron 平台有效。从 5.26.2 版本开始支持。

示例代码

JavaScript
const conversation = {
conversationType: RongIMLib.ConversationType.PRIVATE,
targetId: '接收方的 userId',
}

RongIMLib.removeConversation(conversation).then(res => {
// 删除指定会话成功
if(res.code === 0){
console.log(res.code)
} else {
console.log(res.code, res.msg)
}
})

批量删除会话

5.26.0 版本 SDK 新增 batchDeleteConversations 接口,可用于批量删除本地、远端会话及会话中的历史消息。

参数说明

参数类型必填说明
paramsConversationBatchDeletionParams

示例代码

JavaScript
const params = {
identifiers: [
{
conversationType: RongIMLib.ConversationType.PRIVATE,
targetId: '<目标会话 ID>'
},
{
conversationType: RongIMLib.ConversationType.GROUP,
targetId: '<目标会话 ID>'
},
],
deleteRemotely: true, // 非 Electron 平台下本地无存储数据,该参数无效,SDK 将删除服务器端会话
deleteMessages: false, // 是否同步删除会话下的历史消息
};

RongIMLib
.batchDeleteConversations(params)
.then(res => {
if (res.isOk) {
console.log('删除成功!')
} else {
console.log('删除失败:', res.code, res.msg)
}
})