版署sdk客户端接入指南

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:operateBZ:2.1.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'])
}

<application>
    <!-- 游戏 Activity 配置建议
        应该使用 android:configChanges="orientation|screenSize|keyboardHidden|screenLayout|navigation|smallestScreenSize|fontScale" 
        不应该使用 android:launchMode="singleTask" 启动模式，可以考虑 singleTop
    -->
    <activity
        android:name="cn.m4399.operateBZ.account.LoginActivity"
        android:configChanges="orientation|screenSize|keyboardHidden|screenLayout|navigation|smallestScreenSize|fontScale"
        android:screenOrientation="behind"
        android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
</application>

private void initSDK(){
    mOpeCenter=OperateCenter.getInstance();
    OperateConfig opeConfig = new OperateConfig.Builder(MainActivity.this)
        // 设置 SDK 页面方向，必须，应与游戏方向一致，可取值见下文说明
        .setOrientation(GAME_ORIENTATION)
        // 设置游戏运营 key，必须
        .setGameKey(GAME_KEY)
        // 设置调试模式，可选，默认false,发布前应设置为false或删除调用
        .setDebugEnabled(false)
        // 设置是否在 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"
       不应该使用 android:launchMode="singleTask" 启动模式，可以考虑 singleTop
  -->

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

boolean isLogin = mOpeCenter.isLogin();

User user = mOpeCenter.getCurrentAccount();

mOpeCenter.logout();

/*
 * 充值，使用订单类，新版接口
 *
 * 与直接传递参数几乎一样，只是可以对单笔订单设置是否支持超出金额
 */
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) {
            if (success) {
                // 充值操作成功，根据服务端回调决定是否道具
                // 注意：操作成功包含了订单成功、订单处理中两种情况
            } else {
               // 充值失败逻辑，resultCode查看文档结尾
           }
        }
});

String archiveStr = "4399测试存档";
OperateCenter.getInstance().setArchiveStringSimple(archiveStr, new CloudArchive.SimpleStrSetListener() {
    @Override
    public void onSuccess() {
        //上传存档成功
    }

    @Override
    public void onFailure(int code, @NonNull String message) {
        //上传存档失败
    }
});

OperateCenter.getInstance().getArchiveStringSimple(new CloudArchive.SimpleStrGetListener() {
    @Override
    public void onSuccess(@NonNull String archive) {
        //读取存档成功
    }

    @Override
    public void onFailure(int code, @NonNull String message) {
        //读取存档失败
    }
});

mOpeCenter.getVersion();

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

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

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