sud.getUserInfo

sud.getUserInfo(object)

获取用户昵称和头像，返回的数据可直接用于游戏内展示。

参数

Object object

属性	类型	必填	说明
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数，成功、失败都会执行

回调参数

success

属性	类型	说明
nickname	string	用户昵称
avatar	string	用户头像

fail

属性	类型	说明
errCode	number	错误码
errMsg	string	错误信息

complete

不携带参数，在 success 或 fail 之后调用。

使用说明

• 通过用户主动操作发起获取；如当前运行环境要求授权，先完成相应授权。
• 使用 res.nickname 和 res.avatar 读取结果，返回值中没有 avatarUrl 字段。
• 本接口不返回手机号等敏感资料。需要获取完整用户资料时，使用 sud.getUserProfile。
• 获取失败时，通过 fail 处理错误并提示用户重试。接入流程见登录与用户信息获取流程。

示例代码

sud.getUserInfo({
    success(res) {
        const nickname = res.nickname;
        const avatar = res.avatar;
        // 使用 nickname 和 avatar 更新游戏内的用户展示。
    },
    fail(err) {
        console.error('获取用户信息失败', err.errCode, err.errMsg);
    },
});