游戏地带手机HML5网络游戏.docxVIP

游戏地带手机HTML5网络游戏接入手册序号编辑者修改日期备注1Guangping完稿2012-10-102Joyceli修订2012-12-253Guangping修订7,82013-1-61概述游戏地带开放平台（）是发布游戏资源包，管理游戏运营状态及查看运营数据的综合性平台。对于接入游戏地带的游戏，为了保护用户数据，腾讯规定所有游戏都必须选择hosting模式接入，即将游戏部署在腾讯的服务器上（比如腾讯南京合作机房）。腾讯服务器均为Linux服务器。腾讯手机应用第三方管理平台（:8000/）是后台开发人员申请服务器，帐号口令（口令会过期），服务软件安装，数据库，域名等资源的平台。2系统架构2.1系统框架图2.2系统框架说明第三方应用的后台服务程序最终部署在腾讯合作机房。视第三方应用的游戏规模，腾讯为每个游戏提供数量不等的服务器，这些服务器组成服务器组。服务器组中的机器被腾讯的LB负载均衡后随机调用。游戏地带Web服务为HTML5游戏的入口，在开放平台发布用于展示该游戏的资源包即可获得该入口，访问该入口后将被跳转到CP的Web服务器的首页（应该是配置域名的web服务）；开始进入游戏，游戏中所需图片资源，可从CDN下载。当然，开发阶段需要开发者通过开放平台把游戏所用到的图片资源上传到CDN。游戏内需要读取用户的昵称及好友关系链，需要CP的后台服务调用游戏地带后台API，调用时必须带上用户的Token，OpenId这些信息。用户档案信息可保存到腾讯合作机房的 CDB中心数据库群；该数据库为mysql数据库，提供冷热备份。建议采用memcache缓存数据，解决数据库访问瓶颈问题。3游戏接入流程3.1接入流程描述STEP-1开发者在PC端登录腾讯游戏地带开放平台，填写个人或公司资料进行注册。同时联系游戏地带后台接口人，按接口人要求提供相应的资料（如公司全称，应用名称，管理员qq号及联系方式，公司固定IP等），由接口人代为申请合作机房测试服务器及注册腾讯手机应用第三方管理平台。该工作流程需要3个工作日；接口人将申请好的跳板机（登录合作机房的中转服务器）帐号口令及开发机帐号口令发给开发者。STEP-2开发者可登录合作机房测试机部署后台开发环境。在腾讯无线第三方管理平台上申请域名，并绑定域名相应的web服务部署的IP地址及端口。同时准备Html5网络游戏资源包（用于游戏地带展示该游戏的图片等）在开发平台发布，获取到游戏的GameId。在开放平台管理中心（需要开通访问权限）需求系统中为该游戏创建游戏分区。STEP-3 在开放平台该游戏的详情里配置测试（开发）环境的后台地址URL（用于生成APPID，游戏地带产生的Token中才含有用户的OpenID，必须配置这个地址）。游戏上线后请配置正式环境的后台地址。STEP-4开发者完成注册和配置后，即可着手后台API接口调试。同时可在开放平台将游戏中需要用到的图片资源打包上传到CDN。STEP-5 为了缩短接入时间，开发者必须进行详细的单元测试和集成测试，完成开发工作。STEP-6 CP完成开发、联调以及自测、完善自测报告后，在开放平台上提交审核，同时在腾讯手机应用第三方管理平台申请正式服务器及CDB资源，部署正式运营环境。游戏地带测试接到审核请求后，开放给内部用户测试体验。若内测发现问题，驳回给CP重新修改；待内测通过后，将着手上线工作的准备。游戏自测、内测以及审核都通过后，以最终提交的游戏版本做为最终上线版本，在腾讯游戏地带上增加入口链接，即正式开始运营。3.2开放平台上传游戏资源包说明在开放平台的开发者栏目下点击发布新游戏，选择Html5游戏类型然后上传准备好的资源包。资源包里必须包含用于游戏展示的图片图标，如下图所示。具体格式要求，发布时开放平台会给提示。然后填写游戏详细信息，游戏类型选择网游，网游接入点选择南京合作机房或天津机房。设置支持的浏览器版本，注意加入测试人员的qq号。4HTML5游戏数据请求STEP-1CP在开放平台提交游戏资源包后，开放平台会将资源包上传到资源服务器。STEP-2在游戏地带启动Html5游戏，即会访问开发者提供的URL页面，并且通过URL参数的方式带上用户的身份票据信息。例如http://SERVER_URL?token=TOKEN_STRING参数说明：token: 游戏玩家的身份票据STEP-3Client 向后台server发送请求：Client可以通过配置的后台服务器的域名直接向游戏后台发送请求（带上用户的Token），后台服务请求游戏地带的后台API接口将Token转换成 OPENID；STEP-4CP后台可以调用游戏地带后台服务获取用户昵称，QQ好友等信息。5游戏地带后台接口5.1请求用户的OPENIDOpenId 是用户的user id，在游戏