浏览 SDKs · HarmonyOS
平台
SDKsHarmonyOS商业版

用户

了解 HarmonyOS SDK 中的用户资料、账号级设置和在线状态。

复制

OpenIMClientSDK 使用 userID 标识用户。用户领域负责当前账号资料、其他用户的公开资料、账号级消息接收方式、加好友权限和在线状态;好友、好友申请与黑名单属于“关系链”,群内昵称和角色属于群组。

资料来源

类型用途
IMUser当前用户和公开用户的账号级资料。
IMFriend好友关系资料,包含备注、置顶和关系扩展。
IMBlack当前账号维护的黑名单关系。
IMGroupMember群内昵称、头像、角色和禁言状态。
UserOnlinePlatform指定用户当前在线的平台列表。

同一用户可能同时出现在多种数据来源中。联系人列表优先展示好友备注,群成员列表使用群内昵称,会话标题使用会话的 showName;不要用公开昵称覆盖其他领域的专属展示字段。

常用操作

使用查询接口获取当前最新数据快照,通过事件监听实时合并后续变更。接口调用成功、事件通知到达以及网络重连后的重新校准属于不同处理阶段。