Android接入

安卓SDK接入文档

点击下载对应示例demo及资源

SDK基础信息

九四玩SDK

开发者：北京开源纵横网络科技有限公司

主要功能：提供游戏联合运营的登录、⽀付、运营（社区）⽀持服务

个人信息处理规则：《个人信息采集详情》《九四玩SDK隐私政策》

合规使用说明：《九四玩SDK合规使用说明》

1.环境接入

1.1 引入仓库

并在app module级别的gradle文件中，在dependencies里引入demo的SDK

在allprojects的repositories中添加maven仓库
allprojects {
    repositories {
        maven {
            url 'https://artifact.bytedance.com/repository/Volcengine/'
        }
        // 其他仓库
    }
}

1.2 添加资源

将demo中 lib 及 res 拷贝到项目对应的文件夹中

再build.gradle 文件下引用lib的内容及巨量

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

implementation 'com.bytedance.ads:AppConvert:2.0.1-rc.2'

1.3 添加权限（aar 中已经含有此权限）

网络权限
<uses-permission android:name="android.permission.INTERNET" />
震动权限
<uses-permission android:name="android.permission.VIBRATE" />
查询安装包权限
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>

1.4 Application 初始化

不要忘掉这个要不会报错

注意该application 要在AndroidManifest 注册

public class Myapp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 加入以下方法
        KyzhSdk.init(this);
    }
}

2.SDK方法接入

2.1 初始化

字段	类型	说明
APP_ID	String	游戏id
LOGIN_KEY	String	游戏key
PAY_KEY	String	不要填写支付key
true(第一个true)	Boolean	是否开启初始化弹窗
true(第二个true)	Boolean	是否显示隐私政策弹窗

 KyzhLib.init(this, APP_ID, LOGIN_KEY, "", true,true, new InitListener() {
            @Override
            public void success() {
                Toast.makeText(MainActivity.this, "初始化成功", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void error() {

            }
        });

2.2 登录

字段	类型	说明
token	String	返回用户token
uid	String	返回用户uid
error	String	错误信息

 KyzhLib.startLogin( new AccountListener() {
                @Override
                public void success(String token, String uid) {
                    Log.e( "success: ",token +  "   "+ uid);
                }

                @Override
                public void error(String error) {
                    Log.e( "success: ",error );
                }
            });

2.3 切换账号

SDK仅关闭悬浮球 token uid 置空

///*用于切换账号  ,sdk仅关闭悬浮球  token uid 置空  */ 		
KyzhLib.setChangeAmountListener(new LogoutListener() {
            @Override
            public void success() {
                Log.e("TAG", "success: " );
                Toast.makeText(MainActivity.this, "账号切换成功", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void error(String s) {
                Log.e("TAG", "success: " );
            }
        });

2.4 切换小号（可不接）

当setChangeSmallListener 与setChangeAmountListener 同时接入后悬浮球点开界面只显示切换小号当集成切换小号后直接返回uid token 游戏方应切换游戏角色直接登录返回的角色信息

//切换小号
KyzhLib.setChangeSmallListener(new AccountListener() {
    @Override
    public void success(String token, String uid) {
        Log.e("TAG", "setChangeSmallListener:uid: "+uid+"  Token："+token );
    }
    @Override
    public void error(String error) {
        Log.e("TAG", "error: "+error );
    }
});

2.5账号登出

KyzhLib.logOut(new LogoutListener() {
    @Override
    public void success() {
        Log.e("TAG", "success: " );
        Toast.makeText(MainActivity.this, "退出成功", Toast.LENGTH_SHORT).show();
    }
    @Override
    public void error(String error) {
        Toast.makeText(MainActivity.this, error, Toast.LENGTH_SHORT).show();
    }
});

2.6 账号注销

/*即 删除账号   不加此方法  用户注销后会执行关闭应用操作
**/
KyzhLib.LogoffAmount(new GuestLoginListener() {
    @Override
    public void success() {
        Log.e(TAG, "success: " );
    }
    @Override
    public void error(String s) {
        Log.e(TAG, "error: "+s );
    }
});

2.7 购买

参数	类型	说明
cpOrderId	String	订单号
serverId	String	服务器id
amount	String	购买金额
charid	String	角色id
extinfo	String	额外信息

KyzhLib.startPay(this,  "cpOrderId", "serverId", "amount", "charid","extinfo", new PayListener() {
   @Override
   public void success(String orderId) {
       Toast.makeText(MainActivity.this, "支付成功,订单号为"+orderId, Toast.LENGTH_SHORT).show();
   }

   @Override
   public void error(String error) {
       Toast.makeText(MainActivity.this, "支付失败", Toast.LENGTH_SHORT).show();
   }
});

2.8 上传角色

参数名	类型	参数说明
role_name	string	角色名称
charId	string	角色ID
level	string	等级（没有传0）
power	string	战力（没有传0）
serverid	string	区服ID
servername	string	区服名称

KyzhLib.pushRoleInfo(roleName, charId, level, power, serverId, serverName, new GuestLoginListener() {
    @Override
    public void success() {
        ToastUtils.showL(KyzhPostUserInfoActivity.this,"上传成功");
    }

    @Override
    public void error(String usearName) {
        ToastUtils.showL(KyzhPostUserInfoActivity.this,usearName);
    }
});

3.0 其他

1.部分游戏可能存在不能显示悬浮的情况可以手动调起开启关闭（只有这些调用的传入了假的application的上下文或者自己new 的application）

KyzhLib.openFloatingView(this);
KyzhLib.closeFloatingView(this);

2。. 游戏包需打v1 v2 也可以只v1 签名

3 targetSdkVersion升级到30的第三方应用，由于Android 11 软件包可见性特性的影响，SDK的接口可能无法正常拉起盒子，从而无法使用盒子的部分功能，需要在主工程的AndroidManifest.xml 中增加标签，代码如下：

<manifest package="com.example.app">

      // 在应用的AndroidManifest.xml添加如下<queries>标签
    <queries>
        <package android:name="com.tencent.mm" />
        <package android:name="com.tencent.mobileqq" />
 		  <package android:name="a94hwan.bjkyzh.star" />
        <package android:name="a94hwan.bjkyzh.combo" />
      
    </queries>

</manifest>

Last modified: 09 六月 2025