视频直播录制功能,是将直播中心接收到的推流数据进行录制,并将录制后的文件按配置的录制规则存储至阿里云OSS指定的存储位置。支持将直播流录制成M3U8、MP4、FLV、CMAF格式的视频文件。本文为您介绍录制存储至OSS的操作指引。
前提条件
您已创建OSS Bucket。具体操作,请参见配置OSS。
OSS Bucket必须与域名的直播中心同地域,不支持跨地域录制。
背景信息
如果您需要在直播结束后再次观看或修改直播内容,可使用视频直播提供的直播录制功能。直播录制存储至OSS需配置录制模板,录制模板需要对录制文件的输出格式(M3U8、MP4、FLV、CMAF)、存储位置、录制周期以及是否进行转码流录制等相关参数进行配置。
同一路直播流不能同时选择录制到OSS和录制到VOD,只能选择一种方式存储。关于录制存储至VOD,请参见录制存储至VOD。
配置录制模板
- 登录视频直播控制台。
在左侧导航栏选择功能管理>直播录制,进入直播录制页面,选择存储至OSS配置页签。
选择待配置的播流域名。
单击添加。
配置录制模板。
表 1. 录制模板参数
参数
描述
AppName
视频的应用名称,输入的AppName必须与直播推流地址的AppName保持一致,方可生效。如果您想要进行域名级别录制,输入星号(*)可。
StreamName
存储至OSS支持流级别的录制。您只需输入指定的流名称即可。如果您想要进行全部流录制,即该AppName下的流全部录制,输入星号(*)可。
说明AppName与StreamName参数支持英文、数字、短划线(-)、下划线(_)符号,长度限制在255字符以内。
AppName与StreamName参数如果使用(*)号需注意
(*)号不能匹配任意字符串,只能通配当前已有的应用名称或流名称。
(*)号无法在字符串中进行通配。
存储位置
选择存储位置。
说明存储Bucket列表中包含标准Bucket和媒体Bucket。标准Bucket是OSS Bucket,用于存储。媒体Bucket是MPS定制的Bucket,存入媒体Bucket中的视频,可执行MPS转码任务。目前Bucket列表中,未对Bucket做区分。如果您需要将视频转成媒体文件,需要自行记住对应的媒体Bucket的名称,方便您后期视频转成媒体文件存储位置的选择。
断流拼接时长
直播断流时长超过设定的拼接时长后,将会生成新文件,断流拼接时长支持15~21600秒。
存储格式
支持flv、m3u8、mp4、cmaf四种格式。
说明至少配置一个存储格式,其中CMAF格式不能与M3U8格式同时选择。
存储规则
默认的存储路径为
M3U8:record/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime }
TS:record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
FMP4:record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
MP4:record/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime }
FLV:record/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime }
示例
AppName为liveApp****,StreamName为liveStream****,当录制m3u8格式的存储路径为record/liveApp****/liveStream****/{EscapedStartTime}_{EscapedEndTime }。
单个TS时长
单个切片时长,默认为30秒。支持单个TS时长范围5~30秒。
录制周期
录制周期范围为15分钟~360分钟,最大支持6小时录制。超过6小时,系统将按照录制命名规则生成新文件。
说明录制周期为当前直播转为点播文件后的最大时长。
表 2. 录制转码流参数
参数
描述
录制转码流
打开录制转码流开关,配置参数。
存储格式
支持flv、m3u8、mp4、cmaf四种格式。
说明至少配置一个存储格式,其中CMAF格式不能与M3U8格式同时选择。
存储规则
默认的存储路径为
M3U8:transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime }
TS:transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
FMP4:transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
MP4:transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime }
FLV:transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime }_{EscapedEndTime }
示例
AppName为liveApp****,StreamName为liveStream****,转码模板ID为lld,当录制m3u8格式的实际存储路径为transcodeRecord/liveApp****/liveStream****_lld/{EscapedStartTime}_{EscapedEndTime }。
单个TS时长
单个切片时长,默认为30秒。支持单个TS时长5~30秒。
录制周期
录制周期范围为15分钟~360分钟,最大支持6小时录制。超过6小时,系统将按照录制命名规则生成新文件。
说明录制周期为当前直播转为点播文件后的最大时长。
转码模板ID
支持选择指定转码模板(上限10个)或全部转码模板。
转码模板所属AppName需和录制模板保持一致才可生效,若无转码模板,请先添加转码模板,请参见通用转码。
单击确定。
配置录制回调
您还可以通过AddLiveRecordNotifyConfig接口添加域名级别录制回调配置,请参见添加直播录制回调配置。
回调方式和回调内容,请参见回调管理。
- 登录视频直播控制台。
在左侧导航栏选择功能管理>直播录制,进入直播录制页面,选择存储至OSS配置页签。
选择待配置的播流域名。
单击修改配置。
在弹出的回调设置窗口中,输入需要配置的回调地址(回调地址为您自身拥有的地址)。
单击确定完成回调设置。
关闭录制服务
如果您不需要使用该服务,可以删除已添加的录制模板,即可关闭录制服务。
删除模板时若直播已开始,会继续按照删除前的模板录制,删除录制模板会在下次推流时生效。
常见问题
后续步骤
您可以查看和管理保存至指定OSS存储位置的录制文件,请参见录制文件管理。
如果您需要剪辑已录制存储至OSS的文件,请参见直播流剪辑与录制文件剪辑。
相关文档
如果您需要对直播流的内容进行剪辑加工,还支持您录制存储至VOD,详情请参见录制存储至VOD。
相关文档
更多直播录制详细说明,请参考直播录制。