本文档旨在介绍客户端用户在线状态订阅功能，该功能允许开发者通过 SDK 接口实时监控和接收指定用户的在线或离线状态变更通知。这一功能对于需要实时交流、状态同步或用户活动监控的应用场景至关重要。

功能特点

实时状态通知

• 跨平台通知：订阅成功后，无论被订阅用户在哪个终端（Android、iOS、Web、PC、小程序）上状态发生变化，订阅者都会收到实时状态通知。
• 初始状态获取：首次订阅时，如果被订阅用户在线，订阅者将立即通过回调事件获取到用户在线状态；如果用户离线， 7 天内离线会通过事件返回状态，超过 7 天不会返回状态。

订阅限制

• 订阅数量限制：一个用户最多可以订阅1000个其他用户的状态。
• 被订阅数量限制：一个用户的状态最多可以被5000个其他用户订阅。

支持的版本

此功能在以下版本的 SDK 中支持：

• Android IMLib SDK 5.8.1 及以上版本。
• iOS IMLib SDK 5.8.1 及以上版本。
• Web IMLib SDK 5.9.8 及以上版本。
• Electron IMLib SDK 5.9.8 及以上版本。

产品开通

您可以通过控制台开通服务。在融云控制台，选择 IM 服务 → IM 服务管理 → 客户端用户在线状态订阅 ，开启服务。

image1280×635 114 KB

产品计费

• IM 旗舰版、IM 尊享版计费说明（国内） 5
• IM 旗舰版、IM 尊享版计费说明（海外）

使用手册

• Web：融云开发者文档 4

• Android：融云开发者文档 5

• iOS：融云开发者文档 2

• Server：

  • 设置用户订阅关系：融云开发者文档 2

  • 查询用户订阅关系：融云开发者文档 1