使用 Wowza 录制直播流 HTTPLiveStreamRecord

                        直播录制，从前的一个免费的插件，已被作为一个提供更多录制直播流为点播文件的接口纳入 Wowza Media Server 3.5。这一功能可以让你使用基于 web 的用户接口，HTTP URL 查询或者以编程方式控制直播流的录制过程。包含有强大的 API 以支持分割进程中的直播流到 MP4 文件或者 FLV 文件，支持基于视频时间，时钟时间或者文件大小的切割点。
        说明：

• 我们建议你安装最新的 Wowza Media Server 以获得对直播流录制的最新补丁和功能加强。下载后，安装指南查看压缩包中的 README.txt 文件。
• 你还可以下载示例模块来了解如何使用 API 创建模块(下载 LiveStreamRecordExampleModule_3.5.zip)。查看压缩目录中的README.html 文件获得更多说明。
  
• 本文适用于 Wowza Media Server 3.5 或以后的版本。查看 Wowza Media Server 之前版本的 LiveStreamRecord 插件包可以查看 如何获得LiveStreamRecord 插件、API 和示例。
  

         先决条件
        定义身份验证方法

        可以在 %Wowza%/conf/VHost.xml 文件中激活 Wowza Media Server 的直播录制功能。VHost.xml 中默认的关于直播录制的配置如下：

<HTTPProvider> <BaseClass>com.wowza.wms.livestreamrecord.http.HTTPLiveStreamRecord</BaseClass> <RequestFilters>livestreamrecord*</RequestFilters> <AuthenticationMethod>admin-digest</AuthenticationMethod></HTTPProvider>

        AuthenticationMethod 属性定义了用于控制连接到这台 HTTP 服务器的访问的验证方法。默认值admin-digest 定义了用于远程计算机连接到基于 web 的直播流录制用户接口时的摘要式身份验证。要使用这个验证方法，你必须在%wowza%/conf/admin.password 文件中为数字验证定义一个用户名和密码。使用文本编辑器打开这个文件并新添加一行用户名和密码。例如，要添加用户名myuser 和密码 mypassword：

# Admin password file (format [username][space][password])#username passwordmyuser mypassword

        要关闭 HTTP 服务器的访问验证功能，使用文本编辑器打开 VHost.xml 并将 AuthenticationMethod 属性值改为 none。如果你想使用远程电脑通过基于 web 的界面访问它的话，并不建议这样做。
        发布直播流
        在录制可以 VOD 回放的文件之前你需要配置一个直播应用，然后将其发布。详细情况在《 安装并使用 Wowza 发布你的 RTMP 直播流》中已说明，本文不再赘述。
        支持的文件格式
        直播流的录制支持将直播流录制为 MP4 文件或者 FLV 文件。
        直播流必须以以下音视频格式编码以录制为 MP4 格式：
        视频

• H.264

        音频

• AAC
• MPEG-1 Layer 3 (MP3)
  
• Speex
  

         通过基于 web 的用户接口录制直播流
        Wowza Media Server 包含有一个基于 web 的用户接口进行录制直播流为点播文件的基本选项。你可以使用本地的或者远程电脑通过 UI 来控制录制过程，定义何时开始录制，何时停止，文件名以及保存位置，视频文件格式以及其他一些细节。将直播流存档为多个文件，并且切割点基于视频时间，时钟时间或者文件大小，可以：

1. 确保你已经满足所有先决条件。更多信息参考 先决条件 部分。
2. 启动 Wowza 多媒体服务器。更多信息，参考 启动和停止服务器(独立) 或者 启动或者停止服务器(系统服务)。
   
3. 通过 Wowza 多媒体服务器，或者一台远程计算机，在浏览器中打开这个 URL：http://[wowza-ip-address]:8086/livestreamrecord。
   
4. 在 Live Stream Record 页面中，点击 start recording。
   
   
           点击 start recording 后，弹出 Start Recording 对话框。
   
   
5. 在 Start Recording 对话框里，定义如何按需录制直播流。

录制直播流到单一文件
        在 Action 中，选择 Start Recording 来录制直播流到点播文件(这是默认设置)。然后在 Recording Options 中，选择以下选项来定义当直播流重启时要做的事情：

• Version existing file 直播流重启后录制到一个新的文件里(这是默认设置)。例如，如果你在录制直播流到myStream.mp4 文件中，直播流重启之后会录制到一个新的名为 myStream_2013-05-12-15.08.10.645-PDT_0.mp4 文件中。
• Append to existing file 直播流重启后，录制追加到现有文件(比如 myStream.mp4)。
  
• Overwrite existing file 直播流重启后以一个同名的新文件将现有文件覆盖掉(比如 myStream.mp4)。
  

         将直播流录制到多个文件
        把直播流录制到多个点播文件，选择以下选项来定义如何切割录制文件：

• 定义切割文件的最大值，在 Action 中，选择 Start Recording Segment By Size。然后在Segment Size 中定义文件最大值，单位是百万字节(MB)。默认大小为 10 MB。
• 定义切割文件最长时间，在 Action 中，选择 Start Recording Segment By Duration。然后在egment Duration 中定义最长时间：<hours>:<minutes>:<seconds>.<milliseconds>。默认值为 15 分钟(00:15:00.000)。
  
• 按照预定计划分割文件，在 Action 中，选择 Start Recording Segment By Schedule。然后在Segment Schedule 中使用 crontab 表达式来定义计划参数。默认值以每个小时的起始时间分割文件。
  

        6.  (可选)。在 Start Recording 对话框中，你可以为录制的文件定义输出选项。在 Custom Output Path and File Name 区域中，点击 Enable，然后配置以下选项：

• Stream Format 选择录制文件的格式，只能是 MP4 或者 FLV。默认为 MP4。
• Path 定义录制文件存储在电脑的物理路径。默认情况下，文件存放在 %wowza%/conte