跳到主要内容

版本:2.X

消息删除

本地删除

Web 没有本地存储,不提供本地删除功能。

远端删除

通过消息 ID 删除

API 参考:deleteRemoteMessages

参数说明

参数类型必填说明最低版本
conversationTypeNumber会话类型,单聊会话传 RongIMLib.ConversationType.PRIVATE2.5.3
targetIdString单聊会话 ID2.5.3
messagesObject要删除的消息数组, 不能超过 100 条2.5.3
callbackObject回调对象2.2.0
callback.onSuccessFunction成功回调2.2.0
callback.onErrorFunction失败回调2.2.0

messages 参数说明

参数类型必填说明最低版本
messageUIdString消息 uid2.3.5
sentTimeNumber消息发送时间2.3.5
messageDirectionNumber消息发送方向2.3.5

代码示例

var conversationType = RongIMLib.ConversationType.PRIVATE;
var targetId = '单聊会话 ID';
/*
message 对象可通过历史消息获取
messageUId、sentTime、messageDirection 必传, 且必须正确
*/
var messages = [
{ messageUId: 'BETR-GIM7-TNO5-89QU', sentTime: 1575965764383, messageDirection: 1 },
{ messageUId: 'AEGR-CFN7-QFJO-8OC0', sentTime: 1575965744371, messageDirection: 2 }
];
RongIMLib.RongIMClient.getInstance().deleteRemoteMessages(conversationType, targetId, messages, {
onSuccess: function() {
console.log('清除成功');
},
onError: function(error) {
console.log('清除失败', error);
}
});

通过时间戳删除

API 参考:clearRemoteHistoryMessages

参数说明

参数类型必填说明最低版本
conversationTypeNumber会话类型,单聊会话传 RongIMLib.ConversationType.PRIVATE2.3.5
targetIdString单聊会话 ID2.3.5
timestampNumber清除时间点, 该时间之前的消息将被清除2.3.5

代码示例

var params = {
conversationType: RongIMLib.ConversationType.PRIVATE,
targetId: '单聊会话 ID',
timestamp: 1513308018122 // 可取 sentTime, 收发消息和历史消息中都有 sentTime 字段
};
RongIMLib.RongIMClient.getInstance().clearRemoteHistoryMessages(params, {
onSuccess: function() {
console.log('清除成功');
},
onError: function(error) {
console.log('清除失败', error);
}
});