客户端接入指南

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：建议使用最新版本，可通过浏览仓库地址或向运营咨询版本
    implementation "cn.m4399.sdk:operate:3.6.0"
    
    // volley 和 support 是 SDK 使用的外部依赖，若接入方已有，可忽略
    implementation 'com.android.volley:volley:1.2.0'
    //noinspection GradleCompatible
    implementation "com.android.support:support-v4:28.0.0"
}

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

// 初始化选项，传入游戏配置，更多说明见接入文档
OperateConfig opeConfig = new OperateConfig.Builder(this)
        // 设置游戏运营 key，此参数需要在原创开放平台注册应用后得到
        .setGameKey(GAME_KEY)
        // 设置SDK页面方向，应与游戏方向一致，部分第三方页面需要在AndroidManifest中设置
        .setOrientation(GAME_ORIENTATION)
        // 设置游戏充值是否支持超出金额，可选，true支持，默认false
        .setSupportExcess(GAME_SUPPORT_EXCESS)
        // 设置游戏是否兼在高于Android 9.0版本系统容全面屏，true兼容，默认false
        .compatNotch(GAME_COMPACT_NOTCH)
        .build();

// 初始化SDK
SingleGame.init(this, opeConfig, new OpeInitedListener() {
    @Override
    public void onInitFinished() {
        // 完成防沉迷等初始化流程，可进入游戏
    }
});

  <!-- 游戏 Activity 配置建议：
       应该使用 android:configChanges="orientation|screenSize|keyboardHidden"
       不应该使用 android:launchMode="singleTask" 启动模式，可以考虑 singleTop
  -->

<!-- 
    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" />

// 单机游戏充值时，允许使用客户端回调，如需使用请联系运营确认
// 注意 !!!!!：客户端回调不安全，APK 容易被篡改
// 设置发放物品回调，需要客户端回调才使用
SingleGame.setDeliveringGoodsListener(new SingleGame.OnDeliveringGoodsListener() {
    @Override
    public boolean onDelivering(OrderFinished of) {
        Log.i(TAG, of.money() + " " + of.conclude().first + " " + of.conclude().second);
        // 如果游戏因为某些原因发放失败，应返回false
        return true;
    }
});

/*
 * 充值
 *
 * money, 充值金额，整型，单位元，1 ～ 50000，必须
 * mark, 游戏方订单，必须，
 *      支持大小写字母、数字、'|'(竖线)、'-'（中划线）、'_'（下划线），最长32位，不可为空，不可重复
 * commodity, 商品名，可选，不传时认为商品名是游戏币
 */
String mark = GameSettings.createUniqueMark();
SingleGame.recharge(this,
        // 充值金额，整数，单位元
        // mark: 游戏订单，游戏可以再其中映射用户名、商品信息
        new Order(money, mark)
                // 是否支持超出金额，默认不支持
                .supportExcess(false)
                // 商品名，可选，不传时认为商品名是游戏币
                .commodity(getString(R.string.recharge_commodity_name)),
        new OperateCenter.OnRechargeFinishedListener() {
            @Override
            public void onRechargeFinished(boolean success, int resultCode, String msg) {
                Log.i(TAG, resultCode + " " + msg);
            }
        });