跳到主要内容

删除消息

针对单聊会话、群聊会话、系统会话，融云支持 App 用户通过客户端 SDK 删除自己的历史消息，支持仅从本地数据库删除消息、仅从融云服务端删除自己的历史消息、或从两处同时删除。

SDK 的删除消息操作（下表中的 API）均指从当前登录用户的历史消息记录中删除一条或一组消息，不影响会话中其他用户的历史消息记录。

提示
  • App 用户的单聊会话、群聊会话、系统会话的消息默认仅存储在本地数据库中，仅支持从本地删除。如果 App（App Key/环境）已开通单群聊消息云端存储，该用户的消息还会保存在融云服务端（默认 6 个月），可从远端历史消息记录中删除消息。
  • 针对单聊会话、群聊会话，如果通过任何接口以传入时间戳的方式删除远端消息，服务端默认不会删除对应的离线消息补偿（该机制仅会在打开多设备消息同步开关后生效）。此时如果换设备登录或卸载重装，仍会因为消息补偿机制获取到已被删除的历史消息。如需彻底删除消息补偿，请提交工单，申请开通删除服务端历史消息时同时删除多端补偿的离线消息。如果以传入消息对象的方式删除远端消息，则服务端一定会删除消息补偿中的对应消息。
  • 针对单聊会话、群聊会话，如果 App 的管理员或者某普通用户希望在所有会话参与者的历史记录中彻底删除一条消息，应使用撤回消息功能。消息成功撤回后，原始消息内容会在所有用户的本地与服务端历史消息记录中删除。
  • 客户端 SDK 不提供删除聊天室消息的接口。当前用户的聊天室本地消息在退出聊天室时会被自动删除。开通聊天室消息云端存储服务后，如需清除全部用户的聊天室历史消息，可使用服务端 API 清除消息。

仅从本地删除指定消息（消息 ID）

App 用户可以按消息 ID 删除存储在本地数据库内的消息。待删除消息可以属于不同会话。一次最多删除 1000 条消息。

如果 App 已经开通单群聊历史消息云存储服务，服务端保存的该用户的历史消息记录不受影响。如果该用户从服务端获取历史消息，可能会获取到在本地已删除的消息。

TypeScript
let idList = new List<number>();
idList.add(1);
idList.add(2);
IMEngine.getInstance().deleteHistoryMessagesByIds(idList).then(result => {
  if (EngineError.Success !== result.code) {
    // 删除消息失败
    return;
  }
})

删除时需要提供待删除消息 ID 数组。

参数类型说明
messageIdsList<number>消息的 ID 数组。详见消息介绍中的 MessageId 属性。

仅从本地删除会话全部历史消息​

App 用户可能希望在设备本地清空自己的单聊、群聊或系统会话的历史记录，可以删除指定会话保存在本地数据库中的全部消息。

如果 App 已经开通单群聊历史消息云存储服务，服务端保存的该用户的历史消息记录不受影响。如果该用户从服务端获取历史消息，可能会获取到在本地已删除的消息。

TypeScript
let conId = new ConversationIdentifier();
conId.conversationType = ConversationType.Private;
conId.targetId = "会话 Id";
    
IMEngine.getInstance().deleteMessages(conId).then(result => {
  if (EngineError.Success !== result.code) {
    // 删除消息失败
    return;
  }
});

该接口一次仅允许删除指定的单个会话的消息。会话由会话类型和会话 ID 参数指定。

参数类型说明
conIdConversationIdentifier会话标识

仅从本地删除会话历史消息（时间戳）​

App 用户可能希望在设备本地清空特定时间前的单聊、群聊或系统会话的历史记录，可以删除指定会话保存在本地数据库中的特定时间前的消息。

如果 App 已经开通单群聊历史消息云存储服务，服务端保存的该用户的历史消息记录不受影响。如果该用户从服务端获取历史消息，可能会获取到在本地已删除的消息。

TypeScript
let conId = new ConversationIdentifier();
conId.conversationType = ConversationType.Private;
conId.targetId = "会话 Id";

let time = Date.now();

IMEngine.getInstance().deleteHistoryMessagesByTime(conId, time).then(result => {
  if (EngineError.Success !== result.code) {
    // 删除消息失败
    return;
  }

})
参数类型说明
conIdConversationIdentifier会话标识
timenumber时间戳，毫秒

仅从服务端删除会话历史消息（时间戳）​

提示
  • 如果 App 已经开通单群聊历史消息云存储服务，您可以调用以下接口删除 App 用户在融云服务端的历史消息记录。该接口仅从服务端删除消息。
  • 使用融云即时通讯服务端 API 也可以直接删除服务端消息。具体操作请参阅服务端文档消息清除。

App 用户可以仅删除指定会话保存在服务端的历史消息。该接口提供时间戳参数（sentTime），支持删除早于指定时间的消息。如果 sentTime 设置为 0 则删除该会话保存在服务端的全部历史消息。

TypeScript
    let conId = new ConversationIdentifier();
    conId.conversationType = ConversationType.Private;
    conId.targetId = "会话 Id";

    let time = 0;

    IMEngine.getInstance().cleanRemoteHistoryMessagesByTime(conId, time).then(result => {
      if (EngineError.Success !== result.code) {
        // 删除消息失败
        return;
      }
    });
参数类型说明
conIdConversationIdentifier会话标识
timenumber时间戳，毫秒

从服务端删除会话历史消息​

SDK 从 1.1.0 版本开始支持从服务端删除会话历史消息。

提示
  • 如果 App 已经开通单群聊历史消息云存储服务，您可以调用以下接口删除 App 用户在融云服务端的历史消息记录。该接口仅从服务端删除消息。
  • 使用融云即时通讯服务端 API 也可以直接删除服务端消息。具体操作请参阅服务端文档消息清除。

App 用户可以删除指定会话保存在服务端的历史消息。该接口提供消息列表参数（sentTime），支持删除指定一批消息。开发者也可以控制删除远端消息时是否删除本地消息。

TypeScript
let conId = new ConversationIdentifier();
conId.conversationType = ConversationType.Private;
conId.targetId = "会话 ID";

let msgList = new List<Message>();
for (let i = 0; i < 10; i++) {
  // msg 必须是发送成功的消息，此处进行简写
  let msg : Message;
  msgList.add(msg);
}

// 是否删除本地消息
let isDeleteLocal = true;

IMEngine.getInstance().deleteRemoteMessages(conId, msgList, isDeleteLocal).then(result => {
  if (EngineError.Success !== result.code) {
    // 删除远端消息失败
    return;
  }
  // 删除远端消息成功
})
参数类型说明
conIdConversationIdentifier会话标识
msgListMessage 集合消息列表
最后于 更新