登录

业务场景

用户账号登录（包含注册）接口
用户登录完成后由 SDK 通过回调的方式把对应的登录结果返回给 CP。

注意事项

服务端登录验签的实现,请查看登录验签

流程图

接口介绍

login(info: EworldSDK.BaseCallback<EworldSDK.UserData> & { onCanceled?: () => void }): void

调用示例

SDKManager.login({
  onSuccess: (userData) => {
    // 登录成功后，获取用户信息
    if (!userData.userInfo) {
      // 当userInfo存在时获取对应的信息，否则为null
    }
  },
  onFailed: (err) => {
    // 登录失败
  },
  onCanceled: () => {
    // 登录取消
  },
});

参数说明

出参

UserData userData

参数名称	类型	说明	最低版本
openId	string	SDK 用户唯一标识（最长 50 个字符）
token	string	服务端登录验签的 Token
timestamp	long	登录时间戳，单位：毫秒
sign	string	服务端登录验签的签名信息，请查看登录验签
areaId	string	游戏大区 Id
isAuth	bool	用户是否实名的标识
birthday	string	用户的生日，格式：yyyyMMdd
gender	int	性别：0（未知）、1（女性）、2（男性）
regCountryCode	string	注册时的国家码
loginCountryCode	string	登录时的国家码
userInfo	UserInfo	用户信息, 见userInfo （仅小游戏平台返回，其他端返回空）

UserInfo userInfo：使用前要做判空处理

参数名称	类型	说明	最低版本
channelUid	string	渠道的 openid，一定会有
avatarUrl	string	用户头像，没有数据则为空
avatarUrlBig	string	用户头像-高清大图，没有数据则为空
nickName	string	用户昵称，没有数据则为空
isAuthoriza	bool	用户是否做了登录授权的标识
playerLevel	bool	渠道用户等级，获取不到渠道数据的时候为 0
shareId	string	分享者分享的 id
sharePosition	string	分享图位置
shareServerId	string	分享者所在的区服 ID
shareRoleId	string	分享者的角色 ID
userType	int	用户类型，1：新用户，0：老用户
visitBackStatus	int	抖音复访任务状态 1=完成 0=未完成字段名称有改变
phoneNum	string	用户手机号码，没有数据则为空
bandPhoneFlag	bool	是否绑定过手机
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

无

初始化接口

支付接口

文档目录

业务场景流程图接口介绍调用示例参数说明错误码 FAQ