跳到主要内容

管理离线消息存储配置

即时通讯业务支持修改 App 级别与用户级别的离线消息配置。

提示

离线消息配置仅适用于单聊、群聊。聊天室、超级群因业务特性不支持离线消息，因此无离线消息配置。

了解离线消息​

离线消息?是指当用户不在线时收到的消息。融云服务端会自动为用户保留离线期间接收的消息，默认的离线消息保留时长为 7 天。7 天内客户端如果上线，服务端会直接将离线消息发送到该接收端。如果 7 天内客户端都没有上线，服务端将抛弃掉过期的消息。

即时通讯业务下并非所有会话类型都支持离线消息：

  • 支持离线消息：单聊、群聊、系统消息
  • 不支持离线消息：聊天室、超级群

App 级别离线消息配置​

如需修改 App 级别设置，请提交工单。

App 级别的离线消息配置如下：

  • 单聊离线消息存储时长：默认存储 7 天。设置范围为 1 - 7 天。配置修改将影响 App 下所有单聊会话。
  • 群聊离线消息存储时长：默认存储 7 天。设置范围为 1 - 7 天。配置修改将影响 App 下所有群聊会话。
  • 群组离线消息存储数量：默认存储 7 天内的所有群消息。配置修改将影响 App 下所有群聊会话。

用户级别离线消息配置​

提示

设置、获取用户的离线消息存储时长功能均要求已开通用户级别功能设置。如需开通，请提交工单。

即时通讯业务支持用户级别的离线消息配置，仅支持修改离线消息存储时长。未修改的情况下，用户的离线消息存储时长为 7 天。设置范围为 1 - 7 天。

App Key 开通用户级别功能设置功能后，客户端 SDK 支持修改当前登录用户的离线消息存储时长。

设置用户的离线消息存储时长​

设置当前用户的离线消息存储时长，以天为单位。

int duration = 3;

RongIMClient.getInstance().setOfflineMessageDuration(duration, new RongIMClient.ResultCallback<Long>() {
            @Override
            public void onSuccess(Long aLong) {

            }

            @Override
            public void onError(RongIMClient.ErrorCode e) {

            }
        });
参数类型说明
durationint离线消息存储时长，范围为 1 - 7 天。
callbackRongIMClient.ResultCallback<Long>回调接口。

获取用户的离线消息存储时长​

获取当前用户的离线消息存储时长，以天为单位。

RongIMClient.getInstance().getOfflineMessageDuration(new RongIMClient.ResultCallback<String>() {
            @Override
            public void onSuccess(String s) {

            }

            @Override
            public void onError(RongIMClient.ErrorCode e) {

            }
});
参数类型说明
callbackRongIMClient.ResultCallback<String>回调接口。
最后于 更新