.updateUserInfo

使用updateUserInfo接口从微信获取用户信息（昵称、头像等），并上传到天幕平台。

调用此接口后，下次调用 login 时，即可从天幕sdk获取上一次 updateUserInfo 中返回的用户信息。 关于用户信息的更新策略，开发者可参考 用户信息授权 中的 何时触发大授权 。

调用方法

wx.tmSDK.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 = > {
    tm_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 ){
       wx.tmSDK.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 获取
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	累计在线时长（单位：秒）