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

一、概述

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

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

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

二、调用方法

hbs.tmSDK.login({forceLogin:0}).then(res=>{    console.log(res)}

参数： forceLogin (天幕SDK默认值为0，在天幕SDK中非必填)

参数说明： 玩家未登录华为帐号或鉴权失败时，是否拉起登录页面。

• 0：表示如果玩家未登录华为帐号或鉴权失败，不会主动拉起帐号登录页面，适用于单机游戏的登录场景。

• 1：表示如果玩家未登录华为帐号或鉴权失败，会主动拉起帐号登录页面，适用于网游的登录场景和单机游戏支付前强制登录场景。

三、返回值样例

{
    "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	用户在该应用下的华为中的用户playerID
nick_name	string	用户的华为昵称
avatar_url	string	用户的华为头像
gender	number	男：1 / 女：0
language	string	用户华为中设置的语言
city	string	用户华为中设置的城市
province	string	用户华为中设置的省份
country	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判断用户所在的区县