登录/获取用户信息（.login）

一、概述

login接口用于获取已经存放在天幕平台的用户信息，包含uid、头像、昵称、地区等，用做后续业务逻辑判断的依据。

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

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

二、调用方法

qg.tmSDK.login().then(res=>{    console.log(res)})

传入参数说明

字段	字段类型	说明	厂商兼容性（oppo、vivo、小米、华为）
refresh	boolean	非必填默认为：false。强制刷新登录，请求接口，（注意：默认初始化已启用hasInitLogin，在此之后调用该接口，启用下面的参数功能的同时需要把此参数设置为true）	全部
forceLogin	number	非必填默认为：1。华为登录参数：玩家未登录华为帐号或鉴权失败时，是否拉起登录场景。0：表示如果玩家未登录华为帐号或鉴权失败，不会主动拉起帐号登录场景，适用于单机游戏的登录场景。1：表示如果玩家未登录华为帐号或鉴权失败，会主动拉起帐号登录场景，适用于网游的登录场景和单机游戏支付前强制登录场景。	华为
withReal	boolean	非必填默认为：false。华为登录接入防沉迷的能力 默认不接入	华为
isAuthorize	boolean	非必填默认为：false。小米登录拉起授权	小米

示例：

// 小米登录拉起授权
qg.tmSDK.login({ refresh:true, isAuthorize: true }).then(res=>{ console.log(res) })

三、返回值样例

{
    "app_id": "e544880e89",
    "open_id": "oc7L942AwAqIiBabNYb_chhhhhhh",
    "nick_name": "",
    "avatar_url": "",
    "gender": 0,
    "city": "广州",
    "province": "广东省",
    "country": "中国",
    "language": "zh_CN",
    "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": "海珠区"
}

四、返回值说明

字段	字段类型	字段说明
app_id	string	应用的appid
open_id	string	用户在该应用下的OPPO中的用户uid，天幕存储后格式为appid_uid。 因OPPO平台中一个用户在所有小游戏中均只有一个uid，天幕在uid前增加appid用于区分。
nick_name	string	用户的OPPO昵称
avatar_url	string	用户的OPPO头像
gender	number	男：1 / 女：0
language	string	用户OPPO中设置的语言
city	string	用户OPPO中设置的城市
province	string	用户OPPO中设置的省份
country	string	用户OPPO中设置的国家
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判断用户所在的区县