浏览 SDKs · uni-app / uni-app x
SDKsuni-app

查询已订阅用户状态

读取当前账号已经订阅的用户在线状态快照。

复制

getSubscribeUsersStatus() 返回当前账号已订阅用户的状态快照,不接收用户 ID 参数。

import { getSubscribeUsersStatus } from '@/uni_modules/unix-openim-sdk'

const result = await getSubscribeUsersStatus()
const statuses = result?.statuses ?? []
statuses.forEach((status) => replaceUserStatus(status.userID, status))

空结果可能表示尚未订阅、订阅用户当前没有可用状态,或服务端返回空列表。不要只用数组长度判断连接是否正常。

持续变化仍由 onUserStatusChanged 提供,完整订阅和清理见订阅用户在线状态。本方法适合 App 恢复前台或状态 store 重建时重新获取快照。