updateUserInfo
相关内容:
该接口用于从微信获取用户信息(昵称、头像等),并上传到星汉平台。
调用此接口后,下次调用 login
时,即可从星汉sdk获取上一次 updateUserInfo
中返回的用户信息。
关于用户信息的更新策略,开发者可参考 用户信息授权 中的 何时触发大授权 。
调用方法
import XH_MINIPRO_SDK from './utils/xh_minipro_sdk_1.5.0.min.js'
XH_MINIPRO_SDK.updateUserInfo({encryptedData,iv,signature}).then(res=>{})
参数说明
字段 | 字段类型 | 小程序 | 小游戏 |
---|---|---|---|
encryptedData | string | 在点击事件e中获取 | 在 UserInfoButton 回调中获取 |
iv | string | 在点击事件e中获取 | 在 UserInfoButton 回调中获取 |
signature | string | 在点击事件e中获取 | 在 UserInfoButton 回调中获取 |
示例(小游戏)
let button = wx.createUserInfoButton({
...
})
button.onTap(res = > {
XH_MINIPRO_SDK.updateUserInfo({
encryptedData: res.encryptedData,
iv: res.iv,
signature: res.signature
})
.then(res=>{
console.log(res)
})
})
示例(小程序)
<!-- wxml -->
<button open-type="getUserInfo" bindlogin="bindUserLogin">登录</button>
//js
bindUserLogin: function(e) {
if( e.detail.encryptedData ){
XH_MINIPRO_SDK.updateUserInfo({
encryptedData: e.detail.encryptedData,
iv: e.detail.iv,
signature: e.detail.signature
})
.then(res=>{
console.log(res)
})
}
}
返回值样例
{
"pid": "",
"app_id": "wxa73fd8e544880e89",
"open_id": "oc7L942AwAqIiBabNYb_cLl7mRsQ",
"union_id": "",
"nick_name": "",
"avatar_url": "",
"gender": 0,
"city": "广州",
"province": "广东省",
"country": "中国",
"language": "zh_CN",
"gold": 0,
"diamond": 0,
"share_new": 0,
"share_times": 0,
"online_days": 0,
"online_duration": 0,
"last_login_time": 1551690740,
"login_times": 1,
"from_scene": "1044",
"from_code": "ball-resurrection-1",
"is_new": false,
"ofp": "",
"jwt": "",
"login_province": "广东省",
"login_city": "广州市",
"login_district": "海珠区"
}
返回值详解
字段 | 字段类型 | 字段说明 |
---|---|---|
pid | string | 用户在星汉平台的统一索引,但可能变化 |
app_id | string | 应用的appid |
open_id | string | 用户在该应用下的openid |
union_id | string | 用户的unionid,默认为空字符串,绑定主体后大授权方可获得。绑定主体 |
nick_name | string | 用户的微信昵称,为空时需要调用 updateUserinfo 获取 |
nick_name | string | 用户的微信昵称,为空时需要调用 updateUserinfo 获取 |
avatar_url | string | 用户的微信头像,为空时需要调用 updateUserinfo 获取 |
gold | number | 用户在平台的金币数 |
diamond | number | 用户在平台的钻石数 |
is_new | bool | 是否新注册的用户 |
gender | number | 男:1 / 女:0 |
language | string | 用户微信中设置的语言 |
country | string | 用户微信中设置的国家 |
province | string | 用户微信中设置的省份 |
city | string | 用户微信中设置的城市 |
login_province | string | 根据用户ip判断用户所在的省份 |
login_city | string | 根据用户ip判断用户所在的城市 |
login_district | string | 根据用户ip判断用户所在的区县 |
share_new | number | 用户在当前游戏的分享引入新用户的数量 |
share_times | number | 用户在当前游戏的分享次数 |
online_days | number | 用户在当前游戏在线的天数 |
online_duration | number | 累计在线时长(单位:秒) |