SDKsWASM
用户概览
了解 WASM SDK 中的用户资料、好友关系、黑名单和在线状态。
WASM SDK 使用 userID 标识用户。实现资料卡、好友添加、联系人或黑名单功能时，首先要区分应用用户的公开资料、当前用户维护的好友关系，以及黑名单状态。
群成员列表、群内昵称、群角色和成员管理属于群组能力，相关用法见分页查询群成员。
用户类型
WASM SDK 会根据使用场景返回不同的用户对象：
| 类型 | 适用场景 | 主要接口 |
|---|---|---|
SelfUserInfo | 当前登录用户的个人资料、设置页、当前账号头像和昵称 | getSelfUserInfo()、setSelfInfo() |
PublicUserItem | 应用用户查询、添加好友候选人、陌生人资料卡 | getUsersInfo() |
FriendUserItem | 当前登录用户的好友列表、好友备注、置顶和关系扩展字段 | getFriendListPage()、getSpecifiedFriendsInfo() |
BlackUserItem | 当前登录用户黑名单中的用户 | getBlackList()、addBlack()、removeBlack() |
UserOnlineState | 用户的在线状态 | subscribeUsersStatus()、getSubscribeUsersStatus() |
同一个 userID 可能同时出现在公开资料、好友资料、黑名单和群成员资料中。展示联系人信息时优先使用 FriendUserItem；只需要账号公开资料时使用 PublicUserItem；展示群成员时优先使用 GroupMemberItem。会话列表和聊天页标题属于会话数据，应使用 ConversationItem.showName。
功能入口
下表列出了用户相关的常见需求和对应页面：
| 需求 | 推荐页面 |
|---|---|
按 userID 查询公开资料，用于查找好友候选人或展示资料卡 | 获取用户资料 |
| 分页、搜索或按 ID 查询好友关系 | 分页获取好友列表 |
| 发送或处理好友申请 | 发送好友申请、获取收到的好友申请 |
| 修改好友资料 | 更新好友资料 |
| 删除好友关系 | 删除好友 |
| 查看和维护当前用户黑名单 | 获取黑名单 |
| 读取或更新当前用户的昵称、头像和扩展资料 | 更新当前用户资料 |
| 设置账号级消息接收和免打扰策略 | 设置全局消息接收方式 |
| 订阅和读取在线状态 | 订阅用户在线状态 |
| 读取群成员列表、成员搜索、指定成员资料 | 分页查询群成员 |
状态更新
用户相关事件由对应能力页负责监听和合并：
这个页面有帮助吗？