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
});
}