音频和视频流SmartFoxServer 2X

RedBox是SmartFoxServer 2X的免费附件，可将音频和视频流功能添加到服务器，从而可以将这些功能集成到任何现有的ActionScript3应用程序中。

RedBox由三个主要组件组成：

用于音频/视频流和录音的开源Red5媒体服务器;
一套专门的客户端ActionScript3 API，提供高级功能来启动一对一视频聊天，创建实况事件（一个广播者，多个订阅者），检索媒体文件，执行远程录音等;
一个服务器端SFS2X扩展，它负责处理与客户端API交互期间生成的请求和事件，并将SmartFoxServer功能与Red5服务器集成。

此外，还提供了四个完整的示例供参考：它们演示了RedBox提供的所有功能，以创建视频聊天，视频会议等。

重要的提示
SmartFoxServer团队为除Red5服务器之外的所有RedBox组件提供帮助。无论如何，即使我们不提供具体的Red5技术支持，您可以在上面链接的官方Red5网站上找到任何Red5相关问题。
»组件

RedBox分发为一个包含以下详细描述的组件的单个包。它可以从主要的SmartFoxServer 2X下载页面下载。
软件包中的客户端和服务器文件夹包含您需要设置RedBox的所有内容，并使用提供的示例进行测试;它们还包含您需要开始开发自己的应用程序的库。
Sources文件夹包含所有RedBox组件（Red5服务器除外）和提供的示例的源代码，以防您需要添加自己的功能或自定义现有功能。有关更多信息，请参阅下面的源代码设置段落。
»客户端

API_AS3文件夹：包含要在Flash / Flash Builder项目中使用的RedBox API的SFS2X_RedBox.swc库（请参阅Red5安装并创建自己的RedBox应用程序段落）。
Examples_AS3文件夹：包含编译的示例，以便在安装后立即开始使用RedBox播放（请参阅运行下面的示例段落）。

»服务器

Red5文件夹：包含要安装在您的服务器上的Red5 Media Server 1.0 RC（请参阅下面的Red5安装段落）。
redBox文件夹：包含用于SmartFoxServer 2X的RedBox Extension的jar文件和配置几个RedBox设置所需的redbox.properties文件（请参阅下面创建您自己的RedBox应用程序段落）。
zones文件夹：包含所提供示例的SmartFoxServer 2X Zones定义（请参阅运行下面的示例段落）。

»Red5安装

RedBox需要启动并运行Red5 Media Server实例。为了安装RedBox软件包中提供的Red5版本，只需将/ Server / Red5文件夹从解压缩的软件包复制到SmartFoxServer 2X安装文件夹即可。确保Red5文件夹位于SFS2X文件夹的同一级别。

为了启动Red5，双击red5.bat（Windows）或启动red5.sh脚本（OSX / Linux / Unix）。在OSX，Linux或Unix系统的情况下，您可能会遇到权限问题：只需启用Red5.sh文件上的执行。

注意
我们已经从RedBox包中提供的Red5版本中删除了所有不必要的文件和文件夹，使其不那么混乱，可以进行生产。
另外，我们的Red5发行版附带了一个预装的服务器端应用程序SFS_RedBox，可以在Red5 / webapps下找到。该应用程序非常简单，除了为Red5的流媒体功能提供RedBox API的接入点之外什么都不做。
此外，它还包含流文件夹，Red5用于存储录制的剪辑和临时实时流。默认情况下，该文件夹附带了视频剪辑播放器示例使用的四个视频片段：在生产环境中安装Red5时可以删除它们。
»升级Red5

RedBox适用于Red5 1.0 RC和以前的版本。它很可能会继续使用新版本，但我们不能保证。
如果要升级Red5，请确保将Red5 / webapps下的SFS_RedBox文件夹复制到新的Red5文件夹的相同位置。
»移动Red5

您可以按照以下步骤将Red5移动到其他文件夹甚至专用服务器：

将Red5文件夹复制到新位置或专用服务器;
在单独的服务器的情况下，共享本地网络中的Red5文件夹，以便可以由运行SmartFoxServer的机器访问;
编辑与RedBox扩展名并排的redbox.properties文件（请参阅下面创建您自己的RedBox应用程序段落），并将red5Path值指向Red5文件夹;
启动Red5和SmartFoxServer 2X。

»使用不同的媒体服务器
在理论上，可以使用Adobe Flash Media Server或Wowza Media Server而不是Red5，因为它们都使用相同的协议（RTMP）。然而，RedBox使用了Red5服务器端应用程序（请参阅上面的框），该应用程序应为所选择的替代RTMP服务器翻译。作为一个非常简单的应用程序，它不应该太难以翻译（源代码在RedBox包中可用）。

注意
据报道，Wowza 3.6.3与SmartFoxServer 2X配合使用。唯一需要添加的设置是在[WowzaDir] / applications / SFS_RedBox下添加空应用程序目录。
»运行示例

RedBox软件包包含四个示例，显示其API提供的功能。这些例子在本文档中有详细描述。为了运行它们，首先你必须设置服务器端部分：

按照上一段所述安装Red5;
通过将Redbox软件包中的/ Server / redBox文件夹复制到SFS2X / extensions文件夹来安装SFS2X的RedBox Extension;
通过将/ Server / zones文件夹中包含的文件从RedBox包复制到SFS2X / zones文件夹，配置示例使用的SFS2X区域;只有三个区域被配置，因为其中一个示例使用默认情况下在SFS2X中提供的BasicExamples区域（如果您删除它，只需配置该示例以使用现有的区域）。

服务器准备就绪后，启动Red5和SmartFoxServer 2X，并确保SmartFoxServer在启动过程中不会记录错误。现在转到Redbox包中的/ Client / Examples_AS3文件夹，打开一个子文件夹，然后双击html文件在浏览器中启动该示例。

如果您的SFS2X设置与默认设置不同，则可能需要通过编辑每个示例提供的sfs-config.xml文件来更改客户端配置。
»创建自己的RedBox应用程序

将现场音频/视频流添加到现有的或全新的应用程序非常简单。客户端所需要做的就是：

将SFS2X_RedBox.swc库文件从Redbox包中的/ Client / API_AS3文件夹复制到计算机上的任何位置;
在Flash / Flash Builder项目中引用SWC库（包含RedBox API类）（要求与SmartFoxServer API相同 - 请参阅本文档）;
根据您的应用程序将要导入您需要的正确的RedBox类。

Rebdox API已分为以下主要类别：您应该查看左侧栏中的API文档部分以获取详细信息。

AVChatManager
该课程负责通过连接到Red5服务器的音频/视频聊天实现。 AVChatManager处理聊天工作流（发送请求，接受或拒绝它，建立或停止连接等）以及从/从Red5服务器的直播流。

AVClipManager
该课程负责通过连接到Red5服务器的音频/视频剪辑录制和播放。 AVClipManager处理可用的a / v剪辑的列表，它们的自定义附加属性以及到/从Red5服务器的流。

AVCastManager
该课程负责管理由用户加入的SmartFoxServer Room内的音频/视频直播，可以创建直播Web事件或/ v会议。 AVCastManager处理向/从Red5服务器播放的实时演播。与其他RedBox类不同，AVCastManager可以在Room上工作，以利用SFS客房的访问控制和审核功能。

在服务器端，RedBox API需要将RedBox Extension分配给应用程序的Zone。如果您的应用程序在Zone级别不需要自定义的服务器端编码（换句话说，它不具有自己的扩展名），则可以通过执行以下操作直接使用RedBox软件包中提供的扩展名：

1.将/ Server / redBox文件夹从RedBox包复制到SFS2X / extensions文件夹;
2.在管理工具中配置您的区域扩展（请参阅本文档）：在“主”类下拉列表中的“名称”下拉列表中选择redBox，并选择RedBoxExtension（当然是类型为Java）。

如果您需要编写自己的服务器端扩展，因为SFS2X不允许将多个扩展分配给同一个区域，您可以按照默认的扩展名创建过程（在此描述），而不是使您的主类扩展SFSExtension，使其扩展RedBoxExtension类。为了能够做到这一点，您需要参考服务器端项目中RedBox包的/ Server / redBox文件夹中提供的RedBoxExtension.jar文件。
在部署时，您将需要部署RedBoxExtension.jar文件和redbox.properties文件（Redbox包的/ Server / redBox文件夹中可用）和您自己的扩展名的jar文件。
在这两种情况下（直接使用RedBox Extension或创建自己的子类），redbox.properties文件用于配置一些RedBox设置：

日志：如果设置为1，则启用RedBox服务器端日志记录（以“[RedBox] ...”开头的消息）
enableAVClipManager：如果设置为1，则启用来自客户端AVClipManager类的请求的服务器端处理程序（请参见上文）
enableAVChatManager：如果设置为1，则使客户端AVChatManager类的请求的服务器端处理程序（见上文）
red5Path：Red5文件夹位置的绝对路径或相对路径;如果相对，它必须是相对于SmartFoxServer的SFS2X文件夹
lastModifiedFormat：指定a / v剪辑数据中的“上次修改”日期格式（有关格式代码，请参阅java.text.SimpleDateFormat类构造函数文档）

»源代码设置

RedBox包包含源代码，允许开发人员在需要时进一步扩展其功能。软件包的/ Sources文件夹中提供了所有源文件。

API_AS3文件夹：它包含RedBox API的ActionScript3类。您可以直接在应用程序项目中引用它们，也可以在Flex / Flash Builder中创建一个新的Flex库项目，并将该文件夹的内容添加到项目的src文件夹中以创建自己的SWC文件。您还需要参考SmartFoxServer客户端API才能编译项目。
Examples_AS3文件夹：它包含提供的示例的MXML和ActionScript3源文件。对于每个项目，在Flex / Flash Builder中创建一个单独的项目，并将该项目的src和libs文件夹替换为该文件夹中的文件夹。
Red5WebApp文件夹：它包含表示Red5服务器端应用程序的Java类（请参阅Red5安装段落中的框）。如果新版本的Red5需要更改应用程序的兼容性，这可能是有用的。
要设置开发环境，请在您选择的Jave IDE中创建一个新项目，并将该文件夹的内容添加到项目的src文件夹中。您还需要参考Red5主文件夹中包含的red5.jar库。
要部署此应用程序，请将已编译的类复制到Red5 / webapps / SFS_RedBox / WEB-INF / classes文件夹。有关WEB-INF文件夹中包含的其他文件的更多信息，请参阅Red5文档。
RedBoxExtension文件夹：它包含RedBox扩展的Java类。请阅读可用的文档（从本页开始），了解有关扩展开发和部署的更多信息。

“ 经常问的问题

»使用SmartFoxServer + RedBox有什么优势，而不是直接使用Red5或Flash Media Server？

RedBox提供与SmartFoxServer 2X API的紧密集成，为开发具有嵌入式a / v功能的多人应用程序提供了非常强大的环境。
只有使用Red5或FMS，才能获得高级的房间管理，好友列表，聊天过滤器，安全性等。两台服务器之间的协同作用可以节省数月的发展！

»RedBox使用第二个音频/视频流连接吗？

是。用于与Red5服务器通信的RTMP协议适用于端口1935，其数据流量与SmartFoxServer 2X协议分离。
这种方法有很多优点，主要的是，如果您有非常高的a / v流量，那么您甚至可以为Red5服务器投入一台服务器。

»当SmartFoxServer启动时，Red5是否启动？

否。如果您的应用程序需要RedBox流媒体服务，您必须单独启动它。

哪个版本的Red5与RedBox一起分发？

目前，RedBox包含Red5 1.0 RC的“轻量级”版本，已经清除了默认示例和其他一些文件。
如果您需要原始的附加示例，您可以访问Red5网站并下载完整版本。

»RedBox加载项与Flash Media Server兼容吗？

是的，RedBox是基于实现Adobe RTMP协议的Adobe Flash Media Server的开源替代品Red5 Media Server。

»可以使用Flash Media Server或Wowza Media Server代替Red5吗？

在理论上是的。请阅读使用不同的媒体服务器段落。

»RedBox保留记录的媒体文件在哪里？

这些文件位于Red5安装目录中的webapps / SFS_RedBox / streams文件夹中。

»我可以在单独的专用服务器上运行RedBox加载项吗？

是。请在这里阅读Moving Red5段落。

RedBox项目是否开源？

是的。源代码作为BSD许可证下的可下载软件包分发。
您可以在这里了解有关许可证的更多信息

»您是否提供特定的Red5支持？

我们为RedBox API提供帮助，但我们不提供特定的Red5技术帮助。
您可以在官方的任何Red5相关问题找到帮助

翻译自：http://docs2x.smartfoxserver.com/GettingStarted/redbox