浏览 SDKs · Android
平台
SDKsAndroid商业版

定期删除服务端消息

启用、关闭并配置指定会话的服务端历史消息定期销毁策略。

复制

为指定会话配置服务端消息定期销毁策略。启用后,服务端将按照设定的周期自动清理过期历史消息。该能力属于服务端存储策略,不同于客户端维度的阅后即焚。

ConversationReq request = new ConversationReq();
request.setMsgDestruct(true);
request.setMsgDestructTime(3600);

OpenIMClient.getInstance().conversationManager.setConversation(
    new OnBase<String>() {
        @Override
        public void onSuccess(String data) {
            // 请求已完成。
        }

        @Override
        public void onError(int code, String error) {
            // code 和 error 说明失败原因。
        }
    },
    conversationID,
    request
);

参数说明

参数类型是否必填说明
baseOnBase<String>是异步请求回调。
conversationIDString是目标会话的唯一标识。
requestConversationReq是会话配置请求对象。

请求体属性

属性类型说明
isMsgDestructboolean是否开启服务端消息定期清理。关闭时传入 false 即可。
msgDestructTimeint服务端消息保留时长,单位为秒,例如 3600。

返回结果

成功回调表示服务端已记录定期销毁策略。该设置仅作用于服务端历史消息存留,若需设置阅读后销毁,请参考开启或关闭阅后即焚。

配置生效后,SDK 会触发 OnConversationListener.onConversationChanged 事件;客户端收到通知后应根据 conversationID 更新对应会话的 isMsgDestruct 与 msgDestructTime 字段,完整监听配置请参考获取会话列表。