目录

准备工作

启动 Wowza Streaming Engine 和 Wowza Streaming Engine Manager

对通过Http接口控制录制任务做认证

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

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

<HTTPProvider>
	<BaseClass>com.wowza.wms.livestreamrecord.http.HTTPLiveStreamRecord</BaseClass>
	<RequestFilters>livestreamrecord*</RequestFilters>
	<AuthenticationMethod>admin-digest</AuthenticationMethod>
	<Properties>
		<Property>
			<Name>liveStreamRecordWhitelistRequestIPs</Name>
			<Value>192.168.1.1</Value>
			<Type>String</Type>
		</Property>
		<Property>
			<Name>liveStreamRecordBlacklistRequestIPs</Name>
			<Value>192.168.1.2</Value>
			<Type>String</Type>
		</Property>
	</Properties>
</HTTPProvider>
		

支持的文件格式

查看可用的输入流及其录制状态

1. 请先确认你已经完成了前面介绍的准备工作。要了解它，请阅读前面的准备工作章节。
   
   
2. 在Wowza Streaming Engine本机或一台远程电脑上,用WEB浏览器访问下面的URL: http://[wowza-ip-address]:8088/enginemanager/Home.htm，然后登陆进去。
   
   
3. 在Streaming Engine manager的页面顶部，点击Applications菜单。
   
   
4. 点击左侧的live 菜单，会显示出live应用下的功能菜单。
   
   
5. 点击 incoming streams 菜单。

在Wowza Streaming Engine Manager里对直播流做录制

1. 请先确认你已经完成了前面介绍的准备工作。要了解它，请阅读前面的准备工作章节。
   
   
2. 根据查看可用的输入流及其录制状态的说明，查看live应用下的输入流的状态
   
   
3. 点击Record图标，打开Recording 对话框。
   
   
4. 根据你的需求配置录制参数。默认的配置是将直播流录制为一个MP4文件，文件名就是流的名字。
   
   注意: 在Recording对话框中的这些录制参数同样可以用StreamRecorder properties来配置。

   Recording Tab页

   
   
   Filename - 录制文件的文件名，你可以输入任意一个文件名。但文件名不能包含以下字符: 小于号(<), 大于号(>), 冒号 (: ), 引号 (' and "), 斜杠 (/), 反斜杠 (\), 管道符 (|), 问号 (?), 星号 (*), 双点(..), 以及波浪符(~)。
   
   Path设置一个保存录制文件的物理路径。默认的设置为[install-dir]/content目录。如果你希望设置为另外一个路径，你先要确认这个路径是真实存在的，然后再填上这个路径。路径不能包含以下字符:小于号(<), 大于号(>), 冒号 (: ), 引号 (' and "), 斜杠 (/), 反斜杠 (\), 管道符 (|), 问号 (?), 星号 (*) 。
   
   输出的文件格式 - 录制文件的格式，可以是MP4 (默认值) 或 FLV。
   
   录制选项:
   
   
   • Record data - 如果输入流中包含metadata信息，则将这些信息一并录制到文件中。
     
     
   • Start on keyframe - 录制文件的第一个视频帧是从关键帧开始。
   
   
   

   Segmentation Tab页

   
   
   Segmentation Option设置了如何将直播流录制为多个文件。可以基于文件大小、时长或者一个时间计划:
   
   
   • None - 录制为一个单独的文件(这是默认选项)，不分割。 当录制的文件已经存在时，下面的Versioning Options选型可以设置如何生成新的文件:
     
     
     • Append to existing file - 重新录制的文件数据将会追加到原有的文件上。
       
       
     • Version existing file - 当直播流重新启动后将生成一个新的文件(这是默认的设置)。新文件的名字的依据File Versioning Template的设置。
       
       
     • Overwrite existing file - 重新录制的文件将覆盖原有的文件。
     
     
   • Segment by size - 依据文件的大小来分隔，Segment Size是文件的最大值，到了这个值就会生成一个新的文件。(以MB为单位)。支持的最小值是1MB。新生成的文件的名字依据File Versioning Template的设置。
     
     
   • Segment by duration - 依据文件的时长来分隔，Segment Duration是最大时长(格式为Hours:Minutes:Seconds)。支持的最小值是10秒。新生成的文件的名字依据File Versioning Template的设置。
     
     
   • Segment by schedule - 依据时间计划来分隔，你可以选择以下Segment Schedule选项:
     
     
     • Every hour on the hour - 在每个小时的整点时生成一个新的文件。这是默认设置。
       
       
     • Advanced - 按自定义的时间计划来分隔，格式为crontab表达式。
     
     
     File Versioning Template and File Versioning Module
     
     如果你选择Segmentation Option将直播流生成为多个文件，那么新生成的文件在命名上将遵循一个规则模板，这个规则模板是依据File Versioning Module中的模块生成的，格式填写在File Versioning Template中。要了解更多关于File Versioning Template的信息，请参考用模板类定义录制生成的文件名。 你也可以自己做开发一个自定义模块生成这个文件名，这时，你需要在File Versioning Module中输入这个Module的完整Java类名。
   
   
5. 点击 Record 启动对直播流的录制。

• 如果是按文件大小将将直播流录制到多个文件中，请在Recording对话框的Segmentationtab 页，在Segmentation Options下面选择Start Recording Segment By Size。 然后在Segment Size输入框中，设置一个文件的最大值(MB)。默认是10 MB。
  
  
  
• 如果是按播放时长将直播流录制到多个文件中，请在Recording对话框的Segmentationtab 页，在Segmentation Options下面选择Start Recording Segment By Duration。 然后在Segment Duration输入框中，设置一个文件的最大播放时长hours:minutes:seconds。默认是15 分钟 (00:15:00)。
  
  
  
• 如果是按自定义的时间计划将直播流录制到多个文件中，请在Recording对话框的Segmentationtab 页，在Segmentation Options下面选择Start Recording Segment By Schedule。 然后在Segment Schedule输入框中，按crontab 表达式来设置一个时间计划。默认值是在每一个小时开始时将流录制到一个新的文件中。
  注意:crontab表达式并不能用来让Wowza Streaming Engine启动和暂停录制，它仅仅是针对一个已经处于录制状态的任务，用于将录制数据按时间计划分隔到新的文件中。

直播流录制的相关参数

使用Http接口来录制直播流

http://[wowza-ip-address]:8086/livestreamrecord?app=live&streamname=myStream&action=startRecording

• app=[app-name]
• streamname=[stream-name] (必须是直播流)
• action=startRecording | stopRecording | splitRecordingNow | startRecordingSegmentByDuration | startRecordingSegmentBySize | startRecordingSegmentBySchedule

• option=version | append | overwrite
  
  默认值为version.
  
  
• startOnKeyFrame=true | false
  
  默认值为true。
  
  
• recordData=true | false
  
  默认值为true.
  
  
• outputPath=[path]
  
  默认值为空字符串,这意味着录制的文件将被存储在Wowza Streaming Engine的content文件夹([install-dir]/content)。如果你设置了另一个目录,你必须用绝对路径(例如C:/Content)。同时不要在路径中包含文件名。
  
  
• outputFile=[filename].[extension]
  
  默认值为空字符串,这意味着录制的文件名依据[stream-name]和在format中设置的[extension]来命名。
  
  
• format=1 | 2
  
  1 = FLV and 2 = MP4。默认为2。
  
  
• segmentSize=[megabytes]
  
  默认为10 (10 megabytes).
  
  
• segmentDuration=[seconds]
  
  默认为900 (15 分钟)。
  
  
• segmentSchedule=[crontab string]
  
  请阅读附录:理解crontab表达式以获得更多信息。

http://[username]:[password]@[wowza-ip-address]:8086/livestreamrecord?app=live&streamname=myStream&action=startRecording
		

用Java API LiveStreamRecordManager 控制直播流的录制

• 启动/停止/分割直播流的录制 - (ILiveStreamRecordManager)
  
  
• 获得一个录制任务列表 - (ILiveStreamRecordManager)
  
  
• 注册/注销录制任务管理器LiveStreamRecordManager 相关事件监听 - (ILiveStreamRecordManagerActionNotify)
  
  
• 为录制任务设置各种录制参数 - (IStreamRecorderConstants)
  
  
• 在启动录制时，设置录制参数 - (StreamRecorderParameter)
  
  
• 注册/注销一个具体录制任务相关事件监听 - (IStreamRecorderActionNotify)
  
  
• 获得一个录制任务的详细信息 - (IStreamRecorder)
  
  
• 用自定义程序创建分割文件的文件名 - (IStreamRecorderFileVersionDelegate)

用模版字符串来定义录制直播流后生成的分割文件

• public void setFileTemplate(String template). 设置一个自定义的模版字符串作为文件名。
  
  
• public String getFileTemplate(). 返回当前正在使用的作为文件名的模版字符串。

• 根据文件大小开始新的录制分割
  
• 根据播放时长开始新的录制分割
  
• 根据时钟计划开始新的录制分割

• ${SourceStreamName}. 直播流的StreamName。
  
  
• ${SegmentNumber}. 一个自动增长的数字，代表了被分割的录制片段的顺序,从0开始。
  
  
• ${RecordingStartTime}. 录制开始时间.
  
  
• ${SegmentTime}. 录制片段被创建的时间.

故障排查

• 在你开始对直播流进行录制时，直播流必须已经进入到Wowza Streaming Engine中。
  
  
• 在没有录制完成前，你不能去点播这个录制文件。
  
  
• 直播流的录制API是基于服务端的录制。Wowza不提供在客户端的录制。
  
  
• 当使用SegmentBy* API时，Version参数被启用，并且不能被修改

添加更多的Log信息来验证你的设置是否正确

1. 在管理界面点击live应用。
   
   
2. 在live 应用主界面的Properties tab页，在Quick Links导航条上点击StreamRecorder Defaults。
   
3. 在StreamRecorder Defaults部分，点击Edit。
   
   
4. 点击streamRecorderDebugEnable边上的Enabled复选框，然后将这个参数的值设置为True
   
   
5. 点击Save。
   
   
6. 在live应用主界面右上角点击Restart重启应用。

<Property>
    <Name>streamRecorderDebugEnable</Name>
    <Value>true</Value>
    <Type>boolean</Type>
</Property>
		

comment server INFO 200 - [live/_definst_]StreamRecorder:stopRecorder(): recording stopped: C:\Program Files (x86)\Wowza Media Systems\Wowza Streaming Engine 4.0.0\content\myStream.mp4
		

附录: 理解crontab表达式

• <Minute> - 分钟 (介于0 到 59之间)，在这个时间将开始分割录制文件。
  
  
• <Hour> - 小时(介于0 到 23之间,基于24小时时钟格式),在这个时间将开始分割录制文件。
  
  
• <Day_of_the_Month> - 日期(介于0 到 31之间) ，在这个时间将开始分割录制文件。例如要设置在月的最后一天开始分割录制文件,可以设置为31.
  
  
• <Month_of_the_Year> - 设置开始分割录制文件的月份。你可以设置一个月份的缩写(例如, Jan) 或等同的数字(例如1).
  
  
• <Day_of_the_Week> - 设置在一周的某一天开始分割录制文件。你可以设置一个星期几的缩写(例如, Mon) 或者等同的数字(例如1).
  
  
• <Year> - 设置开始分割录制文件的年份(例如2013).