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

游戏基地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  引言 编写目的 游戏基地Android游戏SDK使用说明及其SDK，是为了简化合作伙伴对游戏计费等功能的开发流程。 术语及缩略词 试玩转激活：游戏在启动后，允许用户试用一段时间或指定关卡后，再触发计费的业务。 计费点：游戏在平台申报的激活点信息，包含：计费点名称、价格、及唯一标识代码等信息 强制计费点：即一次性付费的计费点，通常也是必须要付费的计费点，否则用户无法继续使用游戏或者进入下一关卡。 非强制计费点：即可重复购买的计费点，通常是游戏中道具或金币，用户可以多次购买的计费点。 适用对象及范围 适用于策划人员、系统设计人员、开发工程师和测试工程师 SDK概述 2.1 总体描述 2.1.1概述 中国移动Android游戏SDK开发包提供给任何可信任的第三方合作伙伴，可信任的第三方合作伙伴通过游戏基地提供的开发规范实现用户在Android游戏中的计费等功能。SDK开发包已经包含开发规范所涉及的游戏标准开发要求的实现，包括游戏LOGO制作要求，游戏开始画面，游戏计费交互模块，网络（CMNET/CMWAP/WIFI）检测，以及游戏退出确认画面等等。合作伙伴只需将SDK集成到游戏中，并调用相应的接口函数即可完成对开发规范所涉及的游戏标准要求的实现。 2.1.2 SDK使用准备 SDK开发包包括以下几个文件与目录： SDK开发资源包： SDK目录中包含SDK的资源文件，请复制SDK目录中的所有目录与文件，并拷贝至各自的游戏工程中），如下： 1）拷贝API A）拷贝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-permi