.login

概述

login接口用于获取已经存放在天幕平台的用户信息，包含OpenID、头像、昵称、地区等，用做后续业务逻辑判断的依据。（其中头像昵称需要用户授权，详见授权登录）

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

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

多端游戏的账号互通：

字段说明：

open_id 单个游戏中用户的唯一标识

xh_uid 多端账号互通

互通策略：

需要游戏CP的玩家信息中同时关联open_id和xh_uid，如果.login()返回了xh_uid且不为空，则游戏CP需优先关联xh_uid，与之关联玩家进行登录。

调用方法

wx.tmSDK.login().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": "海珠区",
    "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服务端校验登录有效性