sud.getUserInfo
获取用户基础信息(昵称、头像)。属于非敏感数据,无加密流程,可直接在客户端使用。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 获取成功回调 | |
| fail | function | 否 | 获取失败回调 | |
| complete | function | 否 | 接口结束回调,成功或失败均执行 |
回调参数
success
| 属性 | 类型 | 说明 |
|---|---|---|
| nickname | string | 用户昵称 |
| avatar | string | 用户头像 |
fail
| 属性 | 类型 | 说明 |
|---|---|---|
| errCode | number | 错误码 |
| errMsg | string | 错误信息 |
complete 不携带参数,在 success 或 fail 之后调用,单次请求只执行一次。
注意事项
- 本接口只返回公开的基础信息,不含手机号、实名等敏感字段。需要敏感信息时使用 sud.getUserProfile。
- 返回值中没有
avatarUrl字段。avatarUrl(远端头像 URL)只在sud.getUserProfile()返回的userInfo中出现。 - 用户可能修改昵称与头像。若需长期展示,应在 Game SVR 落库并在使用前重新获取,不要一次缓存后不再更新。
- 若用户尚未授权,应先通过用户主动操作完成授权,参见用户信息获取。
示例代码
javascript
sud.getUserInfo({
success: (res) => {
console.log('用户昵称', res.nickname);
console.log('用户头像', res.avatar);
},
fail: (err) => {
console.error('获取用户信息失败', err.errCode, err.errMsg);
},
complete: () => {
console.log('获取用户信息调用结束');
},
});