浏览 SDKs · Android
SDKsAndroid

获取指定用户资料

按 userID 批量查询应用用户公开资料(PublicUserInfo)。

复制

getUsersInfo()userID 查询应用用户的公开资料,适合展示好友候选人和陌生人资料卡。

查询公开资料

调用 getUsersInfo() 并传入要查询的用户 ID 列表,即可获取这些用户的公开资料。调用前应去除空值和重复 ID,并控制单次请求数量。

List<String> userIDs = Arrays.asList("user_a", "user_b");

OpenIMClient.getInstance().userInfoManager.getUsersInfo(
    new OnBase<List<PublicUserInfo>>() {
        @Override
        public void onSuccess(List<PublicUserInfo> users) {
            // 使用 users 显示用户资料
        }

        @Override
        public void onError(int code, String error) {
            // 处理错误
        }
    },
    userIDs
);

userIDs 是要查询的用户 ID 列表。成功 callback 返回 List<PublicUserInfo>

返回结果

字段说明
userID用户 ID。
nickname账号公开昵称。
faceURL账号公开头像地址。
ex账号公开扩展字符串,格式由业务约定。
createTime用户资料创建时间。

这里返回的 ex 用于读取用户的公开扩展资料。当前用户自己的扩展资料通过更新当前用户资料修改。

搜索添加好友

当业务已经获得候选用户的 userID 时,可以先调用 getUsersInfo() 展示公开资料,用户确认后再通过发送好友申请向目标用户发起申请。

getUsersInfo() 只按 userID 查询公开资料;昵称、手机号等其他条件的用户搜索不属于该 API。

按场景选择展示数据

同一个 userID 在不同场景中使用不同的资料类型:

场景使用的类型
用户搜索、陌生人资料卡PublicUserInfo
好友列表、联系人页和好友备注FriendInfo
群成员列表、群内昵称和群角色GroupMembersInfo

好友资料使用查询指定好友资料,群成员资料使用分页查询群成员

下一步