Android

index

本节介绍SDK集成的Android游戏所需的配置和初始化工作。

1.配置开发环境

 1.1.下载SDK

1.2.配置开发工程

 2.初始化SDK

2.1.初始化SDK

2.2.调用onPause和onResume方法

 3.注意事项

 3.1.混淆配置

配置开发环境

1.1 下载SDK

下载并解压KTplay SDK到特定目录。

如果你使用Windows系统，建议将SDK解压到游戏工程所在盘符中，避免Eclipse导入工程找不到路径的问题.

1.2 配置开发工程

Android Studio

选择File->New->Import Module,选择KTplay工程导入。
游戏工程中添加对KTplay工程的引用。在游戏工程的build.gradle文件中添加以下依赖

dependencies {
    compile project(':KTPlay')
}

Eclipse (Deprecated)

我们不推荐使用Eclipse方式，因为Google官方已经不再提供ADT插件更新，同时，Eclipse也不支持AndroidManifest文件合并等自动化特性，需要手动添加各三方模块的权限

打开菜单File->Import->Android->Existing Android Code Into Workspace，选择KTPlaySDK/KTPlay导入。
选择游戏工程，打开右键菜单，选择Properties->Android->Library->Add,选择ktplay工程添加。
在游戏AndroidManifest文件的manifest节点下添加下列权限

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

在游戏AndroidManifest文件的application节点下添加：

<activity android:name="com.ktplay.activity.KTMPermissionsActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" >            
</activity>

<!-- From SDK 3.0 -->
<activity android:name="com.ktplay.activity.KTShareActivity"
            android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen">
</activity>

开启硬件加速
社区中的视频功能使用到硬件加速，在游戏AndroidManifest文件的application节点添加属性android:hardwareAccelerated并设置为true

<application android:hardwareAccelerated="true" >

2 初始化SDK

2.1 SDK初始化

在游戏主Activity的onCreate方法中，调用KTPlay.startWithAppKey方法初始化SDK。

KTPlay.startWithAppKey(Activity 对象,"你的AppKey","你的AppSecret")

2.2 调用onPause和onResume方法

当游戏挂起/恢复时，调用KTPlay的onPause和onResume方法

注意：

1、如果游戏使用到多个Activity，需要在每一个使用到KTplay功能的Activity中都调用这两个方法。

2、请确保这两个方法的调用，如果遗漏会导致消息接收不及时，后台的变更不能及时更新到前端等问题。

    @Override
    public void onPause(){
        KTPlay.onPause(this);
        super.onPause();
    }

    @Override
    public void onResume(){
        KTPlay.onResume(this);
        super.onResume();
    }

3 注意事项

3.1 混淆配置

如果你的游戏需要对最终APK进行混淆，请在你的混淆配置文件中添加下列内容：

-keep public class com.ktplay.sdk.R{*;}
-keep public class com.ktplay.sdk.R$**{*;}
-keep public class com.ktplay.open.KryptaniumAdapter
-keep public class com.ktplay.open.KryptaniumAdapter{*;}
-keep public class com.ktplay.open.KryptaniumAdapter$**{*;}
-keep public class com.ktplay.open.*{*;}
-keep public class com.google.android.gms.ads.identifier.AdvertisingIdClient{*;}
-keep public class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info{*;}