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
);参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
base | OnBase<String> | 是 | 异步请求回调。 |
conversationID | String | 是 | 目标会话的唯一标识。 |
request | ConversationReq | 是 | 会话配置请求对象。 |
请求体属性
| 属性 | 类型 | 说明 |
|---|---|---|
isMsgDestruct | boolean | 是否开启服务端消息定期清理。关闭时传入 false 即可。 |
msgDestructTime | int | 服务端消息保留时长,单位为秒,例如 3600。 |
返回结果
成功回调表示服务端已记录定期销毁策略。该设置仅作用于服务端历史消息存留,若需设置阅读后销毁,请参考开启或关闭阅后即焚。
配置生效后,SDK 会触发 OnConversationListener.onConversationChanged 事件;客户端收到通知后应根据 conversationID 更新对应会话的 isMsgDestruct 与 msgDestructTime 字段,完整监听配置请参考获取会话列表。
这个页面有帮助吗?