SDKsAndroid
用户概览
了解 Android SDK 中的当前用户资料、公开用户资料、账号设置和在线状态。
OpenIM Android SDK 使用 userID 标识用户。用户相关 API 用于读取和更新当前账号资料、查询公开用户资料，以及订阅用户在线状态。
好友、好友申请和黑名单属于用户之间的关系链能力，相关类型、API 和状态更新见关系链概览。
用户类型
Android SDK 会根据使用场景返回不同的用户对象：
| 类型 | 适用场景 | 主要 API |
|---|---|---|
LocalUser | 当前登录用户的本地资料、设置页、头像、昵称和账号级设置 | getSelfLocalUserInfo()、setSelfInfo() |
PublicUserInfo | 查询应用用户和展示公开资料卡 | getUsersInfo() |
UsersOnlineStatus | 用户在线状态和在线平台列表 | subscribeUsersOnlineStatus()、getSubscribeOnlineUsersStatus()、unsubscribeOnlineUsersStatus() |
LocalUser 表示当前登录用户，PublicUserInfo 表示可查询的公开用户资料。群成员资料、群内昵称和成员管理属于群组能力。
功能入口
下表列出了用户相关的常见需求和对应页面：
| 需求 | 推荐页面 |
|---|---|
按 userID 查询公开资料，用于展示资料卡 | 获取指定用户资料 |
| 读取或更新当前用户的昵称、头像和扩展资料 | 获取当前用户资料、更新当前用户资料 |
| 设置账号级消息接收和通知策略 | 设置全局消息接收方式 |
| 设置其他用户添加当前账号时的处理策略 | 设置好友添加权限 |
| 订阅、读取和取消在线状态 | 订阅用户在线状态、查询已订阅用户状态、取消订阅用户状态 |
| 管理好友、好友申请或黑名单 | 关系链概览 |
状态更新
Android SDK 只保留一个 OnUserListener。应用应在统一事件中心设置 listener，再把用户资料和在线状态变化分发给对应页面；本概览页不重复设置。具体事件数据和处理方式见下方归属页面：
这个页面有帮助吗？