登录相关

WARNING

在游戏登录界面，调用登录接口时， 建议游戏先判断当前是否有初始化完成。 如果未初始化完成，可以再次调用初始化接口。

登录

当玩家进入游戏登录界面、 或玩家手动点击【进入游戏】按钮并且此时玩家是未登录状态时， 游戏层可以调用登录接口。 请在UI主线程中调用该接口。

XPlatform.getInstance().login(activity, new ILoginListener() {
    @Override
    public void onLoginSuccess(UUser user) {
        //登录成功事件
    }

    @Override
    public void onLoginFailed(int code, String msg) {
        // 登录失败回调
    }
});

处理登录通知事件

当SDK登录成功或失败时， SDK会通过登录接口中传入的回调类中的事件接口，通知给游戏层：

new ILoginListener() {
    @Override
    public void onLoginSuccess(UUser user) {
        Log.d("UGSDKDemo", "sdk login success."+user.getUid());
        // TODO: 游戏层将uid, token等发给游戏服务器， 游戏服务器再去SDK服务器端做登陆验证。 具体见服务端文档中登陆认证部分。
    }

    @Override
    public void onLoginFailed(int code, String msg) {
        Toast.makeText(MainActivity.this, "登录失败:"+msg, Toast.LENGTH_LONG).show();
    }
}

当onLoginSuccess触发时， 会返回UUser对象， 其中包含了当前玩家的账号ID等信息。 UUser结构参考如下：

参数名称	参数类型	参数说明
uid	String	用户唯一ID
name	String	用户名， 普通用户名/手机号/设备号/第三方平台用户唯一ID（微信登录后这里对应的是unionId）
loginName	String	登录用户名
wxOpenID	String	微信账号的open id, 只有当accountType为4的时候，才可能会有
accountType	String	1：普通用户登录；2：手机号；3：设备号静默登录；4：微信；5：苹果；6：TapTap；7：抖音
newAccount	String	1:新注册用户；0：活跃用户
token	String	传给游戏服务器，去SDK服务端验证

登出

如果游戏中，有【登出】功能， 可以在玩家点击【登出】按钮时，调用下面的logout接口。

注意： 游戏层主动调用logout()接口时，是不会触发onLogout回调的。 游戏层调用logout接口后，可以直接处理之后的逻辑，比如返回到游戏登录界面，无需等待SDK回调。

XPlatform.getInstance().logout(activity);

切换账号（可选）

如果游戏的登录界面上面，有【切换账号】功能， 可以在玩家点击【切换账号】按钮时，调用下面接口。

XPlatform.getInstance().logout(activity);
XPlatform.getInstance().login(activity, new ILoginListener());

打开用户中心（可选）

正常SDK登录成功后，会自动展示一个悬浮球， 点击悬浮球会弹出用户中心界面。 但如果SDK后台关闭了悬浮球，那SDK登录后将不会展示悬浮球。 开发者可以在游戏中增加【用户中心】按钮，点击调用如下接口，打开用户中心界面：

XPlatform.getInstance().showUserCenter(activity);

服务端登录验证

游戏层拿到UUser对象后，不能直接让玩家进入游戏， 需要将UUser对象中的uid、 token等数据， 传给游戏服务器。

游戏服务器通过调用服务端API集成->登录认证协议，验证token的合法性。

验证通过后， 才能让玩家进入游戏。