浏览 SDKs · Android
平台
SDKsAndroid

查询已订阅用户状态

获取当前客户端已订阅用户的在线状态与多端登录信息列表。

复制

获取当前客户端已订阅用户的在线状态快照,用于恢复页面展示或主动校验在线信息。

OpenIMClient.getInstance().userInfoManager.getSubscribeOnlineUsersStatus(
    new OnBase<List<UsersOnlineStatus>>() {
        @Override
        public void onSuccess(List<UsersOnlineStatus> states) {
            // 使用 states 显示在线状态
        }

        @Override
        public void onError(int code, String error) {
            // 处理错误
        }
    }
);

参数说明

参数类型是否必填说明
baseOnBase<List<UsersOnlineStatus>>是异步请求回调。

返回结果

成功回调返回当前已订阅用户的状态列表 List<UsersOnlineStatus>。客户端应以 userID 为标识读取与维护在线状态缓存:

字段说明
userID目标用户的全局唯一 ID。
status在线状态值(1 为在线,0 为离线)。
platformIDs当前登录在线的平台列表(例如 Android、iOS、Web 等平台编号)。

如需订阅新用户或停止接收变更通知,请参阅订阅用户在线状态与取消订阅用户状态。