This document introduces the user status subscription feature, enabling developers to monitor and receive real-time notifications of specified users’ online or offline status changes via the SDK API. It’s essential for apps needing real-time communication, status sync, or user activity tracking.
Features
Real-time status notification
- Cross-platform notification: Get real-time status updates across all platforms (Android, iOS, Web, PC, Mini Program).
- Initial status retrieval: On first subscription, receive the user’s online status immediately via callback. If offline, the status is returned within 7 days; after that, no status is returned.
Subscription limits
- Subscription limit: Each user can subscribe to up to 1000 others.
- Subscribed user limit: A user’s status can be subscribed to by up to 5000 users.
Supported versions
This feature is supported in the following SDK versions:
- Android IMLib SDK 5.8.1+
- iOS IMLib SDK 5.8.1+
- Web IMLib SDK 5.9.8+
- Electron IMLib SDK 5.9.8+
Service activation
Enable the service in the Console. Navigate to Chat settings → Chat pricing plans → **Client-side user status subscription
** to activate.
Product pricing
- Billing instructions for Chat Premium Plan and Chat Ultimate Plan (China)
- Billing description for Chat Premium Plan and Chat Ultimate Plan (Global - Singapore Data Center)
User manual
-
Web: https://docs.rongcloud.io/web-imlib/user/subscribe_online
-
Android: https://docs.rongcloud.io/android-imlib/user/subscribe_online
-
iOS: https://docs.rongcloud.io/ios-imlib/user/subscribe_online
-
Server:
- Set user subscription relationship: https://docs.rongcloud.io/platform-chat-api/user/set-subscription-relationship
- Query user subscription relationship: https://docs.rongcloud.io/platform-chat-api/user/query-subscription-relationship