游戏业务平台合作方开发规范品牌低端机业务分册（试行）中国移动.doc

游戏业务平台合作方开发规范-品牌低端机业务分册（试行）Game Development Specification of Game Master Platform 目录1.范围12.修订历史13.规范性引用文件14.术语、定义和缩略语25.业务概述25.1.业务概念25.2.业务开放范围25.3.业务类型25.3.1.按使用方式分类25.3.2.按计费方式分类35.3.3.按用户消费方式分类36.游戏界面要求36.1.应用界面设计基本原则36.2.游戏激活界面设计46.3.应用界面文字格式要求46.4.计费要求46.4.1.计费接口调用47.申报、评审、测试、上线流程57.1.总体流程57.2.流程说明68.品牌低端机测试流程78.1.业务合作伙伴内部测试78.1.1.流程图88.1.2.内部测试流程88.2.业务评审98.2.1.流程图108.2.2.流程说明108.3.正式环境测试阶段108.3.1.流程图118.3.2.流程说明129.附录12附录A：内容上传12附录B：状态码列表15前言本规范规定了中国移动游戏业务平台与其上运营的游戏间的开发接口及相关协议，是各游戏开发商开发游戏的依据，以满足游戏业务平台的要求。本规范主要包括以下几方面内容： 业务概述、游戏界面要求、数据类型和接口要求等。本规范由中移 号文件印发。本规范由中国移动通信有限公司技术部提出并归口。本规范由中国移动通信有限公司技术部负责解释，具体细节由中国移动通信有限公司负责解释。本规范起草单位：中国移动通信有限公司手机游戏基地本规范主要起草人： 1. 范围本规范规定了中国移动品牌低端机游戏平台上的游戏开发规范，供各游戏CP/SP在开发游戏时使用。2. 修订历史时间内容版本号作者2010-9-281.0.03. 规范性引用文件下列规范所包含的条文，通过在本规范中引用而成为本规范的条文。本规范出版时，所示版本均为有效。所有规范都会被修订，使用本规范的各方应探讨使用下列规范最新版本的可能性。1 ELF 可执行链接文件格式，可执行链接文件格式是UNIX系统实验室（USL)作为应用程序二进制接口（Application Binary Interface(ABI)而开发和发布的。工具接口规范委员会（TIS)现在了可在发展中的ELF规范作为工作在32位体系上不同操作系统之间的二进制文件格式。2 RFC1867 Form-based File Upload in HTML3 RFC1945 Hypertext Transfer Protocol - HTTP/1.04 RFC2068 Hypertext Transfer Protocol - HTTP/1.15 RFC2616 Hypertext Transfer Protocol - HTTP/1.1 断点续传4. 术语、定义和缩略语下列术语、定义和缩略语适用于本规范：词语解释OTAOver The Air, 即空中、无线方式HTTPHyper Text Transfer Protocol，超文本传输协议XMLeXtensible Markup Language，可扩展标记语言SOAPSimple Object Access Protocol，简单对象访问协议CPContent Provider，内容提供商SPService Provider，服务提供商CMGP游戏业务平台业务网元指www portal、 wap portal、 网游服务器等CDCConnected Device Configuration，连接设备配置CLDCConnectedLimitedDeviceConfiguration，连接限制设备配置MIDPMobileInformationDevicesProfile，移动信息设备表MD5Message Digest Algorithm，信息摘要算法5. 业务概述 5.1. 业务概念 品牌低端机游戏业务平台是统一接入中国移动游戏业务的平台，通过与各类门户等外围系统进行业务交互，提供内容管理、营销管理、点数管理、统计分析等能力给外围设备开展游戏类业务。5.2. 业务开放范围 本业务向能够通过GPRS、3G网络接入到中国移动的手机用户开放。所有游戏计费均通过中间件或虚拟机计费接口访问品牌低端机游戏业务平台来进行计费。对于联网游戏，均需通过中间件或虚拟机平台，且必须使用CMWAP联网。5.3. 业务类型 5.3.1. 按使用方式分类l 单机游戏：在使用过程中通常不需要通过移动网络与游戏网络服务器或其他客户端发生互动的游戏叫单机游戏，仅触发联网进行下载、激活、计费、上传积分等游戏属于单机游戏。l 手机网游：在使用过程中需要通过移动网络与游戏网络服务器或其他客户发生互动的游戏叫手机网游，但不包括仅用联网实现激活、上传积分等功能的游戏。5.3.2. 按计费方式分类游戏业务平台上的游戏计费包含流量费和信息费，本分类方式只基于信息费。依据信息费，可分为下载计费、激活计费和道具计费两种：l 下载计费：指在软件商店触发游戏下载并下载成功时触发的计费。a)下载之前显示扣费提示，在用户下载成功后自动触发的计费；b)多次重复下载可以根据服务器规则，设定为重复收费和一次性收费；l 激活计费：指用户激活游戏的特殊关卡或使用游戏复活操作时触发的计费。a)激活的关卡可以设定成一次性激活和多次激活；b)游戏复活操作，每次复活单独计费；l 道具计费：指用户使用游戏的特殊道具时触发的计费。a)道具计费设定成一次性计费和多次计费；b)网游的道具计费直接在网游服务器进行计费，单机游戏通过平台发起计费；5.3.3. 按用户消费方式分类5.3.3.1. 话费消费方式指用户下载或激活游戏及购买游戏道具时，所需费用直接从用户的手机话费中扣除。6. 中间件游戏业务的计费6.1. 计费要求6.1.1. 计费接口调用 内容开发商根据平台开发手册的计费接口，提供相关应用ID，计费点ID，即可完成计费接口调用。对于计费过程中，计费信息提示，计费过程处理，统一由中间件或虚拟机平台负责完成。 品牌低端机游戏平台计费接口调用说明： 1：申请计费 int SendCharge(int chargeType, char * appID,char * chargeID, int menuID);函数功能：计费接口。参数说明：chargeType计费类型； 0 为过程计费appID应用ID，游戏基地为这个应用分配的唯一ID chargeID该计费点使用的计费点序号，也是由游戏基地分配的 menuID保留，应用填0即可 返 回：1 计费成功； 0 计费失败2：获取计费信息int GetChargeSum(char * chargeID);函数功能：获取计费点信息接口。参数说明： chargeID该计费点使用的计费点序号返 回： 该计费点的计费金额，单位为分 3：应用ID，计费ID获取但游戏业务申报后，由游戏基地以邮件或其他方式通知游戏开发方相关的游戏应用ID及计费ID。7. 游戏界面设计要求7.1. 应用界面设计基本原则游戏CP/SP开发的客户端应用程序的操作界面必须与手机已有功能的操作习惯一致；游戏程序启动界面必须使用中国移动指定的统一标识，游戏LOGO必须按照中国移动手机游戏标识使用规范.pdf制作，LOGO展现必须符合规范内容，不应出现必要LOGO内容的缺失或不必要LOGO内容的增添，当SP与CP是同一厂商时，即SP与CP的LOGO一致时，静态LOGO图片则应只展现一次该LOGO，动态图片则应在其中一个LOGO的位置放置该游戏的游戏LOGO，以避免重复；如果游戏本身没有任何音乐音效，游戏标识中的音效开关这一屏可以去掉，游戏标识本身的LOGO滚动音效也可以去掉。所有游戏必须按照附录B，根据相关状态码向用户提示规范用语。7.2. 应用界面文字格式要求对于在游戏大厅中显示的应用程序名称，所有可以用中文表示的文件名，必须用中文表示，以便于用户在游戏大厅内查找已下载的应用； 对于游戏程序内向用户呈现的显示界面，所有可以用中文表示的内容，必须用中文表示；要求能在游戏所支持的手机上正确显示；此中文显示要求包括各菜单选项，帮助信息，指示信息。8. 游戏业务申报、评审、测试、上线流程8.1. 总体流程8.2. 流程说明对于品牌低端机申报、评审、测试、上线相关流程说明如下：1. 游戏业务合作伙伴根据品牌低端机单机游戏业务分册（试行）的要求以邮件方式将完成评审版本内测的游戏程序包进行游戏业务的申报；2. 游戏基地收到游戏业务合作伙伴的申报后，组织评审。使得游戏业务合作伙伴提交的游戏程序包具备在单机环境下正常运行的条件；3. 评审完毕后，游戏基地通过内部工单系统对通过评审的业务制作局数据，并同步到品牌低端机运营平台；4. 游戏业务合作伙伴对通过评审的游戏业务进行机型移植和内部测试，在机型移植和内部测试过程中如遇到平台相关问题可以要求平台提供商提供相关技术支持；5. 游戏业务合作伙伴将完成机型移植和内部测试的游戏程序包按照游戏基地的要求提交至游戏基地；6. 游戏基地收到游戏业务合作伙伴的测试申请后，根据测试管理办法安排外包测试公司对游戏程序包进行测试；7. 测试公司在对游戏程序包的测试过程中，如遇到平台相关问题可以要求平台提供商提供相关技术支持；8. 测试公司完成对游戏程序包的测试后，将测试结果反馈到游戏基地；9. 游戏基地将测试结果反馈至游戏业务合作伙伴；10. 游戏基地安排通过测试符合条件的游戏程序包上线；11. 游戏程序包上线后，整个流程结束。9. 品牌低端机测试流程9.1. 业务合作伙伴内部测试新的应用在业务申报前，业务合作伙伴需要在开发调试环境对该应用进行内部测试，内部测试达标以后，方可提交应用版本进行业务申报。9.1.1. 流程图9.1.2. 内部测试流程1. 准备阶段Ø 平台提供商向业务合作伙伴提供IDE开发环境Ø 平台提供商向业务合作伙伴提供开发调试认证工具Ø 平台提供商向业务合作伙伴提供开发调试版软件商店Ø 开发调试版本会配置基本的通用数据并公开给业务合作伙伴2. 业务合作伙伴内部测试流程1) 业务合作伙伴自行购买已经内置平台提供商正式版本大厅的品牌低端机；2) 业务合作伙伴通过USB数据线将平台提供商提供的开发调试版应用商店替换文件拷贝到手机内，替换原手机内的正式版本应用商店；注：开发调试版本大厅只包含我的游戏、游戏安装2个选项，供业务合作伙伴开发调试。3) 业务合作伙伴根据合作方开发规范进行应用开发；4) 业务合作伙伴通过平台提供商提供的开发调试认证工具对应用进行认证签名；注：通过开发调试认证工具进行签名的应用仅可在开发调试版应用商店中运行。5) 业务合作伙伴拷贝应用到已替换为开发调试版应用商店的手机目录下，直接可进行安装；6) 业务合作伙伴利用平台提供商提供的通用数据在开发调试环境对应用进行内部测试；7) 业务合作伙伴完成测试对应用进行内部归档；8) 业务合作伙伴对归档后的应用进行业务申报。9.2. 业务评审在业务评审阶段，将在开发调试版应用商店中对应用进行评审测试，开发调试版应用商店连接的平台非正式平台，为测试平台。9.2.1. 流程图9.2.2. 流程说明1. 业务合作伙伴通过邮件方式进行业务申报；2. 游戏基地接受业务合作伙伴的申报资料并进行审核；3. 平台提供商为游戏基地评审业务包进行运行环境准备，包括开发调试版应用商店安装等；该评审终端需已经内置了平台提供商的平台；4. 基地将业务合作伙伴送评的游戏业务包拷贝到评审终端上，进行测试评审；5. 基地根据各申报游戏业务包的评审情况发布评审结果。9.3. 正式环境测试阶段正式环境测试则连接到正式平台，提交到正式环境测试的应用只可以在加入到白名单的手机上通过手机平台看到，其余非白名单用户无法看到正式环境下正在进行测试的应用。9.3.1. 流程图9.3.2. 流程说明1. 业务合作伙伴提交测试申请，及相关资料；2. 游戏基地接收相关测试申请，并进行审核；3. 游戏基地对于测试游戏包进行生产环境认证；4. 游戏基地将测试游戏包部署到生产环境的测试专区；并将测试公司使用的测试手机设置进白名单；5. 测试公司按照基地的要求，对于应用商店中测试专区中的各项测试内容进行测试；测试专区将会看到提交到正是环境进行测试但是非正式发布的应用，只有白名单用户才会看到应用商店中的测试专区；6. 测试公司完成待测试内容的测试工作，将测试结果反馈给游戏基地；7. 游戏基地将测试结果反馈至业务合作伙伴；8. 游戏基地安排通过测试符合条件的游戏程序包上线，上线后相关游戏包将会在正式环境中发布，发布后所有内置平台的手机均可看到此应用。10. 附录附录A：游戏业务内容的上传游戏包规格游戏包统一采用.zip压缩文件，压缩包根目录下包括config.xls文件、entity目录、pic目录。Ø ZIP包命名规则：首测：XXXX年XX月品牌低端机游戏业务常规征集游戏首测包_游戏业务名称_合作伙伴名称.zip重测：XXXX年XX月品牌低端机游戏业务常规征集游戏重测包_游戏业务名称_合作伙伴名称.zip拓展：XXXX年XX月品牌低端机游戏业务常规征集游戏拓展包_游戏业务名称_合作伙伴名称.zipØ 下面是一个压缩包示例(双击打开)Ø 压缩前的文件目录如下从图中可以看出，游戏包内包含：config.xls, pic, entity文件及目录。config.xls是一个Excel格式的配置文件，它用于描述上传游戏包中的内容；pic文件夹用于存放游戏截图文件；entity存放游戏实体文件。config.xls文件功能说明：描述该游戏业务所包含的实体文件与机型组、运行客户端平台等的关系。格式：包含有entityFile、uagroup-entities两个工作表，示例如下：entityFiles实体描述工作表结构如下：字段名字段中文名示例字段详细描述serviceId业务代码01001118游戏实体所属游戏业务代码，它必须与选择上传游戏包的业务的业务代码一致。注：“必须”保证该字段的Excel单元格格式为文本，并且与游戏实体所属的业务代码一致。fileNames文件名Doraemon_K17.lav实体文件名；它还用于标识相同业务下的不同实体，以游戏英文名称+机型组标示构成；文件名禁止使用中文或其它特殊符号。clientPlatformCode客户端平台代码1000游戏业务使用客户端平台的代码devTech开发技术lav游戏实体的开发技术，如lav格式releaseDate发布日期2010-09-09日期格式为：yyyy-MM-dd；注：“必须”保证该字段的Excel单元格格式为文本。Version版本1.0.0.0priority优先级1数值型，数值大优先级高uagroup-entities实体描述工作表结构如下：字段名字段中文名示例字段详细描述uaGroup机型组名称L601系列机型组标识，应按机型组描写，如：L601系列，K17系列fileNames文件名Doraemon_L601.lav实体文件名；它还用于标识相同业务下的不同实体。实体文件夹目录文件夹有entity目录保存游戏实体文件。对游戏实体文件的命名应包含该游戏文件所适配的机型组名称，如Doraemon _K17.lav，如果一个游戏文件适配多个机型，也应该对该文件复制后按适配机型分别命名，在config文件中的fileNames应与文件夹中游戏文件的命名保持一致；针对一个机型的文件在整个zip包中只能有一个；针对一个游戏业务多次上传实体包，后上传新增的文件会被添加；与现存文件有重复时比较config文件中的releaseDate，如果发布时间较新则进行更新；系统不针对减少的文件对现存数据进行删除操作，删除操作要在管理平台由管理员手功处理完成。图片文件夹pic目录图片文件夹以pic命名。文件夹内共包含7个图片文件，一个游戏的菜单图标icon图片文件大小为24 x 24，格式必须为gif，名为icon.gif; 一个LOGO图片文件，大小为101x101，名为logo.jpg；以及5个介绍图片文件，分别为：pic_1.jpg, pic_2.jpg, pic_3.jpg, pic_4.jpg, pic_5.jpg，这五张图片大小也必须是101x101。另外，单个图片文件大小不能超过7K。图片文件夹内容示例如下： 游戏的图片以最后一次上传的实体包数据为准。附录B：状态码列表状态内码描述游戏客户端向用户展现的规范内容1001请求消息格式错误请求消息格式错误（状态码：1001）1002密码错误您的密码错误（状态码：1002）2001无法获取手机号无法获取您的手机号，请稍候再试（状态码：2001）2002手机号码所在号段在号段表中不存在您的手机号码无法使用本业务（状态码：2002）2003用户控制-禁止联通用户访问请使用中国移动手机号码使用本业务（状态码：2003）2004用户没有使用该业务的权限您没有使用本业务的权限（状态码：2004）2005用户是黑名单用户您的手机号码无法使用本业务（状态码：2005）2006业务代码错误业务代码错误（状态码：2006）2007该业务暂停服务本业务已经暂停服务，请使用其它业务（状态码：2007）2008业务未上线此业务未上线，敬请期待（状态码：2008）2009业务已下线此业务已下线（状态码：2009）2010业务不存在此业务不存在（状态码：2010）2011该业务不允许该机型的推广商推广该业务不允许该机型的推广商推广（状态码：2011）2012推广商状态无效推广商状态无效（状态码：2012）2013合作方的合作代码错误游戏提供商的合作代码错误（状态码：2013）2014合作方不存在游戏提供商不存在（状态码：2014）2015合作方已下线游戏提供商已下线（状态码：2015）2016机型代码错误机型代码错误（状态码：2016）2017菜单树不存在菜单树不存在（状态码：2017）2018菜单ID错误菜单ID错误（状态码：2018）2019计费代码错误计费代码错误（状态码：2019）2020扣费点数超过单次最大限额您的点数消费已经超出每次的最大限额（状态码：2020）2021扣费点数超过当日最大限额您的点数消费已经超出当日的最大限额（状态码：2021）2022扣费点数超过当月最大限额您的点数消费已经超出当月的最大限额（状态码：2022）2023该用户没有足够的点数余额您的点数余额不足（状态码：2023）3001版本不支持您的版本太低，请升级游戏大厅 (状态码:3001)3002网络异常系统繁忙,现在无法使用,请您稍后再试(状态码:3002)3003系统繁忙系统繁忙,现在无法使用,请您稍后再试(状态码:3003)3004系统异常，并不可用系统繁忙,现在无法使用,请您稍后再试(状态码:3004)3005网络异常，比如远程链接失败，响应超时系统繁忙,现在无法使用,请您稍后再试(状态码:3005)3006数据库错误，比如链接异常，约束违例系统繁忙,现在无法使用,请您稍后再试(状态码:3006)3007服务器响应超时系统繁忙,现在无法使用,请您稍后再试(状态码:3007)