Android接入

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

前提条件

已通过游戏盾控制台获取Android版本的SDK包和AccessKey（即Appkey）。具体操作，请参见获取SDK和AccessKey。

1. 运行Android Studio。
2. 新建一个工程，并使用默认配置完成创建向导。示例中将工程命名为yxd_sdk_test。
   新建工程的目录结构如下图所示。

   说明 进行后续操作前，请确认新建工程可以正常运行。

   
3. 添加JAR。
   1. 将Android SDK包中的yunceng.jar文件复制到项目的libs目录下。
   2. 在Android Studio工程选项中，选择File > Project Structure，单击app组件，并打开Dependencies页签。
   3. 单击图标，选择jar dependency，并添加yunceng.jar。
   4. 单击OK，完成添加。
4. 添加SO文件。进入src > main目录，在该目录下新建jniLibs目录，并将Android SDK包中的SO文件复制到jniLibs目录。
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.** {*;}