sud.getUserProfile
javascript
sud.getUserProfile(object)获取用户资料,包括基础信息和加密数据。基础信息可用于展示;加密数据须原样提交游戏服务端处理。
参数
Object object
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 |
| fail | function | 否 | 接口调用失败的回调函数 |
| complete | function | 否 | 接口调用结束的回调函数,成功、失败都会执行 |
回调参数
success
| 属性 | 类型 | 说明 |
|---|---|---|
| userInfo | Object | 用户基础信息,字段见下表 |
| rawData | string | 用于校验的原始数据字符串 |
| encryptedData | string | 加密后的用户数据 |
| iv | string | 服务端解密所需的参数 |
| signature | string | 服务端校验所需的签名 |
userInfo
| 属性 | 类型 | 说明 |
|---|---|---|
| nickname | string | 用户昵称 |
| avatar | string | 用户头像 |
| avatarUrl | string | 用户头像的远端 URL |
fail
| 属性 | 类型 | 说明 |
|---|---|---|
| errCode | number | 错误码 |
| errMsg | string | 错误信息 |
complete
不携带参数,在 success 或 fail 之后调用。
使用说明
- 先通过 sud.login 完成登录,并由游戏服务端建立当前用户会话。
- 将
rawData、encryptedData、iv、signature原样提交游戏服务端,不要修改字段内容或重新序列化rawData。 - 游戏客户端不解密这些数据,也不保存服务端密钥。服务端接入要求见用户敏感数据获取。
- 只需要昵称、头像时,使用 sud.getUserInfo。
示例代码
javascript
sud.getUserProfile({
success(res) {
const profileData = {
rawData: res.rawData,
encryptedData: res.encryptedData,
iv: res.iv,
signature: res.signature,
};
// 通过你的业务请求接口,将 profileData 原样提交游戏服务端。
// 基础信息可从 res.userInfo 读取。
},
fail(err) {
console.error('获取用户资料失败', err.errCode, err.errMsg);
},
});