帮助文档

1     使用前准备

1)      单机\sdk\flashAir\assets\"下的文件copy到游戏的assets\

2)      单机\sdk\flashAir\libs\ ganga.android.ane" 拷贝到游戏项目的 libs 目录下;

3)      在项目属性的 Flex Build Path - Native Extension 下,添加对ganga.android.ane的引用;

4)      在项目属性的 Flex Build Packaging - Google Android - Native Extensions 下,在 Package 列为ganga.android.ane打上勾;

5)      在游戏项目的 xxx-app.xml 里添加SDK提供的Activity引用,可参考"单机\sdk\ AndroidManifest.xml "

<activity

android:name="com.snowfish.a.a.s.PA"

android:theme="@android:style/Theme.Translucent.NoTitleBar"

android:configChanges="keyboardHidden|orientation"

android:windowSoftInputMode="stateHidden">

</activity>

<service

android:name="com.snowfish.a.a.s.ABGSvc"

android:enabled="true"

android:process="com.snowfish.a.a.bg" >

<intent-filter>

<action android:name="com.snowfish.a.a.s.ABGSvc"/>

<category android:name="android.intent.category.DEFAULT"/>

</intent-filter>

</service>

<meta-data

android:name="com.snowfish.appid"

android:value="KEY">

</meta-data>

<meta-data

android:name="com.snowfish.customer"

android:value="SNOWFISH">

</meta-data>

<meta-data

android:name="com.snowfish.channel"

android:value="SNOWFISH">

</meta-data>

<meta-data

android:name="com.snowfish.sdk.version"

android:value="1">

</meta-data>

标红处的KEY值需要替换成易接后台分配的APPID,格式如下:{12345678-12345678}。

6)      添加应用权限

将游戏的AndroidManifest.xml中添加use-permision如下,可参考单机\sdk\ AndroidManifest.xml "

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

<uses-permission android:name="android.permission.SEND_SMS"/>

<uses-permission android:name="android.permission.INTERNET"/>

<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

<uses-permission android:name="android.permission.GET_TASKS" />

<uses-permission android:name="android.permission.WAKE_LOCK" />

<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>

7)      在游戏项目的 xxx-app.xml 里添加

<extensions>

<extensionID>cn.ganga.ane.android</extensionID>

</extensions>

2     在游戏初启动界面,调用接口(必选接口)

SFCommonSDKInterface.getInstance().initSDK();

SFCommonSDKInterface.getInstance().addEventListener;

(Constants.EVENT_TYPE_GANGA_CALLBACK,onCallbackEvent); 

调用该接口完成SDK计费流程需要的信息。

该接口需在游戏一启动时调用。

onCallbackEvent函数是对回调的处理,后续有说明,

具体用法参考demo

3     在游戏启动后,判断用户是否开启音效接口(必选接口)

SFCommonSDKInterface.getInstance().isMusicEnable(); 

返回值: 0 关闭, 1 开启

判断SDK是否需要打开游戏声音,目前只有移动基地需要此接口

游戏开发者需要根据该返回值,设定游戏背景音乐是否开启。

4     在游戏需要弹出计费界面的场景调用计费接口(必选接口)

SFCommonSDKInterface.getInstance().pay(paymentIdString: String);

参数:paymentIdString:计费点索引

5     回调处理(必选接口)

public function onCallbackEvent(event:CallbackEvent):void

回调统一在此函数中处理,具体用法参考demo

回调的类型如下:

//定义回调事件类型

public static constCALLBACKTYE_PaySuccess:String   = "paySuccess";

public static constCALLBACKTYE_PayFailed:String   = "payFailed";

public static constCALLBACKTYE_PayCancel:String   = "payCanceled";

public static constCALLBACKTYE_MusicEnable:String  = "isMusicenable";

6     更多游戏接口

SFCommonSDKInterface.getInstance().viewMoreGame();

调用该接口查看更多游戏。

调用示例见SDK提供的Demo脚本,

7     游戏退出接口(必选接口)

在游戏退出的时候调用

SFCommonSDKInterface.getInstance().exitSDK();

8     获取Meta信息接口(可选接口)

该接口用于获取androidMeta信息接口

SFCommonSDKInterface.getInstance().getMetaData(key: String);