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

游戏业务平台合作方开发规范-品牌低端机业务分册（试行） - 中国移动 游戏业务平台合作方开发规范 -品牌低端机业务分册(试行) Game Development Specification of Game Master Platform 目 录 1. 范围........................................................................................................................................... 1 2. 修订历史................................................................................................................................... 1 3. 规范性引用文件 ....................................................................................................................... 1 4. 术语、定义和缩略语 ............................................................................................................... 2 5. 业务概述................................................................................................................................... 2 5.1. 业务概念 ....................................................................................................................... 2 5.2. 业务开放范围 ............................................................................................................... 2 5.3. 业务类型 ....................................................................................................................... 2 5.3.1. 按使用方式分类 ............................................................................................... 2 5.3.2. 按计费方式分类 ............................................................................................... 3 5.3.3. 按用户消费方式分类 ....................................................................................... 3 6. 游戏界面要求 ........................................................................................................................... 3 6.1. 应用界面设计基本原则 ............................................................................................... 4 6.2. 游戏激活界面设计 ................................................................... 错误～未定义书签。4 6.3. 应用界面文字格式要求 ............................................................................................... 4 6.4. 计费要求 ....................................................................................................................... 3 6.4.1. 计费接口调用 ................................................................................................... 3 7. 申报、评审、测试、上线流程 ............................................................................................... 5 7.1. 总体流程 ....................................................................................................................... 5 7.2. 流程 ....................................................................................................................... 6 8. 品牌低端机测试流程 ............................................................................................................... 7 8.1. 业务合作伙伴内部测试 ............................................................................................... 7 8.1.1. 流程图 ............................................................................................................... 8 8.1.2. 内部测试流程 ................................................................................................... 8 8.2. 业务评审 ....................................................................................................................... 9 8.2.1. 流程图 ............................................................................................................. 10 8.2.2. 流程说明 ......................................................................................................... 10 8.3. 正式环境测试阶段 ..................................................................................................... 10 8.3.1. 流程图 ............................................................................................................. 11 8.3.2. 流程说明 ......................................................................................................... 11 9. 附录......................................................................................................................................... 12 附录A:内容上传 ................................................................................................................. 12 附录B:状态码列表 ............................................................................................................. 15 I 前 言 本规范规定了中国移动游戏业务平台与其上运营的游戏间的开发接口及相关，是各游戏开发商开发游戏的依据，以满足游戏业务平台的要求。 本规范主要包括以下几方面内容: 业务概述、游戏界面要求、数据类型和接口要求等。 本规范由中移 号文件印发。 本规范由中国移动通信有限公司技术部提出并归口。 本规范由中国移动通信有限公司技术部负责解释，具体细节由中国移动通信有限公司负责解释。 本规范起草单位:中国移动通信有限公司手机游戏基地 本规范主要起草人: II 1. 范围 本规范规定了中国移动品牌低端机游戏平台上的游戏开发规范，供各游戏CP/SP在开发游戏时使用。 2. 修订历史 时间 内容 版本号 作者 2010-9-28 1.0.0 3. 规范性引用文件 下列规范所包含的条文，通过在本规范中引用而成为本规范的条文。本规范出版时，所示版本均为有效。所有规范都会被修订，使用本规范的各方应探讨使用下列规范最新版本的可能性。 [1] ELF 可执行链接文件格式，可执行链接文件格式是UNIX系统实验室(USL)作为应用 程序二进制接口(Application Binary Interface(ABI)而开发和发布的。工具接口规范委员 会(TIS)现在了可在发展中的ELF规范作为工作在32位体系上不同操作系统之间的二 进制文件格式。 [2] RFC1867 Form-based File Upload in HTML [3] RFC1945 Hypertext Transfer Protocol -- HTTP/1.0 [4] RFC2068 Hypertext Transfer Protocol -- HTTP/1.1 [5] RFC2616 Hypertext Transfer Protocol -- HTTP/1.1 断点续传 1 4. 术语、定义和缩略语 下列术语、定义和缩略语适用于本规范: 词语 解释 OTA Over The Air, 即空中、无线方式 HTTP Hyper Text Transfer Protocol，超文本传输协议 XML eXtensible Markup Language，可扩展标记语言 SOAP Simple Object Access Protocol，简单对象访问协议 CP Content Provider，内容提供商 SP Service Provider，服务提供商 CMGP 游戏业务平台 业务网元 指www portal、 wap portal、 网游服务器等 CDC Connected Device Configuration，连接设备配置 CLDC ConnectedLimitedDeviceConfiguration，连接限制设备配置 MIDP MobileInformationDevicesProfile，移动信息设备表 MD5 Message Digest Algorithm，信息摘要算法 5. 业务概述 5.1. 业务概念 品牌低端机游戏业务平台是统一接入中国移动游戏业务的平台，通过与各类门户等外围系统进行业务交互，提供内容管理、营销管理、点数管理、统计分析等能力给外围设备开展游戏类业务。 5.2. 业务开放范围 本业务向能够通过GPRS、3G网络接入到中国移动的手机用户开放。 所有游戏计费均通过中间件或虚拟机计费接口访问品牌低端机游戏业务平台来进行计费。 对于联网游戏，均需通过中间件或虚拟机平台，且必须使用CMWAP联网。 5.3. 业务类型 5.3.1. 按使用方式分类 , 单机游戏:在使用过程中通常不需要通过移动网络与游戏网络服务器或其他客户端发生 2 互动的游戏叫单机游戏，仅触发联网进行下载、激活、计费、上传积分等游戏属于单机 游戏。 , 手机网游:在使用过程中需要通过移动网络与游戏网络服务器或其他客户发生互动的游 戏叫手机网游，但不包括仅用联网实现激活、上传积分等功能的游戏。 5.3.2. 按计费方式分类 游戏业务平台上的游戏计费包含流量费和信息费，本分类方式只基于信息费。依据信息费，可分为下载计费、激活计费和道具计费两种: , 下载计费:指在软件商店触发游戏下载并下载成功时触发的计费。 a) 下载之前显示扣费提示，在用户下载成功后自动触发的计费; b) 多次重复下载可以根据服务器规则，设定为重复收费和一次性收费; , 激活计费:指用户激活游戏的特殊关卡或使用游戏复活操作时触发的计费。 a) 激活的关卡可以设定成一次性激活和多次激活; b) 游戏复活操作，每次复活单独计费; , 道具计费:指用户使用游戏的特殊道具时触发的计费。 a) 道具计费设定成一次性计费和多次计费; b) 网游的道具计费直接在网游服务器进行计费，单机游戏通过平台发起计费; 5.3.3. 按用户消费方式分类 5.3.3.1. 话费消费方式 指用户下载或激活游戏及购买游戏道具时，所需费用直接从用户的手机话费中扣除。 6. 中间件游戏业务的计费 6.1. 计费要求 6.1.1. 计费接口调用 内容开发商根据《平台开发手册》的计费接口，提供相关应用ID，计费点ID，即可完成计费接口调用。对于计费过程中，计费信息提示，计费过程处理，统一由中间件或虚拟机平台负责完成。 品牌低端机游戏平台计费接口调用说明: 1:申请计费 3 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. 应用界面文字格式要求 对于在游戏大厅中显示的应用程序名称，所有可以用中文表示的文件名，必须用中文表示，以便于用户在游戏大厅内查找已下载的应用; 对于游戏程序内向用户呈现的显示界面，所有可以用中文表示的内容，必须用中文 表示;要求能在游戏所支持的手机上正确显示;此中文显示要求包括各菜单选项， 帮助信息，指示信息。 4 8. 游戏业务申报、评审、测试、上线流程 8.1. 总体流程 5 国产品牌机单机游戏申报-评审-测试-上线流程 游戏基地内容合作伙伴平台提供商测试公司相关文档 国产品牌机单邮件方式提交机游戏业务分申报材料册 组织评审并发配合评审游戏国产品牌机游布评审结果包的安装运行戏业务测试 创建局数据并同步到国产品牌机游戏平台 提供移植和内游戏包移植并部测试技术支进行内部测试持 提交测试通过的游戏包 委托测试公司游戏测试进行测试 将测试通过的游戏反馈给游戏基地 测试结果通知合作伙伴 符合条件的游戏包安排上线 流程结束 8.2. 流程说明 对于品牌低端机申报、评审、测试、上线相关流程说明如下: 1. 游戏业务合作伙伴根据《品牌低端机单机游戏业务分册(试行)》的要求以邮件方 6 式将完成评审版本内测的游戏程序包进行游戏业务的申报; 2. 游戏基地收到游戏业务合作伙伴的申报后，组织评审。使得游戏业务合作伙伴提交 的游戏程序包具备在单机环境下正常运行的条件; 3. 评审完毕后，游戏基地通过内部工单系统对通过评审的业务制作局数据，并同步到 品牌低端机运营平台; 4. 游戏业务合作伙伴对通过评审的游戏业务进行机型移植和内部测试，在机型移植和 内部测试过程中如遇到平台相关问题可以要求平台提供商提供相关技术支持; 5. 游戏业务合作伙伴将完成机型移植和内部测试的游戏程序包按照游戏基地的要求 提交至游戏基地; 6. 游戏基地收到游戏业务合作伙伴的测试申请后，根据测试管理办法安排外包测试公 司对游戏程序包进行测试; 7. 测试公司在对游戏程序包的测试过程中，如遇到平台相关问题可以要求平台提供商 提供相关技术支持; 8. 测试公司完成对游戏程序包的测试后，将测试结果反馈到游戏基地; 9. 游戏基地将测试结果反馈至游戏业务合作伙伴; 10. 游戏基地安排通过测试符合条件的游戏程序包上线; 11. 游戏程序包上线后，整个流程结束。 9. 品牌低端机测试流程 9.1. 业务合作伙伴内部测试 新的应用在业务申报前，业务合作伙伴需要在开发调试环境对该应用进行内部测试，内 部测试达标以后，方可提交应用版本进行业务申报。 7 9.1.1. 流程图 国产品牌机单机游戏合作伙伴内部测试流程 游戏基地内容合作伙伴平台提供商测试公司相关文档 购买内置国产国产品牌机游品牌机游戏中IDE开发环境戏平台游戏开间件的手机发规范 更新为开发调国产品牌机单开发调试认证试版应用商店机游戏业务分工具册 国产品牌机游应用开发开发调试版戏业务测试管应用商店理办法 应用认证签名 应用部署到测试终端 测试修改应用测试数据 应用归档 业务申报 9.1.2. 内部测试流程 1. 准备阶段 , 平台提供商向业务合作伙伴提供IDE开发环境 , 平台提供商向业务合作伙伴提供开发调试认证工具 , 平台提供商向业务合作伙伴提供开发调试版软件商店 , 开发调试版本会配置基本的通用数据并公开给业务合作伙伴 8 2. 业务合作伙伴内部测试流程 1) 业务合作伙伴自行购买已经内置平台提供商正式版本大厅的品牌低端机; 2) 业务合作伙伴通过USB数据线将平台提供商提供的开发调试版应用商店替换 文件拷贝到手机内，替换原手机内的正式版本应用商店; 注:开发调试版本大厅只包含我的游戏、游戏安装2个选项，供业务合作伙 伴开发调试。 3) 业务合作伙伴根据合作方开发规范进行应用开发; 4) 业务合作伙伴通过平台提供商提供的开发调试认证工具对应用进行认证签名; 注:通过开发调试认证工具进行签名的应用仅可在开发调试版应用商店中运 行。 5) 业务合作伙伴拷贝应用到已替换为开发调试版应用商店的手机目录下，直接可 进行安装; 6) 业务合作伙伴利用平台提供商提供的通用数据在开发调试环境对应用进行内 部测试; 7) 业务合作伙伴完成测试对应用进行内部归档; 8) 业务合作伙伴对归档后的应用进行业务申报。 9.2. 业务评审 在业务评审阶段，将在开发调试版应用商店中对应用进行评审测试，开发调试版应用商 店连接的平台非正式平台，为测试平台。 9 9.2.1. 流程图 国产品牌机单机游戏申报-评审流程 游戏基地内容合作伙伴平台提供商测试公司相关文档 国产品牌机单邮件方式提交机游戏业务分申报材料册 审核业务合作国产品牌机游伙伴申报材料戏业务测试管理办法 评审游戏包运行环境准备 组织评审 评审结果发布 流程结束 9.2.2. 流程说明 1. 业务合作伙伴通过邮件方式进行业务申报; 2. 游戏基地接受业务合作伙伴的申报资料并进行审核; 3. 平台提供商为游戏基地评审业务包进行运行环境准备，包括开发调试版应用商店 安装等;该评审终端需已经内置了平台提供商的平台; 4. 基地将业务合作伙伴送评的游戏业务包拷贝到评审终端上，进行测试评审; 5. 基地根据各申报游戏业务包的评审情况发布评审结果。 9.3. 正式环境测试阶段 正式环境测试则连接到正式平台，提交到正式环境测试的应用只可以在加入到白名单的 10 手机上通过手机平台看到，其余非白名单用户无法看到正式环境下正在进行测试的应用。 9.3.1. 流程图 国产品牌机单机游戏测试-上线流程 游戏基地内容合作伙伴平台提供商测试公司相关文档 国产品牌机单提交测试申请机游戏业务分材料册 国产品牌机游审核测试材料戏业务测试管理办法 生产环境认证 测试程序包部署，测试白名单设置 游戏测试 将测试通过的游戏反馈给游戏基地 测试结果通知合作伙伴 符合条件的游戏包安排上线 流程结束 9.3.2. 流程说明 1. 业务合作伙伴提交测试申请，及相关资料; 11 2. 游戏基地接收相关测试申请，并进行审核; 3. 游戏基地对于测试游戏包进行生产环境认证; 4. 游戏基地将测试游戏包部署到生产环境的测试专区;并将测试公司使用的测试手 机设置进白名单; 5. 测试公司按照基地的要求，对于应用商店中测试专区中的各项测试内容进行测试; 测试专区将会看到提交到正是环境进行测试但是非正式发布的应用，只有白名单 用户才会看到应用商店中的测试专区; 6. 测试公司完成待测试内容的测试工作，将测试结果反馈给游戏基地; 7. 游戏基地将测试结果反馈至业务合作伙伴; 8. 游戏基地安排通过测试符合条件的游戏程序包上线，上线后相关游戏包将会在正 式环境中发布，发布后所有内置平台的手机均可看到此应用。 10. 附录 附录A:游戏业务内容的上传 游戏包规格 游戏包统一采用.zip压缩文件，压缩包根目录下包括config.xls文件、entity目录、pic目录。 , ZIP包命名规则: 首测:XXXX年XX月品牌低端机游戏业务常规征集游戏首测包_游戏业务名称_合作伙伴名称.zip 重测:XXXX年XX月品牌低端机游戏业务常规征集游戏重测包_游戏业务名称_合作伙伴名称.zip 拓展:XXXX年XX月品牌低端机游戏业务常规征集游戏拓展包_游戏业务名称_合作伙伴名称.zip , 下面是一个压缩包示例(双击打开) , 压缩前的文件目录如下 12 从图中可以看出，游戏包内包含:config.xls, pic, entity文件及目录。config.xls是一个Excel格式的配置文件，它用于描述上传游戏包中的内容;pic文件夹用于存放游戏截图文件;entity存放游戏实体文件。 config.xls文件 功能说明:描述该游戏业务所包含的实体文件与机型组、运行客户端平台等的关系。 格式:包含有entityFile、uagroup-entities两个工作表，示例如下: entityFiles实体描述工作表结构如下: 字段名 字段中文名 示例 字段详细描述 serviceId 01001118 业务代码 游戏实体所属游戏业务代码，它必须 与选择上传游戏包的业务的业务代 码一致。注:“必须”保证该字段的 Excel单元格格式为文本，并且与游 戏实体所属的业务代码一致。 fileNames Doraemon_K17文件名 实体文件名;它还用于标识相同业务 .lav 下的不同实体，以游戏英文名称+机 型组标示构成;文件名禁止使用中文 或其它特殊符号。 clientPlatformC1000 客户端平台代游戏业务使用客户端平台的代码 13 ode 码 devTech lav 开发技术 游戏实体的开发技术，如lav格式 releaseDate 2010-09-09 发布日期 日期格式为:yyyy-MM-dd;注:“必 须”保证该字段的Excel单元格格式 为文本。 Version 1.0.0.0 版本 priority 1 优先级 数值型，数值大优先级高 uagroup-entities实体描述工作表结构如下: 字段名 字段中文名 示例 字段详细描述 uaGroup 机型组名称 L601系列 机型组标识，应按机型组描写，如: L601系列，K17系列„„ fileNames Doraemon_L60文件名 实体文件名;它还用于标识相同业务 1.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，这五张图片大 14 小也必须是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) 15 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) 16 17