.updateUserProfile

此接口调用了微信官方wx.getUserInfo获取用户。由于官方登录、获取用户信息将使用新接口,在2021年4月13日后发布的小游戏(小程序)若依然使用wx.getUserInfo将无法获取用户信息。建议下载2021年3月7日发布的新版天幕微信天幕SDK,并调用本接口获取更新用户信息。关于微信小程序登录、用户信息相关接口调整说明:https://developers.weixin.qq.com/community/develop/doc/000cacfa20ce88df04cb468bc52801?blockType=1

​概述

用于从微信获取用户的昵称头像信息。

  1. 接入此接口时,注意兼容性问题

  2. 若使用了无登录版天幕SDK,无法使用该接口获取用户信息。

  3. 使用该接口,需要下载新版天幕微信SDK(3月7日发布的新版)。

调用方法

wx.tmSDK.updateUserProfile({
refresh: false ,
desc: "更新用户信息" // 默认为更新用户信息,官方要求必填项,声明获取用户个人信息后的用途,后续会展示在弹窗中,请谨慎填写
}).then(res => {});
// refresh 可选 默认为false:不强制拉起授权弹窗,根据缓存时间判断是否拉起授权弹窗。
// true:无论是否有缓存,都会直接拉起授权弹窗

参数说明

字段是否必填字段类型小程序小游戏

fresh

boolean

不兼容

可调用

desc

string

可调用

可调用

返回值样例

{
    "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": "海珠区",
    "lst":"xh_a4ff9b7fa6de6e89a993fb53ce6c5333",
    "xh_uid": "oZ4B96SuSjhET6CS7v3jTcY_be6Q"
}

返回值说明

字段

字段类型

字段说明

pid

string

用户在天幕的统一索引,但可能变化,已废弃

app_id

string

应用的appid

open_id

string

用户在该应用下的openid

xh_uid

string

星汉互通账号id,供多端用户实现账号互通

union_id

string

用户的unionid,默认为空字符串。union_id获取方法

nick_name

string

用户的微信昵称,为空时需要调用 updateUserinfo 获取

avatar_url

string

用户的微信头像,为空时需要调用 updateUserinfo 获取

gender

number

男:1 / 女:0

language

string

用户微信中设置的语言

city

string

用户微信中设置的城市

province

string

用户微信中设置的省份

country

string

用户微信中设置的国家

gold、diamond

string

游戏内金币、钻石,已废弃

share_new

number

用户在当前游戏的分享引入新用户的数量

share_times

number

用户在当前游戏的分享次数

online_days

number

用户在当前游戏在线的天数

online_duration

number

累计在线时长(单位:秒)

last_login_time

number

最近一次访问的时间戳

login_times

number

用户在当前游戏的累计登录访问次数

from_scene

string

来源场景值

from_code

string

来源渠道ID

is_new

bool

是否新注册的用户

login_province

string

根据用户ip判断用户所在的省份(注意:返回的省份名称与行政划分的名称一致,如西藏,返回的是西藏自治区。若要实现地区屏蔽功能,建议根据返回值前两位进行地区匹配)

login_city

string

根据用户ip判断用户所在的城市

login_district

string

根据用户ip判断用户所在的区县

lst

string

登录凭证,供CP服务端校验登录有效性

最后更新于