浏览 SDKs · Android
平台
SDKsAndroid含商业版能力

用户概览

了解 Android SDK 中的当前用户资料、公开用户资料、账号设置和在线状态。

复制

OpenIM Android SDK 使用 userID 标识用户。用户相关 API 用于读取和更新当前账号资料、查询公开用户资料,以及订阅用户在线状态。

好友、好友申请和黑名单属于用户之间的关系链能力,相关类型、API 和状态更新见关系链概览。

用户类型

Android SDK 会根据使用场景返回不同的用户对象:

类型适用场景主要操作
LocalUser当前登录用户的本地资料、设置页、头像、昵称和账号级设置获取当前用户资料、更新当前用户资料
PublicUserInfo查询应用用户和展示公开资料卡获取指定用户资料
UsersOnlineStatus用户在线状态和在线平台列表订阅用户在线状态、查询已订阅用户状态、取消订阅用户状态

LocalUser 表示当前登录用户,PublicUserInfo 表示可查询的公开用户资料。群成员资料、群内昵称和成员管理属于群组能力。

功能入口

下表列出了用户相关的常见需求和对应页面:

需求推荐页面
按 userID 查询公开资料,用于展示资料卡获取指定用户资料
读取或更新当前用户的昵称、头像和扩展资料获取当前用户资料、更新当前用户资料
设置账号级消息接收和通知策略设置全局消息接收方式
设置其他用户添加当前账号时的处理策略设置好友添加权限
订阅、读取和取消在线状态订阅用户在线状态、查询已订阅用户状态、取消订阅用户状态
管理好友、好友申请或黑名单关系链概览

状态更新

Android SDK 的 UserInfoManager 采用单实例 listener 机制。应用应在全局事件中心统一注册 OnUserListener,并按 userID 唯一定位用户进行本地资料缓存更新与视图分发。具体事件载荷与处理逻辑请参考下方归属页面: