录制存储至OSS

视频直播录制功能,是将直播中心接收到的推流数据进行录制,并将录制后的文件按配置的录制规则存储至阿里云OSS指定的存储位置。支持将直播流录制成M3U8、MP4、FLV、CMAF格式的视频文件。本文为您介绍录制存储至OSS的操作指引。

前提条件

您已创建OSS Bucket。具体操作,请参见配置OSS

说明

OSS Bucket必须与域名的直播中心同地域,不支持跨地域录制。

背景信息

如果您需要在直播结束后再次观看或修改直播内容,可使用视频直播提供的直播录制功能。直播录制存储至OSS需配置录制模板,录制模板需要对录制文件的输出格式(M3U8MP4FLVCMAF)、存储位置、录制周期以及是否进行转码流录制等相关参数进行配置。

重要

同一路直播流不能同时选择录制到OSS和录制到VOD,只能选择一种方式存储。关于录制存储至VOD,请参见录制存储至VOD

配置录制模板

  1. 登录视频直播控制台
  2. 在左侧导航栏选择功能管理>直播录制,进入直播录制页面,选择存储至OSS配置页签。

  3. 选择待配置的播流域名。

  4. 单击添加

  5. 配置录制模板。

    image

    表 1. 录制模板参数

    参数

    描述

    AppName

    视频的应用名称,输入的AppName必须与直播推流地址的AppName保持一致,方可生效。如果您想要进行域名级别录制,输入星号(*)可。

    StreamName

    存储至OSS支持流级别的录制。您只需输入指定的流名称即可。如果您想要进行全部流录制,即该AppName下的流全部录制,输入星号(*)可。

    说明
    • AppNameStreamName参数支持英文、数字、短划线(-)、下划线(_)符号,长度限制在255字符以内。

    • AppNameStreamName参数如果使用(*)号需注意

      • (*)号不能匹配任意字符串,只能通配当前已有的应用名称或流名称。

      • (*)号无法在字符串中进行通配。

    存储位置

    选择存储位置。

    说明

    存储Bucket列表中包含标准Bucket和媒体Bucket。标准Bucket是OSS Bucket,用于存储。媒体Bucket是MPS定制的Bucket,存入媒体Bucket中的视频,可执行MPS转码任务。目前Bucket列表中,未对Bucket做区分。如果您需要将视频转成媒体文件,需要自行记住对应的媒体Bucket的名称,方便您后期视频转成媒体文件存储位置的选择。

    断流拼接时长

    直播断流时长超过设定的拼接时长后,将会生成新文件,断流拼接时长支持15~21600秒。

    存储格式

    支持flvm3u8mp4cmaf四种格式。

    说明

    至少配置一个存储格式,其中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 }

    示例

    AppNameliveApp****StreamNameliveStream****,当录制m3u8格式的存储路径为record/liveApp****/liveStream****/{EscapedStartTime}_{EscapedEndTime }

    单个TS时长

    单个切片时长,默认为30秒。支持单个TS时长范围5~30秒。

    录制周期

    录制周期范围为15分钟~360分钟,最大支持6小时录制。超过6小时,系统将按照录制命名规则生成新文件。

    说明

    录制周期为当前直播转为点播文件后的最大时长。

    image

    表 2. 录制转码流参数

    参数

    描述

    录制转码流

    打开录制转码流开关,配置参数。

    存储格式

    支持flvm3u8mp4cmaf四种格式。

    说明

    至少配置一个存储格式,其中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 }

    示例

    AppNameliveApp****StreamNameliveStream****转码模板ID为lld,当录制m3u8格式的实际存储路径为transcodeRecord/liveApp****/liveStream****_lld/{EscapedStartTime}_{EscapedEndTime }

    单个TS时长

    单个切片时长,默认为30秒。支持单个TS时长5~30秒。

    录制周期

    录制周期范围为15分钟~360分钟,最大支持6小时录制。超过6小时,系统将按照录制命名规则生成新文件。

    说明

    录制周期为当前直播转为点播文件后的最大时长。

    转码模板ID

    支持选择指定转码模板(上限10个)或全部转码模板。

    转码模板所属AppName需和录制模板保持一致才可生效,若无转码模板,请先添加转码模板,请参见通用转码

  6. 单击确定

配置录制回调

说明

您还可以通过AddLiveRecordNotifyConfig接口添加域名级别录制回调配置,请参见添加直播录制回调配置

回调方式和回调内容,请参见回调管理

  1. 登录视频直播控制台
  2. 在左侧导航栏选择功能管理>直播录制,进入直播录制页面,选择存储至OSS配置页签。

  3. 选择待配置的播流域名。

  4. 单击修改配置。

  5. 在弹出的回调设置窗口中,输入需要配置的回调地址(回调地址为您自身拥有的地址)。

  6. 单击确定完成回调设置。

关闭录制服务

如果您不需要使用该服务,可以删除已添加的录制模板,即可关闭录制服务。

删除模板时若直播已开始,会继续按照删除前的模板录制,删除录制模板会在下次推流时生效。

常见问题

直播录制常见问题

后续步骤

相关文档

如果您需要对直播流的内容进行剪辑加工,还支持您录制存储至VOD,详情请参见录制存储至VOD

相关文档

更多直播录制详细说明,请参考直播录制