跳到主要内容

用户在线状态

提示

此功能从 5.32.0 版本开始支持。

功能描述​

IMKit SDK 支持展示好友和非好友的在线状态，并支持在线状态的实时更新。

此功能默认关闭，您可以通过 RongConfigCenter 开启显示用户在线状态。

开启显示用户在线状态 后，会在会话列表、联系人列表、会话页面、个人资料页的昵称左侧显示用户的在线状态图标。

关闭显示用户在线状态后，不再显示用户在线状态图标。

在线状态图标说明：

  • 绿圈：表示对方在线
  • 灰色圆圈：表示对方当前离线

效果展示​

会话列表
会话列表
联系人列表
联系人列表
会话页面
会话页面
个人资料页
个人资料页

开启显示用户在线状态​

IMKit 默认不显示用户在线状态，您可以通过 RongConfigCenter 开启此功能。

警告

开启显示用户在线状态需要在初始化之前进行设置，否则该功能无法生效。

Java
RongConfigCenter.featureConfig().enableUserOnlineStatus(true);

配置指南​

好友在线状态功能启用条件​

需同时满足以下条件：

非好友在线状态功能启用条件​

需同时满足以下条件：

  • IMKit 显示用户在线状态开关配置为 true。
  • 开启 客户端用户在线状态订阅 服务，请参考 订阅用户在线状态 文档进行开通。

IMKit 显示在线状态图标逻辑​

当满足以下条件时，IMKit 会展示在线/离线状态图标：

  1. IMKit 显示用户在线状态开关配置为 true。
  2. 下列两个服务中至少开启一个：
    • 客户端好友在线状态变更通知 服务
    • 客户端用户在线状态订阅 服务

注意事项

  • 当客户端好友在线状态变更通知与客户端用户在线状态订阅仅开启一个时：
    • 仅开启客户端好友在线状态变更通知时，非好友会一直显示为离线状态。
    • 仅开启客户端用户在线状态订阅时，好友会一直显示为离线状态。
  • IMKit 仅支持展示最近 1000 个单聊非好友会话的在线状态，超过的会话将展示为离线状态。此限制仅针对单聊且非好友的会话，好友不受此限制。