本文介绍了使用Android Studio接入游戏盾SDK的操作方法。

前提条件

已通过游戏盾控制台获取Android版本的SDK包和AccessKey(即Appkey)。具体操作,请参见获取SDK和AccessKey下载SDK和AccessKey

背景信息

核心接口函数包括:initEx、getProxyTcpDomain。更多介绍,请参见核心函数说明

您可以联系游戏盾售后技术支持获取Demo程序。

操作步骤

  1. 运行Android Studio。
  2. 新建一个工程,并使用默认配置完成创建向导。示例中将工程命名为yxd_sdk_test
    新建工程的目录结构如下图所示。新建工程,目录
    说明 进行后续操作前,请确认新建工程可以正常运行。
    新建工程,正常运行
  3. 添加JAR。
    1. 将Android SDK包中的yunceng.jar文件复制到项目的libs目录下。复制yunceng.jar
    2. 在Android Studio工程选项中,选择File > Project Structure,单击app组件,并打开Dependencies页签。dependencies
    3. 单击添加图标,选择jar dependency,并添加yunceng.jar添加yunceng.jar
    4. 单击OK,完成添加。
  4. 添加SO文件。进入src > main目录,在该目录下新建jniLibs目录,并将Android SDK包中的SO文件复制到jniLibs目录。复制libyunceng.so
  5. 设置访问权限。打开AndroidManifest.xml文件,参照下图在其中添加以下代码。
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    访问权限
  6. 初始化SDK。
    说明 只需成功初始化一次即可。
    使用以下代码前,必须替换以下变量:
    • <yourAppKey>替换成您通过游戏盾控制台获取的AccessKey。
    • <token>替换成游戏内玩家的唯一ID。如果无法获取该ID,可以设置为一个默认值,但是不允许为空。
    public int sdk_init() {
        String appkey = "<yourAppKey>";
        String token = "<token>";
        int ret = YunCeng.initEx(appkey, game);
        if (ret == 0) {
            Log.d("yuncengsdk", "sdk init success");
        } else {
            Log.e("yuncengsdk", "sdk init failed, ret " + ret);
        }
        return ret;
    }
  7. 可选:配置ProGuard。
    如果您使用ProGuard进行混淆,则需要在ProGuard配置文件中添加以下内容:
    -keep class com.aliyun.security.yunceng.** {*;}

后续步骤

完成SDK接入后,您将可以通过SDK获得游戏盾转化的IP和端口。针对不同的业务类型,使用游戏盾转化IP和端口的方法也有区别,请分别参见以下文档: