.login

一、概述

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

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

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

二、调用方法

tt.tmSDK.login({force: false}).then(res=>{ 
    console.log(res)
})
//force为布尔型，表示是否默认拉起登录框，非必填，天幕默认为false即不拉起登录框

三、返回值样例

{
    "pid": "",
    "app_id": "tta73fd8e544880e89",
    "open_id": "qPKIsWizTRH91gwh",
    "union_id": "7L942AwAqIiBababh",
    "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": "011001",
    "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	用户在该应用下的anonymous_openid，天幕使用anonymous_openid作为数据统计依据与用户标识
union_id	string	用户的openid，默认为空字符串，在用户登录以后方可获取。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录账号的用户openid
nick_name	string	用户的昵称，为空时需要调用 updateUserinfo 获取。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录且授权账号的用户的昵称
avatar_url	string	用户的头像，为空时需要调用 updateUserinfo 获取。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录且授权账号的用户的头像
gender	number	男：1 / 女：0
language	string	用户设置的语言。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录且授权账号的用户语言。
city	string	用户设置的城市。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录且授权账号的用户城市。
province	string	用户设置的省份。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录且授权账号的用户省份。
country	string	用户设置的国家。若同一个设备（即同一个anonymous_openid）上登录过多个账号，则展示最近一个登录且授权账号的用户国家。
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判断用户所在的区县

​