本文介绍了使用Android Studio接入游戏盾SDK的操作方法。
背景信息
核心接口函数包括:initEx、getProxyTcpDomain。更多介绍,请参见核心函数说明。
您可以联系游戏盾售后技术支持获取Demo程序。
操作步骤
- 运行Android Studio。
- 新建一个工程,并使用默认配置完成创建向导。示例中将工程命名为yxd_sdk_test。
新建工程的目录结构如下图所示。
说明 进行后续操作前,请确认新建工程可以正常运行。
- 添加JAR。
- 将Android SDK包中的yunceng.jar文件复制到项目的libs目录下。
- 在Android Studio工程选项中,选择,单击app组件,并打开Dependencies页签。
- 单击图标,选择jar dependency,并添加yunceng.jar。
- 单击OK,完成添加。
- 添加SO文件。进入目录,在该目录下新建jniLibs目录,并将Android SDK包中的SO文件复制到jniLibs目录。
- 设置访问权限。打开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"/>
- 初始化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;
}
- 可选:配置ProGuard。
如果您使用ProGuard进行混淆,则需要在ProGuard配置文件中添加以下内容:
-keep class com.aliyun.security.yunceng.** {*;}
后续步骤
完成SDK接入后,您将可以通过SDK获得游戏盾转化的IP和端口。针对不同的业务类型,使用游戏盾转化IP和端口的方法也有区别,请分别参见以下文档: