客户端接入指南

repositories {
  maven {
    // 4399 SDK 开放仓库：正式
    url 'https://mvn.4399doc.com/repository/maven-releases'
  }
  maven {
    // 4399 SDK 开放仓库：快照
    url 'https://mvn.4399doc.com/repository/maven-snapshots'
  }
}

dependencies {
  implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])

  // 运营 SDK：建议使用最新正式版本（release仓库中的版本），可通过浏览仓库地址或向运营咨询版本
  implementation "cn.m4399.sdk:operate:3.16.0"

  // volley 和 support 是 SDK 使用的外部依赖，若接入方已有，可忽略
  implementation 'com.android.volley:volley:1.2.1'
  //noinspection GradleCompatible
  implementation "com.android.support:support-v4:28.0.0"
}

dependencies {
  implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
}

private void initSDK() {
    mOpeCenter = OperateCenter.getInstance();
    OperateConfig config = new OperateConfig.Builder(MainActivity.this)
            // 设置调试模式，可选，默认false, 发布前应设置为false或删除调用
            .setDebugEnabled(false)
            // 设置游戏运营 key，必须
            .setGameKey(GAME_KEY)
            // 设置 SDK 页面方向，必须，应与游戏方向一致，可取值见下文说明
            .setOrientation(GAME_ORIENTATION)
            // 设置悬浮窗风格，可选，悬浮窗更多信息参考下文
            .setPopLogoStyle(PopLogoStyle.POPLOGOSTYLE_ONE)
            // 设置悬浮窗初始位置，可选，有四种，分别在屏幕上下左右
            .setPopWinPosition(PopWinPosition.POS_LEFT)
            // 设置游戏充值是否支持超出金额，可选，true支持，默认false
            .setSupportExcess(GAME_SUPPORT_EXCESS)
            // 设置是否在 Android 9.+系统上兼容全面屏，true兼容，默认false
            .compatNotch(GAME_COMPACT_NOTCH)
            .build();
    mOpeCenter.setConfig(config);

    // 注意：初始化完成后，其他接口才可用
    mOpeCenter.init(MainActivity.this, new OperateCenter.OnInitGlobalListener() {
        /*
         * 初始化回调
         * 只有在init之后， isLogin()返回的状态才可靠
         */
        @Override
        public void onInitFinished(boolean isLogin, User userInfo) {
            // 初始化后处理
        }

        /*
         * 登出账号的回调
         * @param fromUserCenter 标识区分是否从个人中心中登出的，若是则为true，不是为false
         */
        @Override
        public void onUserAccountLogout(boolean fromUserCenter) {
            // 用户登出，游戏应回到自身登录页面
        }

        /*
         * 切换账号回调
         */
        @Override
        public void onSwitchUserAccountFinished(boolean fromUserCenter, User userInfo) {
            // 用户切换，游戏应回到选服页面
        }
    });
}

<!-- 游戏 Activity：
     若覆盖了 android:resizeableActivity="false"，则必须如下设置 android:configChanges
     android:configChanges="orientation|screenSize|keyboardHidden|screenLayout|navigation|smallestScreenSize|fontScale"
     
     不应该使用 android:launchMode="singleTask" 启动模式，可以考虑 singleTop
 -->

<activity
        android:name=".MainActivity"
        android:configChanges="orientation|screenSize|keyboardHidden|screenLayout|navigation|smallestScreenSize|fontScale"
/>

<!-- 
    4399 SDK：SDK 中除了以'cn.m4399.'开头的 Activity 都是第三方页面，
        假设游戏为横屏，需要锁定它们的方向为横屏，可以设置 android:screenOrientation，
        此设置应与初始化接口中设置的值保持对应，且若编译有错误，可以进一步设置‘tools:replace’
 -->
<activity android:name="com.cmic.gen.sdk.view.GenLoginAuthActivity"
          android:configChanges="orientation|keyboardHidden|screenSize"
          android:launchMode="singleTop"
          android:screenOrientation="landscape"
          android:theme="@style/AppTheme.NoActionBar"
          tools:replace="android:theme, android:screenOrientation" />

if(mOpeCenter.isLogin()) {
    User user = mOpeCenter.getCurrentAccount();
} else {
    mOpeCenter.login(MainActivity.this,new OnLoginFinishedListener() {
        @Override
        public void onLoginFinished(boolean success,int resultCode,User user) {
            // 登录结束后的游戏逻辑
        }
    });
}

boolean isLogin = mOpeCenter.isLogin();

User user = mOpeCenter.getCurrentAccount();

mOpeCenter.setServer(SERVER_ID);

 mOpeCenter.switchAccount(MainActivity.this,new OnLoginFinishedListener() {
     @Override
     public void onLoginFinished(boolean success,int resultCode,User userInfo){
         // 用户账号切换结束后的游戏逻辑
     }
 });

mOpeCenter.logout();

/*
 * 充值，直接传递参数，旧版接口
 *
 * money, 充值金额，整型，单位元，1 ～ 50000，必须
 * mark, 游戏方订单，必须，
 *      支持大小写字母、数字、'|'(竖线)、'-'（中划线）、'_'（下划线），最长32位，不可为空，不可重复
 * commodity, 商品名，可选，不传时认为商品名是游戏币
 */
mOpeCenter.recharge(MainActivity.this, money, mark, commodity, new OnRechargeFinishedListener() {
    /* 充值操作结果 */
    @Override
    public void onRechargeFinished(boolean success, int resultCode, String msg) {
        if (success) {
            // 充值操作成功，根据服务端回调决定是否道具
            // 注意：操作成功包含了订单成功、订单处理中两种情况
        } else {
            // 充值失败逻辑，resultCode查看文档结尾
        }
    }
});

/*
 * 充值，使用订单类，新版接口
 *
 * 与直接传递参数几乎一样，只是可以对单笔订单设置是否支持超出金额
 */
mOpeCenter.recharge(MainActivity.this,
        // 充值金额，整数，单位元
        new Order(money, mark)
                // 是否支持超出金额，默认不支持
                .supportExcess(false)
                // 商品名，可选，不传时认为商品名是游戏币
                .commodity(COMMODITY_NAME),
        new OperateCenter.OnRechargeFinishedListener() {
            @Override
            public void onRechargeFinished(boolean success, int resultCode, String msg) {

            }
        });

/*
 * 绑定手机
 */
mOpeCenter.bindPhone(this,new OpeResultListener() {
    /*
     * resultCode：0、绑定成功；1、取消绑定；2、已绑定；3、网络异常或服务器异常；
     * message：状态说明
     */
    @Override
    public void onResult(int code,@Nullable String message){
    }
});

/*
 * 检查用户绑定手机的状态
 */
mOpeCenter.checkBindPhoneState(new OpeResultListener() {
    /*
     * resultCode: 0、未绑定手机号；2、已绑定手机号；3、网络异常或服务器异常；6 、账号被踢
     * message：状态说明
     */
    @Override
    public void onResult(int code,@Nullable String message){
    }
});

mOpeCenter.shouldQuitGame(MainActivity.this,new OnQuitGameListener() {
    @Override
    public void onQuitGame(boolean shouldQuit){
        // 点击退出对话框上的“退出游戏”时，shouldQuit为true，游戏处理退出业务逻辑
    }
});

mOpeCenter.authenticate(requireActivity(),new OpeResultListener() {
    @Override
    public void onResult(int code,@Nullable String message){
        // code 提示不同类型的错误，message 提示具体信息
    }
});

mOpeCenter.getVersion();

mOpeCenter.upgradeInGameBox(activity, new OpeResultListener() {
    /*
     * code：0、成功；
     *       1、取消更新，如取消安装游戏盒；
             2、更新进行中；
             3、更新失败，主要是 SDK 内部请求失败；
             5、后台开关未开启；
             6、SDK未初始化
     * message：code 说明文案
     */
    @Override
    public void onResult(int code, @Nullable String message) {
        // 处理跳转结果
    }
});

// 游戏 apk 工程的 build.gradle中
signingConfigs {
  release {
    v2SigningEnabled false
  }
}  

<meta-data android:name="FTNN_CHANNEL_ID" android:value="baidu" />

public final class User {
  /** uid */
  public String getUid();

  /** 用户名 */
  public String getName();

  /** 昵称 */
  public String getNick();

  /** 登录状态 */
  public String getState();

  /** 绑定的手机号，已脱敏，若已绑定则此字段非空 */
  public String getPhone();
}