1、适用场景

联合登录模式是为游戏开发者提供的多账号体系登录方案，可最大化缩短用户登录链路，在保障账号安全性的同时，兼顾运营灵活性，适配多场景业务需求。

2、开发准备

• 阅读技术接入前准备v1.1，并于“小米开放平台-管理中心”获取核心参数并配置关键功能。
• 集成小米 Game Service SDK，具体参考：集成Game Service SDK

3、业务流程

3.1 交互示例

3.2 交互流程

3.2.1 小米系统账号登录场景

注意 ！！！

1. 手机号不可作为账号唯一标识使用

• 存在部分场景下不会返回手机号。例如用户未授权、用户小米账号未绑定手机号、用户手机号变更，若游戏必须需要手机号进行注册，开发者需提供手机号收集页面，自行获取用户手机号。
• 小米账号对应手机号发生变更时，小米侧返回的uid不会发生变化

2. 小米实名服务不可作为唯一实名渠道 ！！！

• 因存在用户未授权、授权失败等场景，开发者需在游戏内保留自主实名能力。

3. 游戏每次冷启动时，都需要调用unionLogin接口，unionLogin中包含合规流程，不可跳过。

3.2.2 游戏官方账号登录场景

4、接口说明

4.1 客户端接口

• 核心接口

注意

• 可选接口

4.2 服务端接口

服务端接口（登录） .v1.1

5、开发流程

5.1 接口调用流程图

5.2 开发步骤

5.2.1 设备判断

调用SDK的所有接口之前应先调用com.xiaomi.ecosys.base.utils.RomUtils.isDeviceSupport（），判断当前设备是否为国内版小米设备，如果是国内版小米设备，则继续调用后续初始化、登录接口，否则非小米设备则走游戏自身的登录流程。

/**
* true:国内版小米设备
*/
RomUtils.isDeviceSupport()；

5.2.2 同意隐私协议

根据个保法要求，在用户同意隐私协议前不允许获取用户信息及上报任何手机设备上的信息，请在用户同意隐私后调用以下接口，否则无法正常调用其他接口，调用时会抛出异常。该接口会保存用户同意隐私协议的状态，无需多次调用。

    /**
     * 同意隐私协议后调用该接口
     */
    MiBasicApi.getInstance().onUserAgreed(Context context);

注意！！！

1. SDK本身不会弹出任何隐私协议，隐私协议由游戏开发者自行设计实现，但需要在游戏隐私协议中附加Game Service SDK的隐私协议：https://privacy.mi.com/ecosys-sdk/zh_CN/
2. 请在提审前，保证游戏在用户同意隐私协议前不会获取任何手机信息和发送网络请求，否则在审核时会被驳回。建议在 小米隐私合规检测平台 测试通过后再提交审核。

5.2.3 初始化

调用init接口初始化Game Service SDK

MiGameService.getInstance().init(this, new InitCallback() {
    @Override
    public void onInitSuccess() {
        Toast.makeText(MainActivity.this, "初始化成功", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(int errCode, String errMsg) {
        Toast.makeText(MainActivity.this, "初始化失败 errCode："+errCode+"| errMsg:"+errMsg, Toast.LENGTH_SHORT).show();
    }
});

5.2.4 发起登录

调用unionLogin接口发起联合登录，接口包含了实名和防沉迷的校验流程。

UnionLoginV2Param loginParam = UnionLoginV2Param.builder()
    .changeAccount(false) //是否切换账号  默认为false
    .build();
MiGameService.getInstance().unionLogin(MainActivity.this, loginParam, new UnionLoginV2Callback() {

    @Override
    public void onLoginSuccess(UnionLoginV2Result result) {
        if (result != null) {
            //登录方式
            String accountType = loginResult.getAccountType();
            //用户ID
            String uid = loginResult.getUid();
            //登录token
            String serviceToken = loginResult.getServiceToken();
            //登录完成后由服务端完成账号信息校验和用户信息获取
        }
        
    }

    @Override
    public void onLoginCancel() {
        Toast.makeText(MainActivity.this, "登录取消", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(int errCode, String errMsg) {
        Toast.makeText(MainActivity.this, "登录失败 errCode："+errCode+"| errMsg:"+errMsg, Toast.LENGTH_SHORT).show();
    }
});

5.2.5 游戏场景上报

游戏客户端上报指定场景到小米侧，小米侧将会基于游戏侧事件进行用户运营和系统侧优化
其中登录完成场景（SCENE_LOGIN_FINISH）推荐上报

//上报游戏侧完成登录
MiGameService.getInstance().reportGameScene(GameScene.SCENE_LOGIN_FINISH);

//   推荐上报场景
//场景ID 登录完成
public static final int SCENE_LOGIN_FINISH = 1;


//   可选上报场景
//场景ID 进入游戏商品页面
public static final int SCENE_VIEW_PRODUCT_LIST = 2;
//场景ID 资源加载开始
public static final int SCENE_RESOURCE_LOAD_BEGIN = 3;
//场景ID 资源加载完成
public static final int SCENE_RESOURCE_LOAD_END = 4; 
//场景ID 进入重负载场景
public static final int SCENE_HEAVY_LOAD = 5;
//场景ID 进入中负载场景
public static final int SCENE_MID_LOAD = 6;
//场景ID 进入轻负载场景
public static final int SCENE_LITE_LOAD = 7; 
//场景ID 退出游戏
public static final int SCENE_EXIT_GAME = 8;

5.2.6 切换账号（可选）

游戏内可为已登录的用户提供切换账号的入口，用户点击后，调用unionLogin接口并将参数changeAccount指定为true

UnionLoginV2Param loginParam = UnionLoginV2Param.builder()
    .changeAccount(true) //是否切换账号  默认为false
    .build();
MiGameService.getInstance().unionLogin(MainActivity.this, loginParam, new UnionLoginV2Callback() {

    @Override
    public void onLoginSuccess(UnionLoginV2Result result) {
        if (result != null) {
            //登录方式
            String accountType = loginResult.getAccountType();
            //用户ID
            String uid = loginResult.getUid();
            //登录token
            String serviceToken = loginResult.getServiceToken();
            //登录完成后由服务端完成账号信息校验和用户信息获取
        }
    }

    @Override
    public void onLoginCancel() {
        Toast.makeText(MainActivity.this, "登录取消", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(int errCode, String errMsg) {
        Toast.makeText(MainActivity.this, "登录失败 errCode："+errCode+"| errMsg:"+errMsg, Toast.LENGTH_SHORT).show();
    }
});

5.2.7 实名信息授权（可选）

游戏侧完成账号查询/注册后，若判断该用户未实名，可调用authRealNameInfo接口发起实名授权，授权通过后可通过服务端接口获取到用户的实名信息。如果实名授权失败，游戏客户端需自行定义兜底处理逻辑。
注：调用该接口前需确保游戏已在小米开放平台完成实名数据传输服务鉴权申请
注：当用户取消授权或授权失败时，游戏需自行引导用户输入实名二要素信息

AuthRealNameParam authRealNameParam = AuthRealNameParam.builder()
        .gameId(gameAccountId) //游戏侧唯一标识
        .build();
MiGameService.getInstance().authRealNameInfo(this, authRealNameParam, new AuthRealNameCallback() {

    @Override
    public void onAuthSuccess(AuthRealNameResult result) {
        if (result != null && result.isValid()){
            //结果码  1 成功 2 取消
            int errCode = result.getErrCode();
            //错误信息
            String errMsg = result.getErrMsg();
            //授权码
            String authCode = result.getAuthCode();
            //授权码过期时间
            String expireTime = result.getExpireTime();
            
            if (errCode == 1) {
                // 请求服务端获取实名二要素信息
                
            } else {
                // 展示游戏内收集用户实名信息页面
                
            }
        } else {
            // 展示游戏内收集用户实名信息页面
            
        }
    }

    @Override
    public void onAuthCancel() {
        Toast.makeText(UnionLoginV2Activity.this, "实名授权取消", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(int errCode, String errMsg) {
        Toast.makeText(UnionLoginV2Activity.this, "实名授权失败 errCode："+errCode+"| errMsg:"+errMsg, Toast.LENGTH_SHORT).show();
    }
});

5.2.8 角色信息上报（可选）

游戏侧完成角色创建后上报角色信息至小米侧

//角色信息
MiRoleInfo miRoleInfo = new MiRoleInfo();
miRoleInfo.setRoleId("角色id"); //必传字段
miRoleInfo.setRoleName("角色名称"); //必传字段
miRoleInfo.setRoleLevel("角色等级"); //非必传字段
miRoleInfo.setRealmId("区服ID");  //非必传字段
miRoleInfo.setRealmName("区服名称");  //非必传字段
miRoleInfo.setCpOpenId("CP账号ID");  //非必传字段

//游戏侧渠道ID
String cpChannel = "channel_xxx";

MiGameService.getInstance().reportGameRole(this, miRoleInfo, cpChannel, new ReportGameRoleCallback() {
    @Override
    public void onError(int errCode, String errMsg) {
        Toast.makeText(AfterLoginActivity.this, "上报失败 errCode:"+errCode+"| errMsg:"+errMsg, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onReportSuccess() {
        Toast.makeText(AfterLoginActivity.this, "上报成功", Toast.LENGTH_SHORT).show();
    }
});

5.2.9 监听未成年防沉迷状态（可选）

Game Service SDK会对未成年用户的游戏时间进行监控，如游戏侧需要监听用户剩余可玩时长，可通过调用registerAntiListener接口获取用户剩余可玩时长，游戏侧可根据剩余可玩时长给予用户提示或限制部分用户行为

MiGameService.getInstance().registerAntiListener(new GameAntiStatusCallback() {
    @Override
    public void onUserAntiChange(int isNeedLimit, long dayLeftMills) {
        Toast.makeText(LoginActivity.this, "防沉迷状态更新 用户实名状态："+isNeedLimit+"| 剩余可玩时间："+dayLeftMills, Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onError(int errCode, String errMsg) {
        Toast.makeText(LoginActivity.this, "注册监听失败 errCode："+errCode+"| errMsg:"+errMsg, Toast.LENGTH_SHORT).show();
    }
});

5.3 SDK错误码