《游戏业务平台合作方开发规范v200.docx》由会员分享，可在线阅读，更多相关《游戏业务平台合作方开发规范v200.docx（96页珍藏版）》请在三一办公上搜索。
1、 中国移动通信企业标准QB-游戏业务平台合作方开发规范Game Development Specification of Game Master Platform 版本号：2.0.0 -实施-发布中国移动通信有限公司 发布目录1.范围12.修订历史13.规范性引用文件34.术语、定义和缩略语45.业务概述55.1.业务概念55.2.业务开放范围55.3.业务类型55.3.1.按使用方式分类55.3.2.按计费方式分类65.3.3.按用户消费方式分类66.游戏界面要求:76.1.应用界面设计基本原则76.2.游戏业务平台相关接口调用的入口说明76.2.1.游戏点数充值（限网络游戏）：76.2.2
2、.游戏点数消费（限网络游戏）：76.2.3.游戏点数余额及明细查询（限网络游戏）86.3.游戏激活界面设计96.3.1.话费计费: 用话费消费完整版游戏(下载免费，一次激活终身使用)96.3.2.点数计费: 用点数灵活消费游戏内关卡，道具等(下载免费，道具收费，关卡收费，特殊功能收费)96.4.应用界面文字格式要求106.5.短信计费业务订购页面要求107.数据类型107.1.基本类型107.2.复合类型117.3.状态码117.4.系统级错误代码128.接口要求128.1.客户端单机128.1.1.描述128.1.2.客户端单机试玩转激活138.1.3.单机游戏购买道具168.2.WAP单机
3、188.2.1.描述188.2.2.地址解释188.2.3.WAP单机业务代理188.2.4.购买WAP单机业务208.3.客户端网游228.3.1.描述228.3.2.登录手机网游228.3.3.用户充值268.3.4.网游购买道具298.3.5.查询剩余点数338.3.6.查询充值记录368.3.7.查询消费历史记录398.3.8.登出网游448.3.9.更新网游Session时间468.4.WAP网游468.4.1.描述478.4.2.登录WAP网游478.4.3.购买网游道具508.4.4.登出网游508.4.5.更新登陆网游的Session508.5.游戏业务包508.5.1.描述5
4、08.5.2.订购游戏业务包518.6.用户点卡帐户528.6.1.描述528.6.2.用户充值538.6.3.查询剩余点数558.6.4.查询充值记录588.6.5.查询消费历史记录628.7.单机游戏下载后触发计费678.7.1.描述678.7.2.处理流程688.7.3.说明688.8.短信计费698.8.1.描述698.8.2.处理流程698.8.3.短信格式698.8.4.长号码708.8.5.短信示例708.8.5.1.客户端单机业务（一个计费点）708.8.5.2.客户端单机业务（多个计费点）708.8.5.3.客户端网游业务（多个计费点）718.8.6.短信购买道具结果通知接口
5、718.8.6.1.描述718.8.6.2.处理流程728.8.6.3.接口地址729.附录74附录A：内容上传74附录B：WAP 网关与联网服务器的接口77附录C：状态码列表（包括错误代码）77附录D：业务接入申请表85附录E：充值代码列表87附录F：J2ME客户端JAD文件规范90前言本标准规定了中国移动游戏业务平台与其上运营的游戏间的开发接口及相关协议，是各游戏开发商开发游戏的依据，以满足游戏业务平台的要求。本标准主要包括以下几方面内容： 业务概述、游戏界面要求、数据类型和接口要求等。本标准由中移 号文件印发。本标准由中国移动通信有限公司技术部提出并归口。本标准由中国移动通信有限公司技术
6、部负责解释，具体细节由中国移动通信有限公司研究院负责解释。本标准起草单位：中国移动通信研究院本标准主要起草人： 何彬1. 范围本标准规定了中国移动游戏业务平台上的游戏开发规范，供各游戏CP/SP在开发游戏时使用。.2. 修订历史时间内容版本号作者2008-5-22添加WAP代理接口描述及WAP参数透传说明1.1.1卢伟勤2008-5-23完善网游相关接口的文档1.1.2卢伟勤2008-5-27增加附录C、附录D、附录E增加接口流程图1.2.0梁秋实2008-6-3修订 A） 附录A：内容上传 实体包格式B） 附录B：WAP 网关与联网服务器的接口1.2.1梁秋实2008-6-16增加客户端单机
7、游戏购买道具类业务1.2.2刘景岩2008-7-9修订充值渠道代码以及完善打包规范1.2.4梁秋实2008-8-18状态码列表补充，增加错误码1304，1305，1306，1307，13081.2.5甘竹芳2008-8-26状态码列表补充，增加错误码2210，2211，2213，2214（为门户提供的PortalQuery接口所使用的状态码）1.2.6甘竹芳2008-9-19增加“8.7单机游戏下载后触发计费”章节的内容增加附录F：J2ME客户端JAD文件规范1.2.7梁秋实2008-11-7新增“短信计费”功能，支持客户端单机短信激活计费、客户端单机试玩转激活业务和客户端网游道具业务（参见8
8、.8短信计费）。1.2.8梁秋实2008-11-12增加状态码：1802,1310,1401,1402,1403,398,399；修订202状态码含义；参见附录C。增加51元100元充值代码的定义，参见附录E。1.2.8梁秋实2008-11-13增加：6.5.短信计费业务订购页面要求。1.2.8李倩2008-12-30修订接口URL错误:8.1.1.2.输入参数 增加”/bizcontrol”8.4.1.3.接口地址 增加”/bizcontrol”8.6.1.3.接口地址 增加”/bizcontrol”1.2.9梁秋实2009-01-16修订点数计费业务价格说明与用户点数余额不足不需要向用户提
9、示余额不足信息1.2.10刘景岩2009-01-19增加“8.8.6. 短信购买道具结果通知接口”和“8.5.3.7. 同步计费结果” 的内容1.2.10梁秋实2009-02-058.2.3消费wap单机业务添加代理 8.2.3.3返回值修改 “注 1”1.2.10李鹏2009-2-9对于网游类业务，增加用户登录的Session有效期，当前设置为240分钟。针对客户端网游和wap网游，报文中增加transIDO 和 versionId节点,涉及8.4.2至8.4.6、8.6.2至8.6.6添加登出网游接口,涉及8.4.7、8.6.7添加更新登录网游的Session时间接口，涉及8.4.8、8.
10、6.8网游充值接口响应报文中增加balance节点网游购买道具接口响应报文中增加balance、point节点1.3.0李强2009-2-23对1.30版本新增接口及修改部分进行整理本次版本修改涉及部分包括：1. 单机游戏关于fid的修改，详见8.1，登录客户端网游关于fid的修改，详见8.4.1网游购买道具接口关于fid的修改详见8.4.32. Wap单机业务计费后由原有重定向方式改为代理方式请求到sp服务器,详见8.2.3.33. 网游类业务，增加用户登录的Session有效期，当前设置为240分钟4. 报文中增加transIDO 和 versionId节点,涉及8.4.2至8.4.6、8
11、.6.2至8.6.65. 添加登出网游接口,涉及8.4.7、8.6.76. 网游充值接口响应报文中增加balance节点,详见8.5.27. 添加更新登录网游的Session时间接口，涉及8.4.8、8.6.88. 从合作方服务器发起的“购买道具”和“充值”完成后，会更新Session的有效期，顺延240分钟9. 网游购买道具接口响应报文中增加balance、point节点,详见8.4.310. 关于查询消费历史记录报文及查询条件内容的修改，详见8.91.3.0关少杰2009-2-24修订8.6.1.5用户登录Wap网游的接口，用户登录成功后会在跳转地址后面增加userId和key参数。1.3
12、.0梁秋实2009-2-26修订8.6.1用户登录Wap网游接口，登录成功后把cpId,cpServiceId,channelId和p透传下去。1.3.0李鹏2009-3-10修订6.1及6.2中应用界面设计原则及点数相关界面要求1.3.0刘鹤2009-4-23修订一些文档错误1.3.1李强2009-11-121. 5.3.2 节: 删除按月计费的描述2. 5.3.3.1节: 增加自动充值描述3. 7.2节: 删除冗余举例说明4. 8.4.6节: 查询消费历史记录5. 附录E: 去掉固定字段Cpid6. 去掉附录G7. 修正文档格式1.4.0李强张江南2009-11-171 修正格式及编排2
13、名称统一为”游戏业务平台”1.4.1张江南2009-12-4修改内容如下: 1. 文档所有内容以2009-12-1现网上的部署为准2.增加完善”术语,定义,缩略语”的内容3.对5.3.进行完善和补充4.对接口要求目录结构及顺序从新整理,并修改5.增加相关章节报文示例6.统一版本2.0.02.0.0张江南3. 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。1游戏业务平台总体技术
14、要求规范V2.0中国移动通信有限公司1游戏业务平台设备规范V2.0中国移动通信有限公司2游戏业务平台接口规范V2.0中国移动通信有限公司3游戏业务平台业务规范V2.0中国移动通信有限公司4超文本传送协议（Hypertext Transfer Protocol） - HTTP/1.1-RFC 26165SOAP 协议 V1.16SOAP 协议 V1.27HTTP鉴权(HTTP Authentication: Basic and Digest Access Authentication)-RFC26174. 术语、定义和缩略语下列术语、定义和缩略语适用n 游戏业务平台总体技术规范n 游戏业务平台设
15、备规范n 游戏业务平台接口规范n 游戏业务平台业务规范定义一:词语解释OTAOver The Air, 即空中、无线方式HTTPHyper Text Transfer Protocol，超文本传输协议XMLeXtensible Markup Language 可扩展标记语言SOAPSimple Object Access Protocol 简单对象访问协议CPContent Provider内容提供商SPService Provider 服务提供商CMGP游戏业务平台业务网元(网元,网元编号)标示www portal、 wap portal、 网游服务器等定义二:词语解释游戏业务平台游戏业务平
16、台是统一接入中国移动游戏业务的平台，通过与各类门户等外围系统进行业务交互，提供内容管理、营销管理、点数管理、统计分析等能力，给外围设备开展游戏类业务。客户端单机仅触发联网进行激活、计费、上传积分, 在使用过程中不需要通过移动网络与游戏网络服务器或其他客户端发生互动的游戏。客户端网游在使用过程中需要通过移动网络与游戏网络服务器或其他客户发生互动的游戏叫手机网游，但不包括仅用联网实现激活、上传积分等功能的游戏。图文游戏即Wap游戏，不需要下载客户端。包括Wap单机和Wap网游。Wap单机指按进入游戏次数收取用户费用的图文游戏，即按次计费的图文游戏。Wap网游指使用游戏免费，在游戏中需购买道具计费的
17、图文游戏单机泛指客户端单机和Wap单机网游泛指客户端网游和Wap网游按次计费包括用户激活游戏时计费,用户播放游戏时计费，用户下载游戏时计费包月计费用户订购后即可使用业务一个自然月,如果用户不退订，则月底系统为用户自动续订。点数游戏业务平台中进行各种交易的通用货币点数消费游戏业务平台中消耗用户点数的各种交易话费消费游戏业务平台中消耗用户话费的各种交易充值(点数充值)将话费转换为点数，一元 = 100点5. 业务概述 5.1. 业务概念 游戏业务平台是统一接入中国移动游戏业务的平台，通过与各类门户等外围系统进行业务交互，提供内容管理、营销管理、点数管理、统计分析等能力，给外围设备开展游戏类业务。5
18、.2. 业务开放范围 本业务向能够通过GPRS、3G网络接入到中国移动的手机用户开放。游戏业务平台所有业务计费以及联网游戏运行，均必须使用CMWAP联网；游戏业务平台合作方开发的客户端应用程序须对未选择CMWAP联网的用户进行友好提示。游戏业务平台客户端业务可以是由J2ME、Symbian、Windows Mobile、Mophun、C+等语言开发。5.3. 业务类型 5.3.1. 按使用方式分类l 客户端单机：仅触发联网进行激活、计费、上传积分, 在使用过程中不需要通过移动网络与游戏网络服务器或其他客户端发生互动的游戏。单机游戏包括但不限于单机java和单机symbian游戏。l 客户端网游
19、：在使用过程中需要通过移动网络与游戏网络服务器或其他客户发生互动的游戏叫手机网游，但不包括仅用联网实现激活、上传积分等功能的游戏。l 图文游戏：即WAP游戏，为不需下载客户端而直接联网使用的游戏。游戏业务平台将图文游戏分为两类：WAP单机：指按进入游戏次数收取用户费用的图文游戏，即按次计费的图文游戏。WAP网游：指使用游戏免费，在游戏中需购买道具计费的图文游戏。游戏业务平台可为图文游戏中的道具提供计费。5.3.2. 按计费方式分类游戏业务平台上的游戏计费包含流量费和信息费，本分类方式只基于信息费。依据信息费，可分为按次计费和包月计费两种：l 按次计费：指按照成功下载次数或按成功激活次数收取费用
20、的方式。a)按次游戏不需要退订；b)按次游戏可以设计为下载计费也可以为激活计费,或网游购买道具计费，短信够购买道具。l 包月计费：目前包月计费方式即订购套餐包。订购套餐后，退定下月生效。如果没有退定，月底则自动续订套餐。 5.3.3. 按用户消费方式分类5.3.3.1. 点数消费方式客户端网游或Wap网游进行购买道具消费的时候消耗用户点数余额。Wap单机和客户端单机购买道具类业务也可以有点数支付的方式。当用户购买手机网游的道具或Wap网游时，如果游戏点数余额满足定价要求，则从用户游戏帐户中扣除，产生点数消耗。如果用户点卡帐户上面点数不足，则会对用户进行自动充值。平台将依据点数消耗的实际情况与S
21、P进行分帐。点数消费适用于不限定计费频次、不限定计费点触发时间的业务，网游购买道具和Wap网游一般采取点数计费的方式。游戏业务平台还可以提供同一业务多次点数支付计费，用户在使用此类业务时可以先在游戏业务平台的用户帐户中充值。如果帐户中的点数余额不足，游戏业务平台支持自动充值。并将充值金额从话费中扣除。5.3.3.2. 话费消费方式指用户下载或激活游戏时，所需费用直接从用户的手机话费中扣除。用户充值(话费转换为点数)，订购套餐，客户端单机，Wap单机都属于话费消费方式。6. 游戏界面要求:6.1. 应用界面设计基本原则A) 游戏CP/SP开发的客户端应用程序的操作界面必须与手机已有功能的操作习惯
22、一致；游戏程序启动界面必须使用中国移动指定的统一标识，游戏LOGO必须按照中国移动手机游戏标识使用规范.pdf制作，LOGO展现必须符合规范内容，不应出现必要LOGO内容的缺失或不必要LOGO内容的增添，当SP与CP是同一厂商时，即SP与CP的LOGO一致时，静态LOGO图片则应只展现一次该LOGO，动态图片则应在其中一个LOGO的位置放置该游戏的游戏LOGO，以避免重复。B) 如果游戏本身没有任何音乐音效，游戏标识中的音效开关这一屏可以去掉，游戏标识本身的LOGO滚动音效也可以去掉；客户端网游类业务的游戏标识不显示游戏星级评定。C) 游戏主菜单界面必须有一个“更多游戏”的选项指向中国移动指定
23、的WAP链接，链接地址为： 三星D508和D608系列的机型可不显示“更多游戏”，在游戏退出时也可以不弹出指向游戏频道的界面指引。D) 所有游戏必须按照附录C，根据相关状态码向用户提示规范用语。6.2. 游戏业务平台相关接口调用的入口说明6.2.1. 游戏点数充值（限网络游戏）：A）在游戏的主菜单界面，必须有“点数专区”入口（点数专区内容详见点数专区界面设计规范V1.0；B）在游戏界面，必须有至少一处的明显位置为“游戏点数”的充值和余额查询入口；C）在“游戏点数”充值界面，必须有“游戏点数”介绍说明和“游戏点数”充值的帮助信息；D) 在游戏中所有“游戏点数”充值界面，在用户可选的充值额度后面必
24、须明确标注话费单位：（元），不应只有充值数值而没有单位，如应注明：1元100元。6.2.2. 游戏点数消费（限网络游戏）：A）在应用（游戏）的游戏界面，必须有至少一处的明显位置为“游戏点数”消费的入口；B）在“游戏点数”消费界面，必须显示与上报业务局数据一致的资费说明；C）在“游戏点数”消费界面，必须有“游戏点数”介绍说明和“游戏点数”消费的帮助信息, 在“游戏点数”消费界面的明显位置，必须有“100点等同于1元人民币，点数余额不足时购买道具将会用话费自动充值补足点数）。D）在道具资费说明中，必须写明价格为“XX点（等同于YY元人民币）”，XX代表道具的点数价格，YY代表道具的人民币价格，点数
25、和人民币元的比例关系为100：1；例如：道具名称为“刀”，价格需写明为“需200点（等同于2元人民币）”E）游戏中的点数不得换成其他任何货币概念，统称为点数，游戏道具价格标识中必须明确标识价格单位；F）游戏中的点数不得与游戏中的其他任何虚拟货币相互兑换，游戏中的点数所能购买的道具不得使用游戏中的其他任何虚拟货币购买；G）游戏中的道具价格必须标识在查看道具的明显位置，例如显示在道具图标的正上、下、左、右方，或点击道具图标后弹出的第一屏道具信息中，不得隐蔽或隐藏道具价格；6.2.3. 游戏点数余额及明细查询（限网络游戏）A）在“游戏点数”充值和“游戏点数”消费界面必须显示游戏点数余额；B）在游戏的
26、界面，必须有至少一处的明显位置为“游戏点数”余额及明细查询的入口C）在游戏界面中，必须有至少一处的明显位置为“购买物品（道具）”查询的入口，用户可以查询该游戏的所有购买物品或道具的明细，包括物品（道具）的名称，购买时间和所消耗的游戏点数。D）在“游戏点数”余额及明细查询界面，用户可以查询购买点数的详细记录和消费点数的详细记录，详细记录按照消费时间倒序排列（即时间较近的记录排列在前，时间较远的记录排列在后）E）在“游戏点数”余额查询界面，必须有“游戏点数”介绍说明和“游戏点数”余额查询的帮助信息。帮助信息如下：1、游戏点数：游戏点数是移动梦网游戏频道的为用户提供的一种游戏支付方式，用户可以使用账
27、户中的点数来购买游戏或消费游戏道具。2、点数充值：每个用户在移动梦网游戏频道都有自己的账户，用户可以通过话费购买点数的方式给自己的账户充值，1元话费可购买100点点数，单次充值上限100元，即1000点。每日充值上限100元，即1000点。每月充值上限1000元即10000点。3、点数账户：每个用户的手机号码在移动梦网游戏频道都有一个固定的点数账户，用户可以使用账户内的点数购买游戏和在不同的游戏中购买道具，点数账户并不是用户在某款游戏中的游戏账户。 F）游戏点数消费和充值记录查询界面中应包含的内容：1、充值记录查询和点数消费记录查询应该提供用户可选时间范围2、点数消费界面应显示：消费时间、道具
28、名称、道具数量、消费金额3、点数消费记录只显示用户在本游戏中的消费记录消费记录4、充值记录查询应显示全平台充值记录，包括其他渠道的充值记录，充值界面应显示：充值时间、充值渠道、充值金额5、游戏中点数道具消费项，应明确告知用户道具名称，道具价格，以及确定购买按钮（参见6.2.2中的相关说明）。游戏业务平台已经实现当用户购买道具或业务其点数余额不足时，平台自动为用户将相应话费转换成为该道具或业务所需相应点数并直接进行购买，所以当用户余额不足时不应再弹出“点数余额不足，请充值”的提示，而应该将用户购买请求直接转发游戏业务平台进行处理6.3. 游戏激活界面设计除游戏业务平台配置并生效了局数据的计费点外
29、，游戏中一律不得出现其他平台代计费点（例如短信、WAP代计费等）。话费消费和点数消费的方式不能同时存在于一个游戏中。按不同用户的消费方式分类，不同的激活界面设计要求如下：6.3.1. 话费计费: 用话费消费完整版游戏(下载免费，一次激活终身使用)1、激活界面必须设计在主菜单之前，游戏标识（LOGO）之后，如果游戏设计了开场图文或动画展示，则可以把开场图文或动画展示放置在激活界面之前。2、在开始游戏正常进行5分钟内必须可测试到激活点3、激活提示语必须包括以下信息：游戏名称、游戏价格、一次激活终身使用、需要使用CMWAP 联网、如您曾激活过本游戏则此次激活不扣费。对于部分在JAVA连网设置中默认使
30、用代理,三星手机（如D508D608）应做额外处理，当用户激活失败时应提示用户关闭JAVA联网设置中的代理。1300状态激活成功后应显示以下信息：提示激活成功，告知扣费金额。1301状态激活成功(已经存在订购关系,正常返回)后应显示以下信息：提示激活成功，告知用户并未扣费。6.3.2. 点数计费: 用点数灵活消费游戏内关卡，道具等(下载免费，道具收费，关卡收费，特殊功能收费)1、在满足规定的情况下, 消费点可设置在游戏进行的任意阶段（消费点设置相关规定请参见游戏频道暂行管理规范V2.0），但在游戏开始后正常进行10分钟内必须可测试到至少一个消费点；2、具备6.2节所有功能。6.4. 应用界面文
31、字格式要求对于在手机中显示的应用程序名称，所有可以用中文表示的文件名，必须用中文表示，以便于用户在手机内查找已订购应用； 对于应用程序内向用户呈现的显示界面，所有可以用中文表示的内容，必须用中文表示；要求能在应用所支持的手机上正确显示；此中文显示要求包括各菜单选项，帮助信息，指示信息等。6.5. 短信计费业务订购页面要求确定返回您是否购买？需“XX点（等同于YY元人民币），格币0”如果您账户余额不足，系统将自动为您补足金额(1) 必须明确提示用户订购业务（或道具）名称；(2) 必须明确提示用户订购业务（或道具）价格，在道具资费说明中，必须写明价格为“XX点（等同于YY元人民币）”，XX代表道具
32、的点数价格，YY代表道具的人民币价格，点数和人民币元的比例关系为100：1；例如：道具名称为“刀”，价格需写明为：需“200点”（等同于2元人民币）(3) 提示页面必须包括以下内容：“如果您账户余额不足，系统将自动为您补足金额。”7. 数据类型7.1. 基本类型类型名称类型描述Char字符类型String字符串Int整型Float浮点型Date日期格式7.2. 复合类型XML格式采用W3C的1.0规范，字符集采用UTF-8。要求每个XML消息格式都是以起始。接口协议使用HTTP协议，落地方为发起方提供访问的URL，发起方使用HTTP POST方法发送请求报文并得到应答报文，发起方作为落地方的H
33、TTP客户端，落地方作为发起方的HTTP服务器。因此，各个参与方需要同时实现HTTP客户端以及服务器的功能。XML报文放置在HTTP的BODY里面，要求是UTF-8的编码。同时要保证HTTP的BODY里面仅放置XML完整报文。消息格式采用XMLSchema来定义，遵循http:/www.w3.org/2001/XMLSchema的国际标准。例如:UserID描述：用于标识用户的Schema。字段名称重要性字段类型长度字段描述userIdType必须String1用户标识类型1：用手机号码标识（不带86）2：用登录ID标识3：用userId标识4：用手机号码和登录ID标识5：其他使用多个标识us
34、erLabel必须String20用户标识对应报文为: 1134012345677.3. 状态码系统内状态码：内码是指系统内部逻辑处理的返回状态，合作方应该根据系统内码来显示用户提示。系统外状态码：外码用于合作方做业务逻辑判断：0代表成功；1代表失败。失败原因可以参见内码说明。举例：1.内码：1300 对应外码为0，表示计费成功，用户应该可以进入游戏。而1300的定义表示这次计费请求实际产生了费用。2.内码：1301 对应外码为0，表示计费成功，用户应该可以进入游戏。而1301的定义表示用户之前已经已经具备该业务的定购关系，本次计费请求不产生实际费用，用户可以进入游戏。详细状态码列表请参见附录
35、C。7.4. 系统级错误代码请参见附录C。8. 接口要求8.1. 客户端单机8.1.1. 描述客户端单机涉及的接口有两个(1) 客户端单机试玩转激活(激活单机游戏): 下载游戏客户端后，用话费消费完整版游戏（一次性激活、终身使用)。用户激活单机游戏，只有第一次播放时计费。(2) 单机游戏购买道具: 下载客户端游戏后，游戏过程中需购买道具、关卡、物品等。游戏玩家登陆客户端单机购买道具类业务，游戏平台获取手机号码，生成一个唯一的Key，并同步用户伪码和Key给合作伙伴的客户端单机购买道具类业务的服务器，然后向玩家返回登陆结果，玩家和客户端单机购买道具类业务的服务器可以通过游戏平台同步、返回的信息进
36、行交互。玩家登录客户端单机购买道具类业务流程图8.1.2. 客户端单机试玩转激活8.1.2.1. 写入RMS规则用户激活客户端单机游戏,只有第一次播放时计费。所以客户端需要记录用户是否已经成功激活游戏。游戏业务平台也有同样的处理规则，当相同手机号多次激活同一个单机游戏，只有第一次计费。8.1.2.2. 接口地址http:/:/bizcontrol/OrderSingleGame?sender=202&cpId=xxx&cpServiceId=xxx&packageId=xxx&fid=xxx8.1.2.3. 输入参数参数名称重要性类型长度描述信息sender必须String3网元编号，此处填写
37、“202”cpId必须String6合作方IDcpServiceId必须String12业务代码fid(channelId)必须String4位渠道伪码(8位渠道代码 )渠道伪码或渠道代码区间：10001999。1000代表提交给移动梦网的版本，1001开始代表其他线下渠道。也可以填写8位渠道代码packageId可选String12套餐代码渠道代码解释：fid: 4位长的渠道伪码消费客户端单机接口所采用的fid应该填写4位的渠道伪码，其值应该是10001999。1000代表此游戏通过移动梦网的“游戏频道”进行营销，通过游戏平台OTA服务器下载；一个非1000的数代表线下渠道，需要在游戏平台渠
38、道管理系统做登记，否则将认为无效渠道。channelId: 8位长的渠道代码考虑到支持原来的老版本程序，平台会兼容channelId(8位)的情况，但新申报业务时，客户端发起的报文，必须用fid。8.1.2.4. 返回值返回内容格式：返回HTTP应答，内容如下：Content-Type: text/plain; charset=UTF8rContent-Length: xxrrhRet=value1rstatus=value2标识符名称类型介质来源描述hRet返回值（外码）StringHTTP游戏平台计费结果0：成功1：失败status返回状态（内码）StringHTTP游戏平台状态码，见附录
39、C8.1.2.5. 处理流程用户购买单机游戏流程图8.1.3. 单机游戏购买道具8.1.3.1. 描述用于玩家通过点数购买客户端单机中的道具。客户端单机购买道具流程图8.1.3.2. 接口地址请参照8.4.4节网游购买道具中的相关描述。8.1.3.3. 输入参数请参照8.4.4节网游购买道具中的相关描述。8.1.3.4. 返回值请参照8.4.4节网游购买道具中的相关描述。8.1.3.5. 报文示例请参照8.4.4节网游购买道具中的相关描述。8.2. WAP单机8.2.1. 描述指按次计费的图文游戏。涉及到的接口有两个。(1) Wap单机业务代理: 一个WAP单机业务专用代理，本代理根据传入参数
40、，检查业务合法性，并代理手机用户请求WAP单机业务上报的访问地址对应的内容，将内容返回给手机客户端。需要注意的是，游戏平台代理请求访问地址的内容时将会向访问地址传channelId参数,HTTP Header中增加userId及ua,。WAP单机业务上报的访问地址对应页面应采用UTF-8编码。(2) 购买Wap单机业务: 用户每次播放时计费。购买Wap单机成功后,将客户请求重定向到计费成功后的地址。8.2.2. 地址解释所有Wap单机业务需要提交3个URL地址：访问地址、计费成功地址、返回地址。l 访问地址(indexUrl)：作为用户的访问入口，游戏平台会将用户的userId和ua作为Htt
41、p Header传给该地址。并将channelId参数以Get的方式传给该地址。l 计费成功地址：用户在WAP单机计费页点击“我要点播”进行计费，扣费成功后进入此链接。同时会将需要透传的参数向下传递。l 返回地址：用户在WAP单机计费页点击“返回继续浏览”将进入此页面。同时会将需要透传的参数向下传递。8.2.3. WAP单机业务代理8.2.3.1. 接口地址http:/:/bizcontrol/WapProxy?sender=202&cpId=xxx&cpServiceId=xxx&channelId=xxx8.2.3.2. 输入参数参数名称重要性类型长度描述信息sender必须String3
42、网元编号，此处填写“202”cpServiceId必须String12业务代码channelId必须String8渠道代码（8+6666666666666666位线上渠道）8.2.3.3. 返回值该接口代理用户访问Wap业务的访问地址，同时会透传以下参数。参数名称方向类型传递方式说明userId平台合作方StringHTTP Header用户伪码ua平台合作方StringHTTP Header用户手机型号（短UA形式），如用户手机型号为MOT-MOTORAZRV8_CMCC/1.0 linuxOS/2.6.10 Release/06.30.2007.Browser/Opera8.50 Profile/MIDP-2.0Configuration/CLDC-1.1software/R601_G_90.44.2BR则平台传递ua为MOT-MOTORAZRV8channelId平台合作方StringHttp Parameter渠道代码（8位线上渠道）8.2.3.4. 处理流程8.2.4. 购买WAP单机业务8.2.4.1. 接口地址http:/:/bizcontrol/OrderWapGame?sender=202&cpId=xxx&cpServiceId=xxx&packageId=xxx&channelId=xxx
