客户端接入指南

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.13.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_FOUR)
    // 设置悬浮窗初始位置，可选，有四种，分别在屏幕上下左右
    .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:configChanges="orientation|screenSize|keyboardHidden|screenLayout|navigation|smallestScreenSize|fontScale"
     若游戏覆盖了 `android:resizeableActivity="true"` ，则必须按上面配置
     
     不应该使用 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();

// 游戏 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();
}