浩方对战平台第三方游戏接入技术说明文档.doc

浩方在线平台开发部浩方对战平台接入网络游戏的技术要求第8页 共10页修订历史修订日期修订内容修订者2007-03-13创建本文档颜巍2007-03-19完善本文档颜巍目录1.前言41.1目的41.2本文档的适用范围41.3本文档的阅读对象41.4定义及缩略语42.概述52.1游戏启动、登录和帐号认证流程52.2充值、兑换和计费流程53.服务器端63.1游戏服务器63.2帐号认证63.2.1盛大游戏63.2.2非盛大游戏64.客户端74.1浩方对战平台74.2游戏插件程序74.3游戏客户端7附录1：浩方帐号认证接口8附录2：游戏插件程序需要了解的信息91. 前言1.1 目的在浩方对战平台中接入网络游戏，引导浩方用户了解游戏、下载游戏、安装游戏、玩游戏，并进行充值和消费，从而达到浩方和引入的网络游戏提供商双赢的目的。1.2 本文档的适用范围本文档适用于在浩方对战平台中嵌入其它基于胖客户端（Rich Client）的网络游戏或应用的情况。这些游戏或应用以浩方帐号作为游戏登录、计费等的唯一依据，浩方对战平台提供进入游戏的入口，同时将当前登录用户的帐户信息带入游戏，后者基于带入的帐户创建游戏角色并进行计费。双方按照从浩方点券转换成游戏虚拟货币的转换量进利润分成。1.3 本文档的阅读对象本文档的阅读对象包括：浩方对战平台的客户端和服务器端开发人员、浩方的游戏运营人员和页面开发人员，以及网络游戏提供商方面的开发人员等。1.4 定义及缩略语平台：浩方对战平台；游戏：需要接入浩方对战平台的网络游戏；2. 概述2.1 游戏启动、登录和帐号认证流程图表 1：游戏启动、登录和帐号认证流程2.2 充值、兑换和计费流程浩方充值接口需求 接口类型：WebService接口参数： int UPoint,充值点数string Account,账号 （支持中文字符）string OrderID,订单号主要是以上三种参数返回结果： int0 充值成功3. 服务器端3.1 游戏服务器视合同要求而定，如果需要浩方提供游戏服务器，则需要根据合同规定和接入游戏的技术要求准备服务器和带宽，并安装操作系统和必要的软件。该项准备工作主要由相关技术支持部门完成。3.2 帐号认证浩方对战平台在启动游戏时，通过命令行方式将平台用户对应的盛大通行证帐号和密码传递给游戏客户端程序，后者需要通过某种方式进行认证，以确认帐号的合法性。3.2.1 第三方游戏l 方式1透明传递方式（推荐）：浩方对战平台将用户的帐号和经过特定算法进行加密的密码通过命令行方式传递给游戏客户端，后者用该帐号密码对登录其游戏服务器，游戏服务器再将该帐号密码对透明的传递给浩方提供的帐号认证服务器，由浩方帐号认证服务器对帐号密码的合法性进行验证。参见2.1节之“图表 2：游戏启动、登录和帐号认证流程”。浩方帐号认证服务器的接口定义参见附录1。l 方式2映射转换方式（不推荐，用于无法采用方式1的情况）：浩方对战平台将用户的帐号和经过特定算法进行加密的密码通过命令行方式传递给游戏客户端，后者用该帐号密码对登录其游戏服务器，游戏服务器根据实现和浩方方面约定的方式对帐号密码进行验证，完成登录。该方法只是做了一个伪验证，本质上依赖于浩方对战平台的登录可靠性，且通常需要进行帐号映射等额外的操作，不能真正验证帐号密码的合法性，因此，如非必要，不建议采用此种方式。4. 客户端4.1 浩方对战平台浩方对战平台增加一个可配置的频道组“免费网络游戏”，作为所有接入网络游戏的入口。该频道组中列出了所有接入的网络游戏。部分网络游戏可通过配置，映射到“竞技游戏”频道组中显示。点击“免费网络游戏” 频道组中的网络游戏频道，将启动针对每个游戏的插件程序来启动和传递帐号密码信息给游戏。如果该插件程序不存在或者版本不正确，将首先提示用户进行下载。4.2 游戏插件程序游戏插件程序是一个可执行程序，该程序在启动后检查游戏是否已经安装，如果未安装，则提示用户进行下载或手工查找其所在目录。如果游戏已经安装，则启动游戏，同时通过命令行方式传递帐号和密码给后者。启动游戏的命令行参数格式可能随游戏的不同而不同。游戏插件程序为了能够检测游戏是否安装，并启动游戏，游戏提供方需提供如下信息：n 用于存储游戏客户端安装路径等的注册表键值；n 游戏客户端的启动程序名；n 启动游戏的命令行参数格式。详见附录2。此外，游戏插件程序还需要了解如下信息：n 游戏未安装情况下的内嵌页面URL和尺寸（宽和高）；n 游戏已安装情况下的内嵌页面URL和尺寸（必须和上面的一样）；n 游戏主页的URL；n 游戏的推荐下载链接的URL（建议用盛大下载器方式）n 当游戏尚未开区时用户点击“启动游戏”按钮将自动转向的提示页面的URL。详见附录2。4.3 游戏客户端为接入浩方对战平台，游戏客户端需要进行如下修改：n 安装时将安装路径写入注册表特定的键值；n 支持通过命令行方式启动游戏，并接收传来的帐号密码等信息；n 启动游戏后只能看到为浩方开设的专区；n 相关嵌入页面和Logo应换用浩方提供的页面和Logo；具体要求或未尽事宜，以双方的合作协议为准。附录1：浩方帐号认证接口参见浩方帐号认证服务说明.doc。附录2：游戏插件程序需要了解的信息l 游戏提供方需提供如下信息：取值示例是否必须游戏安装路径的注册表键HKEY_LOCAL_MACHINESoftwareGameCompanyGameNamepath是游戏启动程序的文件名GameLoader.exe是启动游戏的命令行参数GameLoader.exe -u:帐号 -p:密码是如何获知游戏的版本号注册表、INI文件或文件版本号等否游戏设置程序的文件名GameSetting.exe否l 浩方游戏运营部门需提供如下信息：取值是否必须游戏