• IMLib / IMKit >
 
• 无 UI SDK（IMLib） >
 
• 消息相关 >
 
• 删除消息

删除消息

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

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

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

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

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

 
int[] messageIds = {12, 13};
RongCoreClient.getInstance().deleteMessages(messageIds, new IRongCoreCallback.ResultCallback<Boolean>() {
             /**
             * 删除消息成功回调
             */
            @Override
            public void onSuccess(Boolean bool) {

            }
            /**
             * 删除消息失败回调
             * @param errorCode 错误码
             */
            @Override
            public void onError(IRongCoreEnum.CoreErrorCode coreErrorCode) {

            }
        });
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

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

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

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

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

 
ConversationType conversationType = ConversationType.PRIVATE;
String targetId = "会话 Id";

RongCoreClient.getInstance().deleteMessages(conversationType, targetId, new IRongCoreCallback.ResultCallback<Boolean>() {
        /**
         * 删除消息成功回调
         */
        @Override
        public void onSuccess(Boolean bool) {

        }
        /**
         * 删除消息失败回调
         * @param errorCode 错误码
         */
        @Override
        public void onError(IRongCoreEnum.CoreErrorCode coreErrorCode) {

        }
    });
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

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

删除会话内指定消息（消息对象）

如果 App 用户希望从自己的单聊、群聊或系统会话的历史记录中彻底删除一条消息，可以使用 deleteRemoteMessages 从本地和服务端同时删除消息。删除成功后，该用户无法从本地数据库获取消息。如果从服务端获取历史消息，也无法获取到已删除的消息。

该接口允许一次删除指定的单个会话内的一条或一组消息。请确保所提供的消息均属于同一会话（由会话类型和会话 ID 指定）。一次最多删除 100 条消息。

 
ConversationType conversationType = ConversationType.PRIVATE;
String targetId = "会话 Id";
Message[] messages = {message1, message2};

RongCoreClient.getInstance().deleteRemoteMessages(conversationType, targetId, messages, new IRongCoreCallback.OperationCallback() {
    /**
     * 删除消息成功回调
     */
    @Override
    public void onSuccess() {

    }
    /**
     * 删除消息失败回调
     * @param errorCode 错误码
     */
    @Override
    public void onError(IRongCoreEnum.CoreErrorCode coreErrorCode) {

    }
});
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

删除会话历史消息（时间戳）

如果 App 用户希望从自己的单聊、群聊或系统会话的历史记录中删除一段历史消息记录，可以使用 cleanHistoryMessages 删除会话中早于某个时间点（recordTime）的消息。cleanRemote 参数控制是否同时删除服务端对应的历史消息。

 
ConversationType conversationType = ConversationType.PRIVATE;
String targetId = "会话 Id";
long recordTime = 0;
Boolean cleanRemote = true; // 同时从服务端删除对应的消息历史记录

RongCoreClient.getInstance().cleanHistoryMessages(conversationType, targetId, recordTime, cleanRemote,
    new IRongCoreCallback.OperationCallback() {
    /**
     * 删除消息成功回调
     */
    @Override
    public void onSuccess() {

    }
    /**
     * 删除消息失败回调
     * @param errorCode 错误码
     */
    @Override
    public void onError(IRongCoreEnum.CoreErrorCode coreErrorCode) {

    }
});

              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

如果 cleanRemote 参数设置为 true，表示需要同时删除服务端对应消息，该接口会从本地和服务端同时删除早于 （recordTime）的消息。服务端消息删除后，该用户无法再从服务端获取到已删除的消息。该接口一次仅允许删除指定的单个会话的消息，会话由会话类型和会话 ID 参数指定。

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

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

 
ConversationType conversationType = ConversationType.PRIVATE
String targetId = "会话 Id";
long recordTime = 0;

RongCoreClient.getInstance().cleanRemoteHistoryMessages(conversationType, targetId, recordTime, new IRongCoreCallback.OperationCallback() {
    /**
     * 删除消息成功回调
     */
    @Override
    public void onSuccess() {

    }
    /**
     * 删除消息失败回调
     * @param errorCode 错误码
     */
    @Override
    public void onError(IRongCoreEnum.CoreErrorCode coreErrorCode) {

    }
});
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21