wickenden的博客

如何使用文档和示例本文档提供了如何从提供的SmartFoxServer 2X（aka SFS2X）文档获得最佳的快速教程。我们的第一个建议是在进行示例和技术文档之前咨询本节中提供的文章。无论你是一个经验丰富的SmartFox开发人员，还是刚刚在多人游戏世界中移动你的第一步，你会发现最初的文章特别有用的开始。入门部分将指导您在客户端和服务器设置阶段，而高级主题部分提供有关新的扩展系统，服务器API和更

»扩展API在本文中，我们将介绍Extension API中最有用的元素，以及如何利用服务器端框架和随附的javadoc。 »BaseSFSExtension与SFSExtension我们提供两个类作为主扩展类的基本类型：BaseSFSExtension和SFSExtension，它们都位于com.smartfoxserver.v2.extensions包下。前者主要用于与SmartFoxServ

注册助手组件大多数在线应用程序需要注册过程，允许新用户在系统中注册一个帐户。通常，opearation还需要填充一些配置文件设置，用于安全目的的激活系统和密码恢复机制。注册助手组件提供了一个高度可定制的API，可帮助开发人员创建数据库驱动的注册系统，而不用编写自己的数据库访问代码。该组件是从版本2.7.0开始的SmartFoxServer 2X的一部分。在这个多部分教程中，我们将探讨该组件提供的许多

»登录助手组件几乎每个应用程序都需要基于密码的用户访问，并且编写处理客户端参数的代码并且对数据库进行检查是相当乏味且重复的。Login Assistant组件是一个帮助类，可帮助开发人员创建数据库驱动的登录系统，而无需编写自己的数据库访问代码。简而言之，这是如何工作的：在应用程序的区域中配置DBManager在扩展的init（）方法中实例化组件配置组件»部署Login Assistant组件如

服务器端扩展SmartFoxServer 2X扩展在SmartFoxServer Pro的许多方面得到了重新访问和改进。我们将注意力集中在Java扩展开发上，并且已经放弃了对脚本语言的支持。主要原因是：性能：用Java编写的扩展程序比任何脚本语言（如Javascript或Python）都要好一些数量级。随着面向企业级应用程序的新型服务器架构，动态语言的使用将很快成为瓶颈。我们仍然认为，剥皮是快速原型

高级扩展开发在本文中，我们讨论扩展开发的高级方面：服务器线程模型自动负载平衡线程池调优线程池维护扩展中的状态类加载架构延迟和计划的任务自2.9.0起 »服务器线程模型 注意：对于SFS2X 2.8.x及更早版本的所有用户，请参阅旧的线程模型文档。SmartFoxServer 2X在多线程环境中运行所有Extensions。在扩展上基本上有两个独立的线程池：ExtensionContr

好友列表APISmartFoxServer 2X提供了一套新的客户端和服务器API，专门用于管理好友和好友列表，包括持久性，自定义状态，在Buddy系统中上线/离线的能力，运行时和持久性Buddy变量，服务器端事件等。新的Buddy API（3.0版）松散地基于以前的SFS 1.x Buddy List框架，尽管我们现在提供了一种更简化的方法，更好的灵活性和更高级的功能。如果您熟悉以前的系统，您将注

自从SmartFoxServer 2X版本2.8以来，我们引入了一种新型的Room对象，即MMORoom，它支持用户和游戏对象之间的本地交互。 »概述MMORoom通过添加感兴趣区域（简称AoI）来扩展常规房间的功能，以确定用户将收到的事件的空间范围。 AoI参数表示用户将彼此影响的区域，例如发送公共消息，更新用户变量等时。默认情况下，当用户进入或离开房间时，MMORoom不会触发常规的USER_

高级使用MMORoom和MMO API本文要求您已经熟悉SmartFoxServer 2X 2.8版中引入的MMORoom功能。这里我们介绍一些可以从服务器端使用的高级技术。如果您不熟悉MMORooms和MMO API，请务必阅读MMORoom概述。 自定义感兴趣区域（AoI）服务器端MMO API的一个高级方面是使用与MMORoom中配置的AoI小于或等于的自定义AoI的能力。该功能允许限制广播

在线应用程序的一个常见要求是为不同类型的用户提供一组自定义权限。 通常，在线游戏可以处理来宾用户，注册用户和高级用户。 为管理员和/或网站管理员提供个人资料也很常见。SmartFoxServer 2X提供每个区域内的权限管理器，可以自定义以限制与服务器的交互。 每个权限配置文件可以为特定类别的每个用户设置拒绝的API调用列表。 例如，我们可以禁止为访客用户创建房间和房间变量，并且只允许注册用户使用。

SmartFoxServer 是专门为Adobe Flash设计的跨平台socket服务器，让开发者高效地开发多人应用及游戏. 该服务器主要用来创建多玩家游戏。并提供强大的制作工具，各种回合制游戏和实时游戏都可以胜任。 SmartFoxServer 支持的播放器从Flash player6版到最新的Flash Player 9，并提供丰富的Actionscript 1.0, 2.0 and 3.0

SmartFoxServer 2X迁移迁移服务器的过程发生在安装使用完整安装程序而不是补丁分发的主要新版本时。两者之间的区别在于，次要版本是作为可以应用于多个先前版本的补丁而提供的，而不需要重新安装。每隔一段时间，当新版本包含主要更新时，我们将发布一个完整的安装程序，无法安装在以前的版本之上。您应该将SFS2X安装在新文件夹中，并从之前的安装中迁移配置。 »从SmartFoxServer v2.9

客户端API设置本文档提供了有关为SmartFoxServer 2X中支持的所有客户端技术设置客户端开发环境的分步说明。请查看本文档以获取有关客户端API的介绍性信息。以下说明参考SFS2X下载页面上作为单独软件包提供的最新版本的API。始终在您的项目中使用最新版本！如果这是您第一次设置客户端API，我们还建议您查看下载页面提供的示例的源代码。转到你选择的语言：ActionScript 3 API（

管理工具（也称为AdminTool）是SmartFoxServer 2X远程监控和管理的强大应用程序。其主要特点是：所有服务器设置的高级视觉配置，包括区域和房间;强大的运行时监控工具，可以检查实时服务器上的区域，房间和用户，拥有先进的房间和用户过滤功能，统计数据等;完整的运行时数据，一览显示实时服务器状态，让管理员严格控制服务器性能;高级控制台进行深度流量分析，包括访问，独特和新访问者，新访问

BlueBox是一种基于HTTP的技术，允许客户端在防火墙和代理之间进行连接，当插座连接不可用时。这是企业办公室，学校和其他机构的典型情况，其中网络流量仅限于几个选定的服务。BlueBox使玩家受到限制的网络配置，玩和享受快速的多人游戏应用程序和游戏，几乎没有显着的性能损失。所有SmartFoxServer应用程序都可以利用BlueBox，而不需要任何代码更改。在幕后，BlueBox使用所谓的HTT

RedBox是SmartFoxServer 2X的免费附件，可将音频和视频流功能添加到服务器，从而可以将这些功能集成到任何现有的ActionScript3应用程序中。RedBox由三个主要组件组成：用于音频/视频流和录音的开源Red5媒体服务器;一套专门的客户端ActionScript3 API，提供高级功能来启动一对一视频聊天，创建实况事件（一个广播者，多个订阅者），检索媒体文件，执行远程录音等

写第一个Extension扩展是SmartFoxServer 2X的一个基本元素，它们为开发人员创造了一个无限可能的世界，创建自己的游戏逻辑并集成其他技术来支持他们的项目。为了绘制并行，我们可以将扩展视为与开发所有“业务”逻辑的网页的服务器端代码相当的。如果您对Java或任何其他面向对象语言（ActionScript 3，C＃，C ++等）具有中间的了解，那么开始撰写第一个Extension将很容易

数据库配置在本节中，我们将演示SFS2X与外部数据库之间的集成示例。我们使用MySQL的所有食谱，但您可以轻松地使用您选择的任何其他数据库（请阅读本教程）。我们在所有代码中使用标准SQL，因此可以将其移植到任何其他RDBMS。自定义登录数据库查询数据库和发送结果集多个DB连接配方＃1 - 使用数据库自​​定义登录该配方讨论了您需要根据存储在数据库中的用户配置文件验证客户端凭据的常见情况。我们还

SmartFoxServer 2X平台堆栈在本文中，我们在SmartFoxServer 2X平台上进行鸟瞰图，并简要讨论堆栈中的每个组件。从服务器的核心开始，我们找到网络引擎（代码BitSwarm），这是为SmartFoxServer 1.x构建的原始套接字引擎的第三个化身。此层为SFS2X提供了通常在其他竞争对手的解决方案中找不到的独特功能（我们在单独的综合白皮书中讨论所有技术细节）。本质上，Bi

SmartFoxServer 2X功能概述SmartFoxServer 2X采用核心SmartFoxServer理念，并向新方向扩展，引入了数百个改进，并专注于几个精确的目标：简单的使用，多功能性和性能。使用简单：我们已经清理了以前版本的SmartFoxServer的所有不必要的复杂性，使客户端/服务器API更直观，简化和更丰富。通用性：我们重新设计了架构的部分，使其在很大程度上更灵活。反过来，这有

SmartFoxServer 2X客户端 - 服务器协议SmartFoxServer 2X使用高效率的二进制协议，使服务器性能在不同方面突出。消息在带宽上很轻，并且由客户端和服务器引擎快速解析。附加的即时压缩允许额外的尺寸减小而不影响一般性能。这是使用基于XML的SmartFoxServer 1.x协议和SmartFoxServer 2X二进制协议的对象传输的示例：»SmartFoxServer 1

»区和房间建筑SmartFoxServer 2X针对SmartFoxServer 1.x引入了区域和房间配置方式的重大改进。 特别是我们建立了一个新的简单概念，称为房间组，允许将房间组织成逻辑组，彼此分离。 用户将能够订阅他们感兴趣的群组中发生的事件，忽略所有其他群组。这种方法的主要优点是由服务器发送的初始房间列表将更小，并且向每个客户端发起的事件的数量被大大减少，特别是在高流量应用的情况下。一个例

»SmartFoxServer 2X HOWTOs在本文档中，我们收集了一些关于如何完成在使用SmartFoxServer 2X过程中可能需要的简单和特定任务的快速教程。如何添加新的Java库或扩展名依赖关系如何设置与外部数据库的连接如何创建基于扩展的自定义登录如何使用SmartFoxBits 2X如何检查服务器日志如何调试扩展如何在扩展程序中调度定时任务如何从扩展程序发送电子邮件更

»配置日志记录系统SFS2X提供了存储在{SFS2X} / logs /文件夹下的服务器活动和运行时错误的详细日志。尤其是：logs /包含主服务器日志logs / boot /包含与服务器启动阶段相关的特定消息。如果SFS2X无法启动，您应该检查此文件夹中出现了什么问题。logs / http /包含相对于嵌入式Jetty http服务器和BlueBox隧道系统的日志。»配置日志记录级别有三

重新连接HRC +由于SmartFoxServer 2X版本2.5（及更高版本）引入了高弹性连接系统（HRC +）的改进版本，使得玩家可以在突然断开连接后重新加入服务器，而不会丢失其当前状态。在本文中，我们将讨论HRC +可以节省大量开发工作的方式，技术方面的做法以及如何配置和测试。 为什么我断开连线？在本地网络开发和测试时，意外的断开连接是非常罕见的事情，但是当我们终于上网时，可能会发生几个可能

协议加密从2.10版开始，SmartFoxServer 2X支持连接加密，允许使用标准TLS协议保护所有通信。在本文中，我们将讨论加密流量如何在SmartFoxServer中运行的基础知识，如何在服务器上设置X.509证书，如何测试连接以及某些特定于平台的笔记。注意：自从2.9.x版本以来，websocket客户端已经支持SSL，在本文中，我们仅讨论SSL TCP套接字。对于websockets，请

介绍发展基础在本节中，我们将引导您了解使用SmartFoxServer 2X的多人开发的基本概念。从一般的角度看，无论多人游戏，MMORPG，MMORTS，虚拟世界等多种游戏类型，多人游戏和应用都非常相似。 实质上，它们都包括通过持久连接（使用TCP协议）连接到负责维护游戏状态并使玩家彼此同步的中央服务器的客户端。在SmartFoxServer下，我们使用Zone的概念来表示专用于特定应用程序的服

»连接阶段与SFS2X的连接分两步执行。 物理TCP连接打开到服务器 在客户端和服务器之间执行交换一定数量参数的“握手”在握手期间，服务器会验证是否支持客户端API版本，并发回客户端本地存储的一些设置。ActionScript 3代码的以下代码段来自示例程序包中可用的Connector示例（其他语言提供了类似的示例）。public class Connector extends Sprite{

»登录阶段我们在上一章中已经看到如何开始与SmartFoxServer的连接，并提到在客户端可以开始与服务器API和其他用户进行交互之前，必须先登录一个Zone。为了看到服务器中可用的区域并创建新的区域，您可以使用SFS2X管理工具。在工具的左侧栏中选择“区域配置器”，并显示所有区域的列表。从这里，您可以双击（或选择并单击编辑按钮）任何区域名称，然后继续进行区域设置的配置。有关使用说明，请参阅Zon

»加入并创建房间SFS2X框架中的一个基本构件是Room对象。客房允许安排玩家，以便他们可以“看到”彼此并在一起互动。房间的典型用途是在聊天应用程序中创建不同的类别，在虚拟世界中的不同会议地点或在各种游戏中挑战其他朋友的不同地方。客房以两种不同的方式创建。静态地：通过AdminTool中的Zone Configurator模块。这是在您的区域（例如，大厅）中创建永久性房间的一种有用的方法，它们在启动

白皮书本页链接了许多白皮书，旨在教育读者了解多玩家游戏和应用程序创建的不同方面。 特别是他们应该帮助公司在游戏/应用开发的所有阶段做出正确的决策，从初始分析和设计到测试结果的解释。SmartFoxServer 2X性能和可扩展性(Server Architecture) 下载http://www.smartfoxserver.com/downloads/sfs2x/documents/SFS2X_

房间建筑Room对象是任何多人应用程序结构中最重要的构建块之一。它负责将用户分组和连接在一起，并使他们相互交互。从开发人员的角度来看，它提供了有助于构建应用程序逻辑的有用事件，每个房间都可以由不同的服务器端扩展来管理。在本章中，我们将剖析由Room对象提供的许多功能以及SFS2X框架中提供的新功能。 »一般建筑我们在本文档的其他文章中提到了SFS2X中的新关键元素，房间组：上面的图表应该说明这些房

服务器变量SmartFoxServer 2X框架提供不同类型的服务器变量，可用于在Buddy列表中的用户，客户和好友之间维护同步状态。服务器变量通常允许客户机或服务器逻辑创建自动更新的范围内的自定义值。服务器变量的三种主要类型有不同的范围：用户变量：它们表示连接到单个用户的自定义数据。所有更新由用户在所有者加入的同一个房间中接收。换句话说，一个名为Piggy的用户将可以访问并获取有关用户Kermit

»SFSObject和SFSArraySmartFoxServer 2X引入了两个基本类SFSObject和SFSArray，它们是客户端和服务器之间操作和传输数据的核心。这两个类在所有语言（包括服务器端API）的所有API中是常见的，使得将代码移植到任何平台和应用程序的每一侧都非常容易。SFSObject和SFSArray表示一个平台中立的高级对象，用于抽象客户端和服务器之间的数据传输。它们用于分

故障排除指南在本指南中，我们提供了一些技巧和技巧来克服在设置或运行服务器时遇到的典型问题。无法到达服务器Flash跨域政策问题服务器启动问题删除邮件鬼用户»无法到达服务器一个常见的运行时问题是在首次安装后无法连接到测试或生产服务器。一旦您的SFS2X实例正在运行，您应该确保没有防火墙（软件或硬件）阻止正在使用的TCP端口。具体来说，您应该将TCP端口9933和8080打开到“世界”。如果这