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信息接口(可选接口)
该接口用于获取android中Meta信息接口
SFCommonSDKInterface.getInstance().getMetaData(key: String);