本文档旨在介绍客户端用户在线状态订阅功能,该功能允许开发者通过 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 服务管理 → 客户端用户在线状态订阅 ,开启服务。