本文檔旨在介紹客戶端用戶在線狀態訂閱功能，該功能允許開發者通過 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