获取用户资料

getUsersInfo() 可以按 userID 查询应用用户的公开资料，适合展示好友候选人、陌生人资料卡和消息发送者资料。

如果产品需要按昵称、手机号、组织、邮箱或其他业务字段检索用户，应先由业务后端完成搜索和权限校验，再把返回的 userID 传给 getUsersInfo()。管理员 Token 只能保存在可信后端，用户目录管理也必须由后端执行。

查询公开资料

传入要查询的 OpenIMSDK 用户 ID 数组。调用前应去重并控制单次请求数量；不要在长列表滚动时为每一行单独请求。

import {
  getUsersInfo,
  type OpenIMUserInfo,
} from '@/uni_modules/unix-openim-sdk'

const userIDList : Array<string> = uniqueUserIDs(['user_a', 'user_b'])
const result = await getUsersInfo(userIDList)
const users : Array<OpenIMUserInfo> = result?.users ?? []

users.forEach((user) => {
  cachePublicUser(user.userID, user)
})

Promise 成功后直接返回 OpenIMUserListResult | null，其中 users 是查询到的 OpenIMUserInfo[]；OpenIMPublicUserItem 是该资料类型的公开场景别名。返回列表不保证与输入顺序一致，也可能少于请求数量。应按 userID 建立映射，并为不存在、无权限或未返回的用户保留占位状态。

页面常用字段如下：

ex 和 attachedInfo 都不能作为可信身份、权限或认证凭据。客户端也不能通过用户 API 修改其他账号资料；当前用户自己的资料通过 setSelfInfo() 更新。

调用结果与资料刷新

以返回的 users 更新当前公开资料快照。打开资料卡、手动刷新、断线重连，或收到业务后端的资料变更通知时，重新调用该方法。页面同时展示多个用户时，先收集可见项中的 userID，去重后批量查询，再按 userID 合并结果。

SDK 没有面向任意公开用户资料的通用变更事件。onSelfInfoUpdated 只携带当前登录用户的资料，不能把它作为其他用户的公开资料写入缓存。当前账号资料的读取、更新和事件同步见更新当前用户资料。

搜索添加好友

搜索并添加好友时，通常先由业务后端返回候选 userID，再调用 getUsersInfo() 展示公开资料。用户确认目标后，再进入好友申请流程。

async function searchUsersForFriendRequest(keyword : string) : Promise<Array<OpenIMUserInfo>> {
  const userIDs = await searchUserIDsFromBusinessBackend(keyword)
  if (userIDs.length == 0) {
    return []
  }

  const result = await getUsersInfo(uniqueUserIDs(userIDs))
  return result?.users ?? []
}

如果产品只支持按用户 ID 精确搜索，可以直接把经过格式校验的输入值作为 userID 查询。模糊搜索或按敏感字段搜索时，后端必须负责鉴权、限流、脱敏和审计。

按场景选择展示数据

好友备注和群内昵称分别来自好友关系与群成员资料。相关用法见分页获取好友列表、获取指定好友资料和分页查询群成员。

下一步

• 分页获取好友列表
• 获取指定好友资料
• 获取收到的好友申请