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

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