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

前提条件

  • 从游戏盾控制台获取Android版本的SDK包和AccessKey(即Appkey)。更多信息,请参见获取SDK和AccessKey
  • 从游戏盾控制台获取以下信息。
    • GroupName:节点组标识。前往游戏盾控制台,进入游戏管理页面,在基础接入参数页签下查看。基础接入参数,节点组标识
    • 防护目标标识:前往游戏盾控制台,进入游戏管理页面,在防护目标配置页签下查看。防护目标配置,防护目标标识

背景信息

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

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

操作步骤

  1. 运行Android Studio。
  2. 新建一个工程,并使用默认配置完成创建向导。示例中将工程命名为yxd_sdk_test。
    新建工程的目录结构如下图所示。新建工程,目录
    说明 进行后续操作前,请确认新建工程可以正常运行。
    新建工程,正常运行
  3. 添加依赖。
    1. 将Android SDK包中的yunceng.jar文件复制到项目的libs目录下。您可以使用拖拽的方式进行复制。复制yunceng.jar
    2. 在Android Studio工程选项中,选择File > Project Structure,单击app组件,并打开Dependencies页签。dependencies
    3. 单击添加图标(+),选择jardependency,并添加yunceng.jar添加yunceng.jar
    4. 单击OK,完成添加。
  4. 添加so文件。进入src > main目录,在其下新建jniLibs目录,并将libyunceng.so文件复制到jniLibs目录。复制libyunceng.so
  5. 设置访问权限。打开AndroidManifest.xml,参照下图在其中添加以下代码。
    <uses-permission android:name="android.permission.INTERNET" />
    访问权限
  6. 添加运行代码,获取IP。示例代码如下。
    // 初始化,只需成功初始化一次
    int ret = 0;
    ret = YunCeng.initEx(getResources().getString(R.string.appkey), "token");if (0 != ret) {
             msg_show.setText("sdk init failed " + Integer.toString(ret));
             return;
    }msg_show.setText("sdk init success ");
    return;
    
    // 核心参数获取IP
    ret = YunCeng.getProxyTcpByDomain("玩家ID","GroupName", "防护目标标识","服务器端口", ip, port);
    if (0 == ret) {
            msg_show.setText("get next ip success: " + Integer.toString(ret) + "\nip : " + ip + "port :
    " + port);
    } else {
            msg_show.setText("get next ip failed. : " + Integer.toString(ret));
    }
  7. 可选: 配置ProGuard。如果您使用ProGuard进行混淆,则需要在ProGuard配置文件中添加以下内容。
    -keep class com.aliyun.security.yunceng.** {*;}

后续步骤

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