跳到主要内容

管理离线消息存储配置

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

提示

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

了解离线消息​

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

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

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

App 级别离线消息配置​

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

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

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

用户级别离线消息配置​

提示

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

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

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

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

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

[[RCCoreClient sharedCoreClient] setOfflineMessageDuration:7
                                                 success:^{

                                                 } failure:^(RCErrorCode nErrorCode) {

                                                 }];
参数类型说明
durationint离线消息存储时长，范围为 1-7天。
successBlockBlock设置成功的回调。
errorBlockBlock设置失败的回调。nErrorCode 返回错误码 RCErrorCode。

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

提示

从 5.3.0 版本 RCCoreClient 开始，建议使用下方异步返回结果的接口，原同步接口同时废弃。

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

[[RCCoreClient sharedCoreClient] getOfflineMessageDuration:^(int duration) {
        //成功
    }]
最后于 更新