登录
业务场景
用户账号登录（包含注册）接口
用户登录完成后由 SDK 通过回调的方式把对应的登录结果返回给 CP。
注意事项
- 服务端登录验签的实现,请查看登录验签
流程图
接口介绍
SDKManager.login(Object params)
调用示例
var params = {
onSuccess: (userData) => {
//登录成功
},
onFailed: (errorInfo) => {
//登录失败
// 游戏需要停留在登录页面，让玩家点击登录按钮再次拉起登录操作
},
};
SDKManager.login(params);
参数说明
出参
UserData userData
| 参数名称 | 类型 | 说明 | 最低版本 |
|---|---|---|---|
| openId | String | SDK 用户唯一标识 （最长 50 个字符） | |
| token | String | 服务端登录验签的 Token | |
| timestamp | long | 登录时间戳，单位：毫秒 | |
| sign | String | 服务端登录验签的签名信息，请查看登录验签 | |
| areaId | String | 游戏大区 Id | |
| isAuth | Boolean | 用户是否实名的标识 | |
| birthday | String | 用户的生日，格式：yyyyMMdd | |
| gender | Number | 性别：0（未知）、1（女性）、2（男性） | |
| userInfo | UserInfo | 用户信息, 见userInfo （仅小游戏平台返回，其他端返回空） |
UserInfo userInfo：使用前要做判空处理
| 参数名称 | 类型 | 说明 | 最低版本 |
|---|---|---|---|
| channelUid | String | 渠道的 openid，一定会有 | |
| avatarUrl | String | 用户头像 ，没有数据则为空 | |
| avatarUrlBig | String | 用户头像-高清大图，没有数据则为空 | |
| nickName | String | 用户昵称，没有数据则为空 | |
| isAuthoriza | Boolean | 用户是否做了登录授权的标识 | |
| playerLevel | Boolean | 渠道用户等级，获取不到渠道数据的时候为 0 | |
| shareId | String | 分享者分享的 id | |
| sharePosition | String | 分享图位置 | |
| shareServerId | String | 分享者所在的区服 ID | |
| shareRoleId | String | 分享者的角色 ID | |
| userType | Number | 用户类型，1：新用户，0：老用户 | |
| visitBackStatus | Number | 抖音复访任务状态 1=完成 0=未完成字段名称有改变 | |
| phoneNum | String | 用户手机号码，没有数据则为空 | |
| bandPhoneFlag | Boolean | 是否绑定过手机 | |
| location | String | 地址，没有数据则为空 |
String areaId：大区 ID 说明
areaId 的返回值形式包括: areaId="1_1", areaId="1_1,2_1", areaId="1_1,2_1$1":
| 格式 | 格式说明 |
|---|---|
| 2_1 | 用户只可以看到 2 区 1 服及其以后的服务器列表并可以进入。 |
| 3_7 | 用户只可以看到 3 区的 7 服 及其以后的服务器列表并可以进入。3 区 1~6 服看不到。 |
| 1_4,3_6 | 用户在游戏登录服务器选择界面可以看到 1 区 4 服及其以后的服列表（包含 4 服本身），和 3 区的 6 服及其以后的服务器列表，且都可以进入。 其中 1 区 1-3 服不显示，3 区 1-5 服不显示。 |
| 2_1,3_1$2 | 2 区和 3 区进行合并，该用户显示 2 区区名，并能看到 2 区和 3 区的所有服务器列表。 |
| 2_1,3_7$3 | 2 区和 3 区进行合并，该用户显示 3 区区名，并能看到 2 区 1 服及其以后的服，和 3 区 7 服及其以后的所有服务器列表。但看不到 3 区 1-6 服。 |
注意：areaId = 0 或 areaId=0_0 都是错误找不到区服。具体的 areaId 对应的游戏服务器列表由运营提供。
| 区服对应关系 | 内部了解区名编号 |
|---|---|
| 益玩安卓专区 | 一区 |
| IOS 专区 | 二区 |
| 益玩安卓用户及 IOS 用户都可见此区服务器列表 | 三区 |
| 应用宝专区 | 四区 |
| 安卓其他渠道专区 | 五区 |
错误码
无
FAQ
无