直播录制

方法一：控制台配置

1. 登录视频直播控制台。

2. 在左侧导航栏选择功能管理 > 直播录制。在录制配置页签，选择存储至VOD。

3. 选择待配置的播流域名，并且单击添加。

4. 配置录制模板。

   基础录制设置

   参数	描述
   AppName	应用名称，必须与推流地址的 AppName 保持一致方可生效。若需对域名下所有应用生效，填写 *。
   StreamName	流名称。支持精确匹配，即录制特定流。若需录制当前 AppName 下的所有直播流，填写 *。
   存储应用空间	录制文件存储在点播服务创建的应用空间。若未开启应用空间，则不显示该字段。
   存储地址	可选择点播服务当前地域下创建的存储地址。默认使用点播系统配置的默认上传地址。
   录制内容	支持录制源流或转码流，两者可同时选择。 选择转码流时，可指定转码模板（上限10个）或选择全部转码模板。 转码模板的 AppName 为*或与录制模板一致时，转码流录制才能生效。
   触发方式	支持通过以下方式触发录制：自动录制、回调确认、推流参数设置、手动录制。 详情请参见录制触发方式。
   存储格式	支持 M3U8、FLV、MP4 格式。选择多格式时，支持按格式分别配置点播视频设置。
   录制周期	单个录制文件的最大时长。当直播持续时间超过此阈值，系统将生成新文件。默认值：180分钟。范围：15-360分钟。
   断流拼接时长	直播中断时，当断流时间不超过此时长，重新推流后的内容会自动合并至同一个文件。当断流时间超过此时长，则录制为新文件。默认值：180秒。范围：15-21600秒。
   单个切片时长	单个 TS 切片的时长。仅选择 M3U8 格式时显示。 默认值：30秒。范围：5-30秒。

   点播视频设置

   存储至 VOD 时，您可通过此设置，使用视频点播的媒体处理能力来处理录制的文件。若您选择了多个录制格式，可按格式分别配置。

   参数	描述
   自动合并	开启后，可在直播录制结束后自动将多个录制周期文件合并成一个录制文件，并存储到 VOD。原录制文件仍然保留。
   视频处理	使用视频点播服务对录制的视频进行媒体处理。 源视频：对每个录制周期文件单独处理。 合并后视频：对合并后的文件进行处理（开启自动合并后显示）。
   处理方式	支持用转码模板组处理和用工作流处理两种方式。
   处理模板	选择从视频点播服务获取的转码模板组或工作流模板。 注意：仅支持选择域名直播中心所在地域创建的模板。
   视频分类	设置录制文件在视频点播服务中的分类。

5. 单击确定创建录制模板。

方法二：API 配置

调用AddLiveRecordVodConfig接口，添加录制存储至 VOD 配置。示例代码：

// Parameter settings for API request
AddLiveRecordVodConfigRequest.RecordFormat recordFormat0 = AddLiveRecordVodConfigRequest.RecordFormat.builder()
        .format("m3u8")
        .sliceDuration(30)
        .autoCompose("ON")
        .videoProcess("origin,compose")
        .processMethod("transcode")
        .processTemplateId("e2d796d3bb5fd8049d32bff62f94****")
        .tags("sports")
        .build();

AddLiveRecordVodConfigRequest addLiveRecordVodConfigRequest = AddLiveRecordVodConfigRequest.builder()
        .regionId("<Your RegionID>")
        .domainName("<Your DomainName>")
        .appName("live")
        .streamName("stream1")
        .cycleDuration(3600)
        .spaceId("app-1000000")
        .storageLocation("<Your StorageLocation>")
        .onDemand(0)
        .recordContent("raw,transcode")
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

部分参数说明

• OnDemand

  录制触发方式。有效值：0（自动录制），1（回调确认），2（推流参数设置），7（手动录制）。详情请参见录制触发方式。

• DelayTime

  断流拼接时长（秒）。当断流时间不超过此时长，重新推流后的内容会自动合并至同一个文件。当断流时间超过此时长，则录制为新文件。

• RecordContent、TranscodeTemplates

  指定录制源流或转码流。录制转码流时，需指定转码模板 ID。

• RecordFormat：设置存储格式及点播视频配置。其中：

  • AutoCompose：开启后，可在直播录制结束后，自动将多个录制周期文件合并成一个录制文件。

  • VideoProcess、ProcessMethod、ProcessTemplateId：使用视频点播的转码或工作流模板，来处理原录制文件或自动合并的视频。

完整参数说明请参见AddLiveRecordVodConfig - 添加直播录制转点播配置。

方法一：控制台配置

1. 登录视频直播控制台。

2. 在左侧导航栏选择功能管理 > 直播录制。在录制配置页签，选择存储至OSS。

3. 选择待配置的播流域名，并且单击添加。

4. 配置录制模板。支持录制源流或转码流，两者可同时选择。

   基础录制设置

   参数	描述
   AppName	应用名称，必须与推流地址的 AppName 保持一致方可生效。若需对域名下所有应用生效，填写 *。
   StreamName	流名称。支持精确匹配，即录制特定流。若需录制当前 AppName 下的所有直播流，填写 *。
   存储位置	可选择当前地域在 OSS 中创建的 Bucket。 说明 存储 Bucket 分为两类： 标准 Bucket：用于常规文件存储 媒体 Bucket：专用于视频转码处理，存入该类型的文件可自动触发 MPS 转码任务 当前系统未对 Bucket 类型进行标识区分，如需执行视频转码，请自行记录所使用的媒体 Bucket 名称，以确保转码后的媒体文件存储位置准确。
   断流拼接时长	直播中断时，当断流时间不超过此时长，重新推流后的内容会自动合并至同一个文件。当断流时间超过此时长，则录制为新文件。默认值：180秒。范围：15-21600秒。
   触发方式	支持通过以下方式触发录制：自动录制、回调确认、推流参数设置、手动录制。 详情请参见录制触发方式。

   录制源流

   参数	描述
   存储格式	支持 M3U8、FLV、MP4、CMAF 四种格式。可选择多个格式，但不能同时选择 M3U8 和 CMAF 格式。
   存储规则	录制文件的命名方式。默认路径： M3U8、FLV、MP4: record/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime} TS、fMP4: record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
   单个切片时长	单个 TS 切片的时长。仅选择 M3U8 和 CMAF 格式时显示。 默认值：30秒。范围：5-30秒。
   录制周期	单个录制文件的最大时长。当直播持续时间超过此阈值，系统将生成新文件。默认值：180分钟。范围：15-360分钟。

   录制转码流

   参数	描述
   转码流选择	选择需要录制的转码流。可指定转码模板（上限10个）或选择全部转码模板。 转码模板的 AppName 为*或与录制模板一致时，转码流录制才能生效。
   存储格式	支持 M3U8、FLV、MP4、CMAF 四种格式。可选择多个格式，但不能同时选择 M3U8 和 CMAF 格式。
   存储规则	录制文件的命名方式。默认路径： M3U8、FLV、MP4: transcodeRecord/{AppName}/{StreamName}_{转码模板ID}/{EscapedStartTime}_{EscapedEndTime} TS、fMP4: transcodeRecord/{AppName}/{StreamName}_{转码模板ID}/{UnixTimestamp}_{Sequence}
   单个切片时长	单个 TS 切片的时长。仅选择 M3U8 和 CMAF 格式时显示。 默认值：30秒。范围：5-30秒。
   录制周期	单个录制文件的最大时长。当直播持续时间超过此阈值，系统将生成新文件。默认值：180分钟。范围：15-360分钟。

5. 单击确定创建录制模板。

方法二：API 配置

调用AddLiveAppRecordConfig接口，添加录制存储至 OSS 配置。示例代码：

// Parameter settings for API request
AddLiveAppRecordConfigRequest.TranscodeRecordFormat transcodeRecordFormat0 = AddLiveAppRecordConfigRequest.TranscodeRecordFormat.builder()
        .sliceDuration(30)
        .sliceOssObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{EscapedStartTime}_{EscapedEndTime}")
        .cycleDuration(900)
        .format("m3u8")
        .build();

AddLiveAppRecordConfigRequest.RecordFormat recordFormat0 = AddLiveAppRecordConfigRequest.RecordFormat.builder()
        .sliceDuration(30)
        .format("m3u8")
        .cycleDuration(900)
        .sliceOssObjectPrefix("record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}")
        .build();

AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = AddLiveAppRecordConfigRequest.builder()
        .domainName("<Your DomainName>")
        .appName("live")
        .ossEndpoint("<Your OssEndpoint>")
        .ossBucket("<Your OssBucket>")
        .streamName("stream1")
        .onDemand(0)
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeRecordFormat(java.util.Arrays.asList(transcodeRecordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

部分参数说明

• OnDemand

  录制触发方式。有效值：0（自动录制），1（回调确认），2（推流参数设置），7（手动录制）。详情请参见录制触发方式。

• DelayTime

  断流拼接时长（秒）。当断流时间不超过此时长，重新推流后的内容会自动合并至同一个文件。当断流时间超过此时长，则录制为新文件。

• RecordFormat

  源流存储格式及录制参数，包括 Format（存储格式）、OssObjectPrefix（存储规则）、SliceDuration（切片时长）、CycleDuration（录制周期）等。

• TranscodeTemplates、TranscodeRecordFormat

  录制转码流时，指定转码模板 ID 列表和转码流的存储格式及录制参数。

完整参数说明请参见AddLiveAppRecordConfig - 添加录制配置。