getUsersInfo

功能介绍

获取用户资料

获取自己的资料,传入自己的 ID 即可。

userIDList 建议一次最大 100 个,因为数量过多可能会导致数据包太大被后台拒绝,后台限制数据包最大为 1M。

您可以调用 getUsersInfo 接口查询非好友资料,其中参数 userIDList 填入非好友的 UserID 即可。

不能修改非好友的资料。

获取用户资料为什么不是最新的?

SDK 中用户资料的更新分好友和陌生人两种情况:

好友资料:由于好友资料更新时,后台会主动向 SDK 发送系统通知,因此好友资料可以实时更新。

陌生人资料:陌生人资料更新时,由于没有好友关系,后台无法向 SDK 发送系统通知,因此无法实时更新;为了避免每次获取用户资料都向后台发起网络请求,SDK 增加了缓存逻辑,对同一个用户主动向后台拉取资料的时间间隔为 10 分钟。

参数详解

参数名称 参数类型 是否必填 平台 描述
userIDList List< String > 全部 需要查询的用户id列表

返回模板

V2TimValueCallback<List<V2TimUserFullInfo>>

{
    code : int
    desc : String
    data : List<V2TimUserFullInfo>//查询到的用户资料列表
}

返回值详解

名称 数值类型 描述
code int 请求结果错误码
desc String 请求结果描述符
data List< V2TimUserFullInfo > 查询到的用户资料列表

代码示例

    //获取用户资料
    V2TimValueCallback<List<V2TimUserFullInfo>> getUsersInfoRes =
        await TencentImSDKPlugin.v2TIMManager.getUsersInfo(userIDList: []);//需要查询的用户id列表
    if (getUsersInfoRes.code == 0) {
      // 查询成功
      getUsersInfoRes.data?.forEach((element) {
        element.allowType;//用户的好友验证方式 0:允许所有人加我好友 1:不允许所有人加我好友 2:加我好友需我确认
        element.birthday;//用户生日
        element.customInfo;//用户的自定义状态 
        element.faceUrl;//用户头像 url
        element.gender;//用户的性别 1:男 2:女
        element.level;//用户的等级
        element.nickName;//用户昵称
        element.role;//用户的角色
        element.selfSignature;//用户的签名
        element.userID;//用户 ID
      });
    }

results matching ""

    No results matching ""