[教学设计]浩方对战平台第三方游戏接入技术说明文档

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