及游戏网游SDK开发文档(Android版).doc

和游戏网游SDK 开发文档 （Android版） 2014年12月23日 文件状态：[] 草稿[] 正式发布[√] 正在修改文件标识：当前版本： 完成日期： 文档版本历史版本/状态起止日期备注 2014-12-23 修订内容： 修订3.3初始化接口 删除3.4.2和3.4.3接口，原接口能力移植到3.3扩展参数中实现 修订3.6.2章节，扩展计费重载接口 修订3.9.3章节，同步更新Unity脚本接口 目录 1引言 3 1.1介绍 3 1.2术语及缩略词 4 2总体概述 4 2.1总体流程 4 2.2集成步骤 6 3详细接口 8 3.1应用程序加载接口 8 3.2游戏启动接口 9 3.2.1 游戏启动画面配置 9 3.2.2 游戏音效接口 9 3.3游戏初始化接口 10 3.4登录流程及接口 11 3.4.1登录流程 11 3.4.2获取登录同步结果 12 3.5更多游戏接口 13 3.6计费流程与接口 14 3.6.1计费流程 14 3.6.2计费接口 16 3.6.3获取付费同步结果 18 3.7游戏分享接口 20 3.8游戏退出接口 21 3.9 Unity3D游戏接口 22 3.9.1使用说明 22 3.9.2集成方式 22 3.9.3脚本接口 23 4常见问题 25 5 附录 26 5.1 游戏计费文件 26 5.2 平台响应状态码 27 1引言 1.1介绍 本文档的目的是为中国移动游戏业务合作方开发Android网游提供说明指导，对Android网游SDK的集成方式和步骤进行描述，介绍了游戏业务平台与合作方游戏间的技术开发接口规范，以便于游戏开发商开发游戏业务。 本文档主要包括以下几方面内容：中国移动游戏基地安卓网游业务总体概述、Android网游系统结构及流程说明、Android网游SDK集成步骤、Android网游SDK 接口说明、合作方游戏服务器接口说明、Unity3D引擎游戏适配、常见问题等。 本文档适用于中国移动游戏基地安卓网游SDK集成开发者。 本文档参考了以下规范文档最新版本： 序号 标准编号 标准名称 发布单位 [1] QB-D-XXX-XXXX 中国移动游戏业务设备规范 中国移动通信集团公司 [2] QB-D-XXX-XXXX 中国移动游戏业务接口规范 中国移动通信集团公司 [3] QB-D-XXX-XXXX 中国移动游戏业务总体技术要求 中国移动通信集团公司 [4] QB-D-XXX-XXXX 游戏业务平台合作方开发规范 中国移动通信集团公司 [5] QB-E-XXX-XXXX 中国移动游戏大厅客户端规范 中国移动通信集团公司 1.2术语及缩略词 词语 解释 CP Content Provider，内容提供商 HTTP Hyper Text Transfer Protocol，超文本传输协议 ICON LOGO 游戏业务内容提供商、服务提供商的商标 OTA Over The Air，空中无线下载技术 SP Service Provider，服务提供商 SDK Software Development Kit 的缩写，中文即“软件开发工具包”。广义上指辅助开发某一类软件的相关文档、范例和工具的集合。 XML Extensible Markup Language，可扩展标记语言 UAProfile URL Universal Resource Locator，统一资源定位符 游戏业务平台中进行各种交易的通用货币 计费点 游戏在平台申报的激活点信息，包含：计费点名称、价格、及唯一标识代码等信息 强制计费点 即一次性付费的计费点，通常也是必须要付费的计费点，否则用户无法继续使用游戏或者进入下一关卡。 非强制计费点 即可重复购买的计费点，通常是游戏中道具或金币，用户可以多次购买的计费点。 iGop 游戏业务管理平台，完成CP资质评审，游戏业务评审，测试及商用。 游戏平台 游戏业务通过使用移动游戏SDK与之交互的核心支付平台。 游戏服务器 合作方按照移动游戏规范自行实现的游戏服务器，用于完成同移动游戏平台进行数据交互与通信的服务器。 2总体概述 2.1总体流程 总体流程图 总体流程说明 合作方开发者需根据此总流程图集成使用移动游戏SDK。 必选流程： 1、游戏应用配置 集成SDK必须先配置游戏运行的必选配置（自定义Application）。此版本SDK需要游戏自定义Application类，加载SDK核心接口内容。Application的定义与使用方式详见3.1章节。 2、游戏启动画面 集成移动SDK启动画面（按照移动游戏规范，游戏的首个启动画面必须包含移动游戏LOGO），启动画面展现移动LOGO。启动画面的具体集成方式详见3.2章节。