联通手机游戏自有平台运营方案
一、 平台现存问题
1、流量来源少
目前，主要依靠沃门户流量的来源，流量来源单一，依托于运营商。用户群主要为联通定制机用户，用户质量偏低。
2、用户粘性不足
（1） 缺乏健全的用户体系
（2） 缺少针对性营销策略
（3） 内容缺乏
（4） 展现形式
二、 解决方式
1、流量来源
（1） 通过互联网获取新的流量来源，通过QQ群、微信公众账号等方式活动新的合作方，借助广告链接、频道跳转等方式获取流量。对于门户，需要提供足够的广告位来支撑换量。
（2） 通过商务人员的人脉联系合作方，洽谈换量合作。
2、用户粘性
（1） 缺乏健全的用户体系
从用户角度来讲，用户注册成功，拥有了自己的账号和密码，会拥有一种归属感，觉得自己成为了平台中的一员。注册要分成简单注册和完善资料两部分。简单注册一定要快捷方便，并且要避免用户忘记账号密码。完善资料可通过积分奖励等方式鼓励用户完善。
（2） 缺少针对性营销策略
目前，对于联通手机游戏平台用户的了解还是有所欠缺，对于用户属性无法掌握，所以很难做出有针对性的营销策略。首先，需要通过用户资料完善和日常行为分析，获取用户属性，将用户分类，然后根据用户喜好继续有针对性宣传，如此可以有效提高宣传内容的转化率。
（3） 内容缺乏
用户对于游戏下载是有需求限度的，用户需要一段时间体验所下载的游戏，所以紧靠游戏内容无法有效增强用户粘性。游戏的攻略、资讯、搞笑段子，这些阅读类的东西，可以每日更新的形式来吸引用户每天登陆阅读。攻略、资讯可以由合作方提供，搞笑段子的内容可以由做新媒体的同事负责采集。
（4） 展现形式
首页展示形式较少，以游戏logo为主，用户通过首页获取的游戏信息很少。可新增板块，同时展示游戏的详情截图、星级、大小、简介等更多游戏亮点，吸引用户下载。
另外，对于新引入的内容（搞笑段子、攻略、资讯），在首页也有展现的位置，并且通过日常推送发布给用户。
第二篇：游戏运营管理平台合作方开发规范v1.0
QB-╳╳-╳╳╳-╳╳╳╳
中国移动通信企业标准 中国移动通信有限公司 发布
QB-╳╳-╳╳╳-╳╳╳╳
目 录
1.
2.
3.
4. 范围...........................................................................................................................................1 规范性引用文件.......................................................................................................................1 术语、定义和缩略语...............................................................................................................1 业务概述...................................................................................................................................2
4.1. 业务概念.......................................................................................................................2
4.2. 业务开放范围...............................................................................................................2
4.3. 业务类型.......................................................................................................................2
4.3.1. 按使用方式.......................................................................................................2
4.3.2. 按计费方式.......................................................................................................2
4.3.3. 按支付方式.......................................................................................................3
5. 游戏界面要求:.........................................................................................................................3
5.1. 应用界面设计基本原则...............................................................................................3
5.2. 游戏运营管理平台相关接口调用的入口说明...........................................................3
5.2.1. 游戏点数充值（包括所有单机和网络游戏）：...........................................3
5.2.2. 游戏点数消费（仅限网络游戏和需要购买道具的单机游戏）：...............3
5.2.3. 游戏点数余额及明细查询（包括所有单机和网络游戏）：.......................4
5.3. 应用界面文字格式要求...............................................................................................4
6. 数据类型...................................................................................................................................4
6.1. 基本类型.......................................................................................................................4
6.2. 复合类型.......................................................................................................................4
6.3. 状态码...........................................................................................................................6
6.4. 系统级错误代码.........................................................................................................10
7. 接口要求.................................................................................................................................11
7.1. 客户端单机业务.........................................................................................................11
7.1.1. 消费客户端单机.............................................................................................11
7.2. WAP单机业务............................................................................................................12
7.2.1. 消费WAP单机................................................................................................12
7.3. 客户端网游业务.........................................................................................................12
7.3.1. 登录客户端网游.............................................................................................12
7.3.2. 用户充值.........................................................................................................13
7.3.3. 购买道具.........................................................................................................14
7.3.4. 查询剩余点数.................................................................................................15
7.3.5. 查询充值记录.................................................................................................15
7.3.6. 查询消耗历史记录.........................................................................................17
7.4. WAP网游业务............................................................................................................18
7.4.1. 登录WAP网游................................................................................................18
7.4.2. 用户充值.........................................................................................................19
7.4.3. 购买道具.........................................................................................................20
7.4.4. 查询剩余点数.................................................................................................20
7.4.5. 查询充值记录.................................................................................................21
7.4.6. 查询消耗历史记录.........................................................................................23
附录................................................................................................................................................24
I
QB-╳╳-╳╳╳-╳╳╳╳
内容上传.................................................................................................................................24
WAP 网关与联网服务器的接口..........................................................................................26 编制历史.................................................................................................错误！未定义书签。
II
QB-╳╳-╳╳╳-╳╳╳╳
前 言
本标准规定了中国移动游戏运营管理平台与其上运营的游戏间的开发接口及相关协议，是各游戏开发商开发游戏的依据，以满足游戏运营管理平台的要求。
本标准主要包括以下几方面内容： 业务概述、游戏界面要求、数据类型和接口要求等。
本标准由中移 号文件印发。
本标准由中国移动通信有限公司技术部提出并归口。
本标准由中国移动通信有限公司技术部负责解释，具体细节由中国移动通信有限公司研究院负责解释。
本标准起草单位：中国移动通信研究院
本标准主要起草人： 何彬
III
QB-╳╳-╳╳╳-╳╳╳╳
1. 范围
本标准规定了中国移动游戏运营管理平台上的游戏开发规范，供各游戏CP/SP在开发游戏时使用。
2. 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。
[1] 游戏运营管理平台总体技术要求V1.0.0
[1] 游戏运营管理平台设备规范V1.0.0
[2] 游戏运营管理平台接口规范V1.0.0
[3] 游戏运营管理平台业务规范V1.0.0
[4] 超文本传送协议（Hypertext Transfer Protocol） --
HTTP/1.1---RFC 2616 中国移动通信有限公司 中国移动通信有限公司 中国移动通信有限公司 中国移动通信有限公司
[5] SOAP 协议 V1.1 [6] SOAP 协议 V1.2
[7]
HTTP鉴权(HTTP Authentication: Basic and Digest Access Authentication)--RFC2617
3. 术语、定义和缩略语
下列术语、定义和缩略语适用于本标准：
词语 解释
OTA Over The Air, 即空中、无线方式
HTTP Hyper Text Transfer Protocol，超文本传输协议
XML eXtensible Markup Language 可扩展标记语言
SOAP Simple Object Access Protocol 简单对象访问协议
CP Content Provider内容提供商
1
QB-╳╳-╳╳╳-╳╳╳╳
SP
CMGP
业务网元 Service Provider 服务提供商 游戏运营管理平台 指www portal、 wap portal、 网游服务器等
4. 业务概述
4.1. 业务概念
游戏运营管理平台是CP/SP精品游戏类内容（包括网游，精品单机游戏等）统一接入中国移动的平台，通过与各类门户等外围系统进行业务交互，提供内容管理、营销管理、点数管理、统计分析等能力给外围设备开展游戏类业务。
4.2. 业务开放范围
本业务向能够通过GPRS、3G网络接入到中国移动的手机用户开放。
游戏运营管理平台所有业务计费以及联网游戏运行，均必须使用CMWAP联网；游戏运营管理平台合作方开发的客户端应用程序须对未选择CMWAP联网的用户进行友好提示。 游戏运营管理平台客户端业务可以是由J2ME、Symbian、Windows Mobile、Mophun、C++等语言开发
4.3. 业务类型
4.3.1. 按使用方式
z 联网游戏（含非客户端游戏）:是指在使用过程中通常需要通过无线网络与网络侧游戏
服务器或其它用户发生互动的游戏。联网游戏包括分集提供、购买道具、过关需下载下一集的业务、在每次使用完毕提供积分排名的业务、以及不需下载客户端而直接联网使用的业务。
z 单机游戏：是指在使用过程中通常不需要通过无线网络与网络侧游戏服务器或其他用户
发生互动的游戏。
4.3.2. 按计费方式
游戏运营平台上的游戏计费包含流量费和信息费，本分类方式只基于信息费。依据信息费，可分为按次计费和按月计费两种：
z 按次计费：适用于按照下载次数收取费用的游戏。单机游戏一般采取按下载次数的计费
方式。此类游戏下载后不需要再连接游戏运营管理平台就可以直接使用。游戏下载成功后触发计费，以后的使用中不再计费，一次下载，永久使用。
z 按月计费：适用于按月收取费用的的联网游戏。用户付当月使用费用后可使用一个月，
第二个月不使用不计费，计费周期为自然月。
2
QB-╳╳-╳╳╳-╳╳╳╳
4.3.3. 按支付方式
4.3.3.1. 点数支付
点数支付适用于不限定计费频次、不限定计费点触发时间的业务，联网游戏一般采取点数计费的方式。
游戏运营管理平台支持用户下载游戏客户端后使用到一定次数、某个关卡、购买某种道具时触发点数支付计费。
游戏运营管里平台可以提供游戏客户端下载（计费/免费），无客户端业务（如WAP类联网游戏）可直接联网使用，两者均可在游戏进行中触发计费；
游戏运营管理平台还可以提供同一业务多次点数支付计费，用户在使用此类业务时需先在游戏运营管理平台的用户帐户中充值。
4.3.3.2. 话费支付
话费支付适用于不进行点数帐户充值，直接用话费支付费用的游戏类型，如单机版游戏。
5. 游戏界面要求:
5.1. 应用界面设计基本原则
游戏CP/SP开发的客户端应用程序的操作界面必须与手机已有功能的操作习惯一致； 游戏程序启动界面必须使用中国移动指定的统一标识；
游戏主菜单界面必须有一个“更多游戏”的选项指向中国移动指定的WAP链接；
5.2. 游戏运营管理平台相关接口调用的入口说明
5.2.1. 游戏点数充值（包括所有单机和网络游戏）：
A）在应用（游戏）的主菜单界面，必须有“游戏点数”充值的入口；
B）在应用（游戏）的游戏界面，必须有至少一处的明显位置为“游戏点数”充值的入口；
C）在“游戏点数”充值界面，必须有“游戏点数”介绍说明和“游戏点数”充值的帮助信息。
5.2.2. 游戏点数消费（仅限网络游戏和需要购买道具的单机游戏）：
A）在应用（游戏）的游戏界面，必须有至少一处的明显位置为“游戏点数”消费的入口；
B）在“游戏点数”消费界面，必须显示与上报业务局数据一致的资费说明；
C）在“游戏点数”消费界面，必须有“游戏点数”介绍说明和“游戏点数”消费的帮助信息。
3
QB-╳╳-╳╳╳-╳╳╳╳
5.2.3. 游戏点数余额及明细查询（包括所有单机和网络游戏）：
A）在“游戏点数”充值和“游戏点数”消费界面必须显示游戏点数余额；
B）在应用（游戏）的游戏界面，必须有至少一处的明显位置为“游戏点数”余额及明细查询的入口
C）在联网应用（游戏）的游戏界面，必须有至少一处的明显位置为“购买物品（道具）”查询的入口，用户可以查询该联网应用（游戏）的所有购买物品或道具的明细，包括物品（道具）的名称，购买时间和所消耗的游戏点数。
D）在“游戏点数”余额及明细查询界面，用户可以查询购买点数的详细记录和消费点数的详细记录，详细记录按照消费时间倒序排列（即时间较近的记录排列在前，时间较远的记录排列在后）
E）在“游戏点数”余额查询界面，必须有“游戏点数”介绍说明和“游戏点数”余额查询的帮助信息。
5.3. 应用界面文字格式要求
对于在手机中显示的应用程序名称，所有可以用中文表示的文件名，必须用中文表示，以便于用户在手机内查找已订购应用；
对于应用程序内向用户呈现的显示界面，所有可以用中文表示的内容，必须用中文表示；要求能在应用所支持的手机上正确显示；此中文显示要求包括各菜单选项，帮助信息，指示信息。
6. 数据类型
6.1. 基本类型
类型名称
Char
String
Int
Float
Date
6.2. 复合类型
XML格式采用W3C的1.0规范，字符集采用UTF-8。要求每个XML消息格式都是以<?xml version=”1.0” encoding=”UTF-8”?>起始。
接口协议使用HTTP协议，落地方为发起方提供访问的URL，发起方使用HTTP POST方法
4 类型描述 字符类型 字符串 整型 浮点型 日期格式
QB-╳╳-╳╳╳-╳╳╳╳
发送请求报文并得到应答报文，发起方作为落地方的HTTP客户端，落地方作为发起方的HTTP服务器。因此，各个参与方需要同时实现HTTP客户端以及服务器的功能。 XML报文放置在HTTP的BODY里面，要求是UTF-8的编码。同时要保证HTTP的BODY里面仅放置XML完整报文。
消息格式采用XMLSchema来定义，遵循/2001/XMLSchema的国际标准。
UserID
描述：用于标识用户的Schema。
表6-1 字段名称 userIdType
重要性
字段类型
长度
字段描述
必须用户标识类型
1：用手机号码标识 2：用登录ID标识 3：用userId标识 4：用手机号码和登录ID标识5：其他使用多个标识 必须用户标识
userLabel
QueryChargeRecord
描述：查询用户充值记录时，返回的信息。
表6-2 字段名称 hRet Status userIdType userLabel startSequence recordCount chargeList
重要性
字段类型
长度 4 4 1 8 8
字段描述 参考相应返回值 状态信息 用户标识类型 本次查询的起始序号 返回记录数目 明细清单
必须必须必须必须必须必须必须20 用户标识
ConsumerSchema
描述：用于描述消费记录具体信息的Schema。
表6-3 字段名称 Date consumerType
重要性
字段类型
长度 16 1
字段描述
消费日期 格式为 yyyymmdd hh24:mi 消费类型 ‘O’ ：开户 ‘A’：充值 ‘C’：消费 ‘X’：注销 点数
必须必须Point 必须4
QueryBalanceResp
描述：查询用户剩余点数时，返回的信息。
5
QB-╳╳-╳╳╳-╳╳╳╳
表6-4
字段名称 hRet msgType Status userIdType userLabel Point
重要性
字段类型
长度 4 30 4 1 20 4
字段描述 参考相应返回值 操作类型 状态信息 用户标识类型 用户标识
剩余点数，精确到小数点后2位
必须必须必须必须必须必须
SyncInfo
描述：同步给网游服务器的信息。
表6-5
字段名称 userId Key
6.3. 状态码
表6-1 标准状态码
序号
对外状态码
对内状态码
描述
正常返回，因为已经拥有该业务订购关系，所以没有计费发生
查询开始日期应大于截至日期 查询消费历史记录成功
1300 正常返回，有计费发生 1301 1173 1102 重要性
字段类型
长度 8 8
字段描述 用户伪码 签名Key
必须必须1601 查询用户密码成功 1201 查询用户密码成功 1671 查询用户密码失败 1271 查询用户密码失败 1202 查询用户手机号成功 1272 1203 1273 1600 1200 1670
查询用户手机号失败 查询用户伪码成功 查询用户伪码失败 查询用户信息成功 查询用户信息成功 查询用户信息失败
6
QB-╳╳-╳╳╳-╳╳╳╳ 1270 1183 1184 1198 1103 1288 1303 9017 1182 1800 1819 1813 1114 1111 1172 1302 1876 1282 1694 1695 1185 1171 9609 1877 1681 9701 1859 1853 1854 1855 查询用户信息失败 充值金额超过当天最大限额 充值金额超过当月最大限额 登陆客户端网游失败 登录成功 点数账户开户失败 订购套餐正常返回 非法接入IP 该用户没有足够的点数余额 购买道具成功 合作方不存在 合作方已下线 黑名单用户不允许充值 计费代码错误（无效、下线等） 记录数量应大于0 鉴权套餐正常返回 禁止联通用户访问 用户不存在-用户管理 接口不可用 接口配置错误 由于计费子系统引起的逻辑错误 起始序号不应该小于1. 请使用CMWAP连接网络 请使用手机访问 手机号码错误 数据库错误，比如链接异常，约束违例 套餐不存在 套餐已下线 信息录入中（信息未完善） 待测试（游戏包测试，计费测试）
7
QB-╳╳-╳╳╳-╳╳╳╳ 1856 1857 1858 9699 9601 1399 9999 1170 1875 9599 9598 1878 1605 1205 1675 1275 1604 1204 1674 1274 9014 1839 1832 1833 1831 1818 1616 1320 1680 1316 暂停 待下线 套餐与合作方关系错误 网络异常 网络异常，比如远程链接失败，响应超时 未知错误 未知错误 未知的查询类型 无法获取手机号 系统繁忙 系统异常，并不可用 校验码认证失败，非正常流程订购，请重试。 修改用户密码成功 修改用户密码成功 修改用户密码失败 修改用户密码失败 修改用户信息成功 修改用户信息成功 修改用户信息失败 修改用户信息失败 验证错误，无法解析XML结构、缺少必须存在的字段，或者消息格式不正确 业务不存在 业务未上线 业务已下线 业务已暂停 业务与合作方关系错误 用户密码为空 已存在订购关系 用户不存在 用户不存在该套餐订购关系
8
QB-╳╳-╳╳╳-╳╳╳╳ 1100 1180 1608 1208 1678 1278 1276 1682 1181 1322 1312 1311 1318 202 139 1116 1115 1297 1607 1207 1677 1277 1118 1112 1113 1117 1610 1106 1120 1690 用户充值成功 用户登陆失败 用户登录成功 用户登录成功 用户登录失败 用户登录失败 用户密码错误 用户密码错误 用户欠费 用户请求消费业务所属的套餐不存在 用户请求消费业务所属的套餐不存在订购关系 用户请求消费业务所属的套餐为非商用状态 用户请求消费业务所属的套餐为下线状态 用户剩余点数不足 用户是黑名单用户 用户伪码错误 用户伪码为空 用户已经是注册用户 注册用户成功 注册用户成功 注册用户失败 注册用户失败 充值代码错误（无效、下线等） 充值代码无效 充值代码过有效期 充值代码鉴权成功 用户是白名单用户 控制鉴权正常返回 CP网游服务器响应超时 用户控制通讯鉴权成功
9
QB-╳╳-╳╳╳-╳╳╳╳
6.4. 系统级错误代码
表6-1 状态外码 状态内码 描述
系统磁盘读写错误
网络异常
网络错误
业务网关忙，业务网关缓存 系统繁忙
业务网关超过限制的流量
系统异常，并不可用
业务网关异常，并不可用
该业务网关没有权限调用该接口消息 没有权限发送该接口消息给业务网关 版本不支持
消息类型不对，系统不支持 1 9014 验证错误，无法解析XML结构、缺少必须存在的字段，或者消
息格式不正确 1691 1801 1101 1107 1196 1175 1176 1777 1778 1672 1673 1693 1615 1611 1699 用户控制通讯鉴权失败 购买道具失败 用户充值失败 控制鉴权失败 登陆Wap网游失败 鉴权时发现业务是WAP单机 鉴权时发现业务是WAP网游 使用的业务是客户端单机 使用的业务是客户端网游 该用户是冻结用户 该用户是注销用户 接口名称不存在 email格式不正确 日期格式不对 性别不在范围内
拒绝消息，服务器无法完成请求的服务
10
QB-╳╳-╳╳╳-╳╳╳╳ 非法接入IP
系统异常，并不可用
系统繁忙
网络异常，比如远程链接失败，响应超时
请使用CMWAP连接网络
数据库错误，比如链接异常，约束违例
RMI调用错误
请求过于频繁
Wap网关错误
未知错误
7. 接口要求
7.1. 客户端单机业务
7.1.1. 消费客户端单机
7.1.1.1. 描述
用户消费客户端单机业务，可在用户第一次播放时计费，也可在用户试玩游戏部分内容后再触发计费以激活后续游戏。
7.1.1.2. 输入参数
表7-1
参数名称
sender
cpId
cpServiceId
channelId
7.1.1.3. 返回值
返回内容格式：
返回为普通文本，内容如下：
Content-Type: text/plain; charset=UTF8\r
Content-Length: xx\r
\r
11 重要性 类型 长度 3 6 4 描述信息 网元编号 合作方ID 渠道代码 必须必须必须必须12 业务代码
QB-╳╳-╳╳╳-╳╳╳╳
hRet=value1\r
status=value2
7.2. WAP单机业务
7.2.1. 消费WAP单机
7.2.1.1. 描述
用于玩家消费WAP单机业务,用户每次播放时计费。
7.2.1.2. 输入参数
表7-1 参数名称
sender
cpId
cpServiceId
channelId
7.2.1.3. 返回值
重定向URL
注:
1、消费成功返回消费wap游戏成功的URL
2、消费失败返回失败URL
返回的URL格式如下：
http://<host>:<port>/bizcontrol/OrderWapGame?sender=xxx
&cpId=xxx&cpServiceId=xxx&packageId=xxx&channelId=xxx
7.3. 客户端网游业务 重要性 类型 长度 3 6 8 描述信息 网元编号 合作方ID 渠道代码 必须必须必须必须12 业务代码
7.3.1. 登录客户端网游
7.3.1.1. 描述
游戏玩家登陆网游，业务支撑获取手机号码，生成Key（用于保证userId不被客户端纂改）
12
QB-╳╳-╳╳╳-╳╳╳╳
调用用户管理同步用户伪码给游戏玩家，并同步用户伪码和Key给网游服务器,返回格式将会是http://<host>:<port>/scriptName?userId=xxx&key=xxx, 其中：scriptName是业务支撑向CP网游服务器同步用户信息时，响应业务支撑请求的应用程序名及其所在的路径
7.3.1.2. 输入参数
表7-1 参数名称
sender
cpId
cpServiceId
channelId
7.3.1.3. 返回值
返回内容为普通文本，内容如下：
Content-Type: text/plain; charset=UTF8\r
Content-Length: xx\r
\r
hRet=value1\r
status=value2\r
userId=value3\r
key=value4\r
7.3.2. 用户充值 重要性 类型 长度 描述信息 参数名称 必须网元编号必须合作方必须业务必须渠道伪码7.3.2.1. 描述
用于玩家通过业务网元对自己帐户充值。充值是指玩家将话费转化成一定数量的点数，点数可以用来购买游戏和购买道具。
7.3.2.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>ChargeUpReq</msgType>
<sender>101</sender>
<userIdType>3</userIdType>
<userLabel>12345678</userLabel>
<channelId>String</channelId>
13
QB-╳╳-╳╳╳-╳╳╳╳
<cpId>String</cpId>
<cpServiceId>String</cpServiceId>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?> <response>
<msgType>ChargeUpResp</msgType> <hRet>0</hRet>
<status>1200</status>
</response>
* channelId 为8位渠道代码
7.3.3. 购买道具
7.3.3.1. 描述
用于玩家购买网游中的道具。
7.3.3.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?> <request>
<msgType>BuyGameToolReq</msgType> <sender>101</sender>
<userId>12345678</userId>
<channelId>String</channelId> <cpId>String</cpId>
<cpServiceId>String</cpServiceId>
<consumeCode>String</consumeCode>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?> <response>
<msgType>BuyGameToolResp</msgType> <hRet>0</hRet>
<status>1800</status>
</response>
* channelId 为4位渠道伪码
14
QB-╳╳-╳╳╳-╳╳╳╳
7.3.4. 查询剩余点数
7.3.4.1. 描述
用于玩家通过业务网元查询自己剩余点数。
7.3.4.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?> <request>
<msgType>QueryBalanceReq</msgType> <sender>101</sender>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel> <channelId> String</channelId> </request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?> <response>
<msgType>QueryBalanceResp</msgType> <hRet>0</hRet>
<status>1200</status>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel> <point>String</point>
</response>
* channelId 为8位渠道代码
7.3.5. 查询充值记录
7.3.5.1. 描述
查询用户历史发生的充值记录
15
QB-╳╳-╳╳╳-╳╳╳╳
7.3.5.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>QueryChargeReq</msgType> <sender>101</sender>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel> <channelId> String</channelId>
<startDate>String</startDate>
<endDate>String</endDate>
<startSequence>1</startSequence> <recordCount>20</recordCount>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?>
<response>
<msgType>QueryChargeResp</msgType> <hRet>0</hRet>
<status>1200</status>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel> <startSequence>1</startSequence>
<recordCount>20</ recordCount >
<chargeList>
<consumerSchema>
<date>String</date>
<consumerType>A</consumerType> <point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>A</consumerType> <point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>A</consumerType> <point>String</point>
</consumerSchema>
16
QB-╳╳-╳╳╳-╳╳╳╳
</chargeList>
</response>
* channelId 为8位渠道代码
7.3.6. 查询消耗历史记录
7.3.6.1. 描述
用于游戏玩家在业务网元上查询自己的点数消费历史记录。
7.3.6.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>QueryDetailReq</msgType>
<sender>101</sender>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
<channelId> String</channelId>
<startDate>String</startDate>
<endDate>String</endDate>
<startSequence>1</startSequence>
<recordCount>20</recordCount>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?>
<response>
<msgType>QueryDetailResp</msgType>
<hRet>0</hRet>
<status>1200</status>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
<startSequence>1</startSequence>
<recordCount>20</ recordCount >
<chargeList>
<consumerSchema>
<date>String</date>
17
QB-╳╳-╳╳╳-╳╳╳╳
<consumerType>C</consumerType>
<point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>C</consumerType>
<point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>C</consumerType>
<point>String</point>
</consumerSchema>
</chargeList>
</response>
* channelId 为8位渠道代码
7.4. WAP网游业务
7.4.1. 登录WAP网游
7.4.1.1. 描述
此接口用于玩家登陆WAP网游。业务控制获取手机号码，从用户管理处获取相应的userId，生成随机Key（用于保证userId不被客户端纂改），并将它们同步给网游戏服务器；获取相应的WAP网游入口地址，形成URL，附加参数 userId和参数key，并重定向到手机客户端。 返回格式将会是http://<host>:<port>/scriptName?userId=xxx&key=xxx, 其中：scriptName是业务支撑向CP网游服务器同步用户信息时，响应业务支撑请求的应用程序名及其所在的路径
7.4.1.2. 输入参数
表7-1 参数名称
sender
cpId
cpServiceId
channelId 重要性 类型 长度 描述信息 必须网元编号 必须合作方ID 必须业务ID 必须渠道代码
18
QB-╳╳-╳╳╳-╳╳╳╳
7.4.1.3. 返回值
重定向URL:
1、鉴权不通过返回错误页面
返回的URL格式如下：
https://<host>:<port>/bizcontrol/loginwaperror?statecode=xxx
其中：URL中的参数statecode描述状态码信息。
2、鉴权通过返回网游入口的url，该url会携带用户伪码和随机验证码
同步给WAP网游戏服务器的url格式如下：
http：//CpUrl?userId=xxx&key=xxx（其中CpUrl为Cp同步服务器地址，userId为同步用户伪码，key为随机验证码）
7.4.2. 用户充值
7.4.2.1. 描述
用于玩家通过业务网元对自己帐户充值。充值是指玩家将话费转化成一定数量的点数，点数可以用来购买游戏和购买道具。
7.4.2.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>ChargeUpReq</msgType>
<sender>101</sender>
<userIdType>3</userIdType>
<userLabel>12345678</userLabel>
<channelId>String</channelId>
<cpId>String</cpId>
<cpServiceId>String</cpServiceId>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?>
<response>
<msgType>ChargeUpResp</msgType>
<hRet>0</hRet>
<status>1200</status>
19
QB-╳╳-╳╳╳-╳╳╳╳
</response>
* channelId 为8位渠道代码
7.4.3. 购买道具
7.4.3.1. 描述
用于玩家购买网游中的道具。
7.4.3.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?> <request>
<msgType>BuyGameToolReq</msgType> <sender>101</sender>
<userId>12345678</userId>
<channelId>String</channelId> <cpId>String</cpId>
<cpServiceId>String</cpServiceId>
<consumeCode>String</consumeCode>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?> <response>
<msgType>BuyGameToolResp</msgType> <hRet>0</hRet>
<status>1800</status>
</response>
* channelId 为8位渠道代码
7.4.4. 查询剩余点数
7.4.4.1. 描述
用于玩家通过业务网元查询自己剩余点数。
20
QB-╳╳-╳╳╳-╳╳╳╳
7.4.4.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>QueryBalanceReq</msgType>
<sender>101</sender>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
<channelId> String</channelId>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?>
<response>
<msgType>QueryBalanceResp</msgType>
<hRet>0</hRet>
<status>1200</status>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
<point>String</point>
</response>
* channelId 为8位渠道代码
7.4.5. 查询充值记录
7.4.5.1. 描述
用于玩家通过业务网元，查询自己在一段时间内的充值记录明细。
7.4.5.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>QueryChargeReq</msgType>
<sender>101</sender>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
21
QB-╳╳-╳╳╳-╳╳╳╳
<channelId> String</channelId>
<startDate>String</startDate>
<endDate>String</endDate>
<startSequence>1</startSequence> <recordCount>20</recordCount>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?>
<response>
<msgType>QueryChargeResp</msgType> <hRet>0</hRet>
<status>1200</status>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel> <startSequence>1</startSequence>
<recordCount>20</ recordCount >
<chargeList>
<consumerSchema>
<date>String</date>
<consumerType>A</consumerType> <point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>A</consumerType> <point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>A</consumerType> <point>String</point>
</consumerSchema>
</chargeList>
</response>
* channelId 为8位渠道代码
22
QB-╳╳-╳╳╳-╳╳╳╳
7.4.6. 查询消耗历史记录
7.4.6.1. 描述
用于游戏玩家在业务网元上查询自己的点数消费历史记录。
7.4.6.2. 接口
1、Request请求消息
<?xml version="1.0" encoding="UTF-8"?>
<request>
<msgType>QueryDetailReq</msgType>
<sender>101</sender>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
<channelId> String</channelId>
<startDate>String</startDate>
<endDate>String</endDate>
<startSequence>1</startSequence>
<recordCount>20</recordCount>
</request>
2、Response应答消息
<?xml version="1.0" encoding="UTF-8"?>
<response>
<msgType>QueryDetailResp</msgType>
<hRet>0</hRet>
<status>1200</status>
<userIdType>1</userIdType>
<userLabel>138xxxxxxxx</userLabel>
<startSequence>1</startSequence>
<recordCount>20</ recordCount >
<chargeList>
<consumerSchema>
<date>String</date>
<consumerType>C</consumerType> <point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>C</consumerType>
23
QB-╳╳-╳╳╳-╳╳╳╳
<point>String</point>
</consumerSchema>
<consumerSchema>
<date>String</date>
<consumerType>C</consumerType>
<point>String</point>
</consumerSchema>
</chargeList>
</response>
* channelId 为8位渠道代码
8. 编制历史
版本号 更新时间 主要内容或重大修改 1.0.0 2007-10-23 1.0.0版本
附录A
A.1 内容上传
游戏包统一采用.zip压缩文件，压缩包根目录下包括以下文件：
一个或多个游戏文件（针对不同平台开发），例如：abc1_0_0_1.jar，abc1_0_0_1.sis等； 一个或多个游戏预览图图片文件，图片格式为gif文件，大小为1024 X 1024；
一个机型适配文件：config.xls；该适配文件包含两个工作表：entityFiles以及uagroup-entities； 游戏包作用
业务管理员根据CP提供内容制作游戏包，可以向系统批量插入游戏实体信息以及实体适配信息。
游戏包内容
游戏包采用.zip格式压缩文件，下面是一个压缩包：
游戏包上传规范及示例.zip
压缩前的文件目录如下：
24
QB-╳╳-╳╳╳-╳╳╳╳
图 1 压缩包目录结构
图中config.xls是一个Excel文件，它用于描述上传游戏包中的内容。pic文件夹用于存放游戏截图文件，1000, 1001…等文件夹每个文件夹对应一个渠道伪码。下面我们详细介绍一下配置文件及不同文件夹的作用：
配置文件
配置文件的主要作用是：1）描述游戏实体信息，2）描述游戏实体与机型组的适配信息。 因此，如下图所示配置文件中包含两个工作表：entityFiles和uagroup-entities。
图 2 配置文件结构
entityFiles实体描述工作表，它列出了上传的所有游戏实体及其基本信息，表结构如下：
字段名 字段中文名 示例 字段详细描述
25
QB-╳╳-╳╳╳-╳╳╳╳ serviceId 业务代码游戏实体所属游戏业务代码，它必须
与选择上传游戏包的业务的业务代
码一致。
文件名实体文件名；它还用于标识相同业务
下的不同实体。
开发技术游戏实体的开发技术。
发布日期日期格式为：yyyy-MM-dd
版本 fileName devTech releaseDate version
需要注意的是：如果上传游戏实体是一个描述文件：jad或类似的文件（如dd，/xmlns/dd）如果描述文件指向一个内容文件要求文件里面的实体
uagroup-entities实体适配工作表，它列出了上传的游戏实体与机型组间的适配关系，表结构如下：
字段名
uaGroup
fileNames 字段中文名 示例 字段详细描述 机型组机型组标识
文件名以“,”分割的多个实体文件名，每
个实体文件名与前述实体描述工作
表中的实体文件
渠道伪码文件夹
由于游戏运营管理平台根据渠道伪码区分相同游戏业务的不同线下渠道，因此CP需要为同
压缩包内包含一个或多个一业务提供多套拥有不同渠道伪码的实体文件。从图 1可以看出，
以渠道伪码命名的文件夹，每个渠道伪码文件夹应该具有相同的目录结构，而且每个文件夹必须包含上述实体描述工作表中描述的所有实体文件。
预览图文件夹
以pic命名，如下图所示，文件夹内共包含6个图片文件，其中包括一个LOGO图片文件，大小为101X101，名为logo.jpg，以及5个介绍图片文件，分别为：pic_1.jpg, pic_2.jpg, pic_3.jpg, pic_4.jpg, pic_5.jpg。
图 3 图片文件夹内容图例
A.2 WAP 网关与联网服务器的接口
联网应用程序的客户端程序（MIDlet）向WAP 网关发送请求时，应该在HTTP HEADER 中加入下面的信息：
26
QB-╳╳-╳╳╳-╳╳╳╳
X-Online-Host：联网服务器的域名和端口
请求的示例
联网应用程序的客户端程序（MIDlet）向WAP 网关发送的请求:
GET /online-app/StartServlet HTTP/1.1
Host: 10.0.0.172:8080
X-Online-Host: .cn:80
联网应用程序的客户端程序（MIDlet）向HTTP HEADER 中添加信息时，以上述字段中X-Online-Host为所有请求服务器地址，Host为WAP的APN地址。
27