中国移动游戏基地Android游戏SDK使用说明

游戏基地Android游戏SDK使用说明中国移动游戏基地2013年10月31日文件状态：[] 草稿[] 正式发布[√] 正在修改文件标识：当前版本：V2.1.4作者：金怀香完成日期：2013-10-31版本历史版本/状态作者参与者起止日期备注2.1.4 金怀香王安福2013-10-31 创建支持混合支付目录1 引言 (4)1.1 编写目的 (4)1.2 术语及缩略词 (4)1.3 适用对象及范围 (4)2 SDK概述 (5)2.1 总体描述 (5)2.1.1概述 (5)2.1.2 SDK使用准备 (5)2.2游戏初始化接口 (6)2.2.1游戏计费信息配置文件 (6)2.2.2应用程序加载接口 (7)2.2.3游戏初始化接口 (7)2.2.4设置登录透传参数接口 (8)2.2.5游戏登录结果回调接口 (8)2.3 游戏启动画面 (10)2.4 游戏退出接口 (10)2.5 更多游戏接口 (11)2.6游戏计费接口 (11)2.6.1计费流程 (11)2.6.2 计费接口 (12)2.7网游登录同步接口 (14)2.8计费同步接口 (15)2.9 获取游戏背景音乐开关 (16)3 Unity3D引擎游戏的开发 (16)3.1 复制资源文件 (16)3.2 编辑AndroidManifest.xml文件 (16)3.3 为游戏增加Unity3D脚本 (16)4常见问题： (18)1引言1.1编写目的游戏基地Android游戏SDK使用说明及其SDK，是为了简化合作伙伴对游戏计费等功能的开发流程。

1.2术语及缩略词试玩转激活：游戏在启动后，允许用户试用一段时间或指定关卡后，再触发计费的业务。

计费点：游戏在平台申报的激活点信息，包含：计费点名称、价格、及唯一标识代码等信息强制计费点：即一次性付费的计费点，通常也是必须要付费的计费点，否则用户无法继续使用游戏或者进入下一关卡。

非强制计费点：即可重复购买的计费点，通常是游戏中道具或金币，用户可以多次购买的计费点。

1.3适用对象及范围适用于策划人员、系统设计人员、开发工程师和测试工程师2SDK概述2.1 总体描述2.1.1概述中国移动Android游戏SDK开发包提供给任何可信任的第三方合作伙伴，可信任的第三方合作伙伴通过游戏基地提供的开发规范实现用户在Android游戏中的计费等功能。

SDK开发包已经包含开发规范所涉及的游戏标准开发要求的实现，包括游戏LOGO制作要求，游戏开始画面，游戏计费交互模块，网络（CMNET/CMWAP/WIFI）检测，以及游戏退出确认画面等等。

合作伙伴只需将SDK集成到游戏中，并调用相应的接口函数即可完成对开发规范所涉及的游戏标准要求的实现。

2.1.2 SDK使用准备SDK开发包包括以下几个文件与目录：1.SDK开发资源包：SDK目录中包含SDK的资源文件，请复制SDK目录中的所有目录与文件，并拷贝至各自的游戏工程中），如下：1）拷贝APIA）拷贝Native API将SDK/libs目录中的文件全部拷贝到游戏libs下。

B）拷贝JAVA API将SDK/runtime目录文件，直接复制到游戏根目录下，切勿将runtime下面的jar 文件放入libs下面编译，否则会报编译错误，例如：bad range…。

2）拷贝SDK资源A）将SDK/res文件夹中的内容拷贝至游戏工程目录中。

B）将SDK/assets文件夹中的所有文件拷贝至游戏相同的工程目录中，不能删除其中的任何文件，否则导致非正常运行。

3）替换游戏厂商logo或游戏logo将assets/OpeningAnimation目录下的两个图片：g_logo_sp.png，g_logo_cp.png替换成合作伙伴自己的logo；当SP和CP是同一厂商时，即该两个图片一样时，请将其中一个Logo 图片换成游戏Logo，避免重复展示。

另外：合作伙伴提供的logo大小不超过118x118像素，宽度和高度都不能超过。

4）添加SDK提供的Activity引用将SDK\AndroidManifest.xml.activity.txt中的文本Copy到游戏的AndroidManifest.xml中Activity的横竖屏配置（android:screenOrientation），最好设置成游戏主界面的横竖屏设置。

5）添加SDK需要的use-permision将SDK\AndroidManifest.xml.permision.txt中的文本Copy到游戏的AndroidManifest.xml 注意：不要重复添加use-permision项。

6）为游戏主入口添加中国移动游戏基地标识（Intent-Filter）为游戏主入口Activity添加中国移动游戏基地标识，如下：<activityandroid:name=".Example" android:label="@string/app_name"><intent-filter><actionandroid:name="android.intent.action.MAIN" /><categoryandroid:name="UNCHER" /></intent-filter><intent-filter><actionandroid:name="android.intent.action.CHINAMOBILE_OMS_GAME" /><categoryandroid:name="android.intent.category.CHINAMOBILE_GAMES" /> </intent-filter>2.示例工程（Sample目录中为游戏计费实现的实例，详细的Sample程序源文件在Sample/GameDemo/文件夹下），请不要直接拷贝Sample的示例代码，根据游戏时间情况，处理接口调用逻辑。

3.开发文档（游戏基地Android游戏开发SDK使用说明.doc）2.2游戏初始化接口2.2.1游戏计费信息配置文件在APK包的assets目录下包含登录及计费相关数据文件，文件内容均已加密。

SDK提供了测试使用的Charge.xml、ConsumeCodeInfo.xml。

游戏开发者需要确认这两个文件已在游戏的assets目录下存在，否则编译不通过。

待游戏提交至移动平台后，动态替换该文件内容（替换成游戏实际业务及计费信息）。

注意：该两个文件是计费的核心数据，请勿擅自修改其内容，否则计费失败。

另：请将SDK\assets\Config.xml也一并复制到游戏assets 目录，该文件与计费无关，是SDK的版本标识，但是必须包含。

针对客户端网游业务，游戏开发者在集成SDK过程中，无法直接测试真实的登录与购买道具流程；因为SDK提供的Charge.xml及ConsumeCodeInfo.xml信息是测试数据。

若要完成登录及购买道具测试，请CP将集成SDK的游戏提交至游戏管理平台，并点击《同步自测》，可以从平台上下载含真实业务信息的包体内容，并用指定的测试号码（同步自测时给出的号码）完成登录及购买道具测试。

2.2.2应用程序加载接口游戏开发者在集成SDK，务必先自定义全局Application。

Application里面代码必须包含：System.loadLibrary("megjb");示例代码如下:public class CmgameApplication extends Application {public void onCreate() {System.loadLibrary("megjb");}}AndroidManifest.xml中配置：<application android:icon="@drawable/icon" android:label="@string/app_name" android:name=".CmgameApplication">2.2.3游戏初始化接口游戏的初始化是实现游戏计费的必须操作。

在游戏启动之后计费之前，务必调用如下方法，否则无法使用计费功能。

1 GameInterface.initializeApp(Activity main);如果合作伙伴希望自定义计费界面的游戏名称，游戏提供商及客服电话信息（SDK默认采用平台上申报业务时填写的客服电话），可以调用重载接口2实现：2 GameInterface.initializeApp(Activity main, String gameName, String provider, String serviceTel);注：初始化接口中将完成用户登录流程，如果合作方需要用户登录信息可在初始化后到其网游服务器登录同步接口中去获取，详细实现请见2.7章节。

参数描述:参数名称类型意义注释：act Activity 游戏项目的上下文环境该Activity需要在游戏运行期间不能被finish掉，否则计费会出现不可预知问题gameName String 移动计费界面展现的游戏名称传null时，SDK使用平台申报的业务名称provider String 移动计费界面展现的游戏提供商名称传null时，SDK使用平台中合作伙伴管理栏目中填写的内容提供商名称serviceTel String 移动计费界面展现的客服电话大多数情况，不需要指定该值，SDK会从使用平台上业务申报时指定的客服电话调用示例:GameInterface.initializeApp(this);2.2.4设置登录透传参数接口描述：由于SDK会自动完成登录流程，登录成功后，移动平台系统将会登录结果同步到游戏服务器，则游戏开发者需要根据此参数，取得登录开始与结束的唯一对应关系。

该参数的使用方式，需要结合2.7章节，才有意义。

接口定义：GameInterface.setExtraArguments(String[] args);参数描述:参数名称类型意义注释：args String[] 可扩展的自定义业务参数集合，对于网游业务，可以用该接口设置登录透传参数调用示例：String cpparam = “20131031101034z”;GameInterface.setExtraArguments(new String[]{cpparam})2.2.5游戏登录结果回调接口SDK会在2.2.3章节初始化接口中实现登录流程，并通过该接口告知游戏开发者登录结果。