配置录制模板
直播服务支持将直播内容进行录制并将录制的视频存储至VOD中,您可以在VOD中对录制的直播视频进行下载、分享等处理。
直播录制至VOD的相关操作流程,如图1所示。
- 添加点播域名:在VOD中管理录制文件,需要先开通视频点播服务,并添加点播加速域名,具体请参见VOD快速入门。
- 配置录制模板:为直播配置录制规则,配置完成后,与推流地址中的AppName和StreamName相同的录制模板生效,录制视频按录制设置存储至VOD中。还可以通过设置回调地址获取录制状态通知。
- 推流:录制规则配置完成后,获取推流地址进行直播推流,直播服务会根据配置的录制规则对正在直播的视频进行录制。
- 管理录制文件:直播录制完成后,可以在直播服务中获取录制文件基本信息,也可以在VOD中管理录制文件,如预览、下载、分享、删除、发布、转码和播放等。
录制文件的分辨率与推流分辨率相关,按推流原分辨率进行录制。
注意事项
- 此功能仅支持“华北-北京四”区域使用。
- 录制规则配置支持域名级、应用级和流级,优先生效细粒度配置(即流级别最优先),同级配置不支持多种录制类型。
- 直播服务不支持清理录制内容,仅记录直播录制事件,且直播录制事件的数据只保留30天。
- 直播录制过程中,若直播推流因网络抖动等问题中断,则直播服务将中止录制。当推流重新启动时,直播服务将重新开启新的录制任务。
- 配置录制后,启动推流即开始录制,结束推流才可停止录制,暂无法按需停启;若在推流过程中删除录制规则,录制仍然会继续,直到推流结束 。
- 仅支持对接收到的源直播流进行录制,暂不支持录制直播转码流。
前提条件
费用说明
- 直播录制费用:由视频直播服务收取,详情请参见直播录制费用。
- 视频存储费用:直播录制生成的视频文件最终是存储在VOD中的,因此产生的存储费用由VOD收取,详情请参见视频点播-产品价格详情。
步骤二:配置录制模板
若您需要对直播流进行录制回看,请配置直播录制规则。配置完成后,与推流地址中的AppName和StreamName相同的录制模板生效。
- 登录视频直播控制台。
- 在左侧导航栏中,选择 ,进入域名管理页面。
- 在需要创建录制规则的推流域名行,单击“管理”。
- 在左侧导航树中,选择“模板配置 > 录制配置(新版)”,进入录制配置页面。
- 单击“新建录制”。
- 请您按照实际需求配置录制参数,参数说明如表1所示。
图2 配置录制参数
表1 录制参数说明 参数名
描述
录制类型
- 自动录制:录制模板配置完成后,只要有满足该录制规则的直播流推送即开始录制。
- 手动录制:录制模板配置完成后,在有满足该录制规则的直播流推送后,您可以通过调用提交录制控制命令接口控制该直播流录制的启动与停止。
说明:- 录制模板配置完成后不支持修改录制类型。
- 手动录制需要直播流已推送的情况下才能成功调用接口启动录制。
- 手动录制仅支持流级别的启停控制,即使创建的录制规则为域名级别,下发启停控制命令也需要指定具体流名。
- 手动录制任务的停止方式包含直接调用接口停止和直播断流(若设置了最大断流合并时长,则会在断流后等待配置的最大断流合并时长结束后才停止任务)。
- 手动下发停止录制命令后,录制任务仍需要一定的时间进行资源清理操作,若短时间内对该直播流继续发送启动命令,接口可能会提示录制任务未完成。
AppName
应用名称,默认为“live”,可以根据实际需求进行自定义,支持大小写字母、数字、下划线(_)中划线(-)。若填写为“*”,则录制规则适用于该域名下的所有应用。
流名
直播流名称。若填写为“*”,则录制规则适用于该AppName下的所有直播流。
存储位置
录制文件转存储的位置。
请选择:视频点播服务(VOD)。
转码模板组名称
输入在VOD中配置的转码模板组名称。
用户可以VOD中自定义新增转码模板组,也可以使用已有转码模板组,相关操作请参考转码设置。
录制格式
录制文件的格式,支持将直播视频录制为HLS、FLV和MP4三种文件格式。
HLS规则
录制周期:录制时长支持15-720分钟,最大录制周期为12小时,超过12小时,系统将按照命名规则生成新的m3u8文件。
最大断流合并时长:
- 断流后生成新文件:是指录制的直播流中断后,会立即生成新的录制文件。HLS不支持此选项。
- 断流后不生成新文件:是指录制的直播流中断后,重新推流,会和之前录制的文件合并为一个文件。
- 其他数值:是指录制的直播流中断时间在设置范围内,则和之前录制的文件合并为一个文件,否则,生成新的录制文件。最大断流合并时长为300秒。
FLV规则
录制周期:录制时长支持1-360分钟,最大录制周期为6小时,超过6小时,系统将按照命名规则生成新文件。
最大断流合并时长:
- 断流后生成新文件:是指录制的直播流中断后,会立即生成新的录制文件。
- 其他数值:是指录制的直播流中断时间在设置范围内,则和之前录制的文件合并为一个文件,否则,生成新的录制文件。
MP4规则
录制周期:录制时长支持1-360分钟,最大录制周期为6小时,超过6小时,系统将按照命名规则生成新文件。
最大断流合并时长
- 断流后生成新文件:是指录制的直播流中断后,会立即生成新的录制文件。
- 其他数值:是指录制的直播流中断时间在设置范围内,则和之前录制的文件合并为一个文件,否则,生成新的录制文件。
直播推流正常的情况下,HLS格式的录制文件生成的时间跟推流端的GOP相关,默认在3个GOP(6秒)后生成第一个录制文件。FLV和MP4格式则在一个录制周期完成后才生成一个录制文件。
“最大断流合并时长”的配置影响录制回调中RECORD_FILE_COMPLETE回调的生成,具体如下:
- 断流后不生成新文件:录制至VOD时,不支持此功能。
- 断流后生成新文件:每次断流后都会生成新的录制文件,并收到该录制回调。
- 其他数值:根据断流设定的时间,断流超过设定时间或者录制时间达到录制周期时生成录制文件,并收到该录制回调。
- 单击“确定”,在录制列表中增加一条录制规则。
您可以创建多条录制规则,直播录制时,与推流地址中的AppName和StreamName相同的录制规则生效。
- 录制规则配置完成后,您可以获取推流地址开始直播推流。推流相关操作请参见快速入门。
直播服务会根据配置的录制规则对正在直播的视频进行录制,生成的原始录制文件的分辨率及码率与直播源流保持一致。
直播录制完成后,您可以在视频直播或视频点播服务中管理录制文件,如预览、下载、分享、发布、转码和播放等。
修改/删除录制模板
录制模板配置完成后,您还可以根据实际需要进行如下操作。