视频直播 LIVE-修改录制规则:请求参数

时间:2024-12-10 10:58:37

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必填。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必填,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必填,请求的发生时间。

X-Project-Id

String

使用AK/SK方式认证时必填,携带项目ID信息。

表3 请求Body参数

参数

是否必选

参数类型

描述

publish_domain

String

直播推流 域名

app

String

应用名,如需匹配任意应用则填写*。录制规则匹配的时候,优先精确app匹配,如果匹配不到,则匹配*

stream

String

录制的流名,如需匹配任流名则填写*。录制规则匹配的时候,优先精确stream匹配,如果匹配不到,则匹配*

record_type

String

录制类型,包括:CONTINUOUS_RECORD,COMMAND_RECORD。默认CONTINUOUS_RECORD。

  • CONTINUOUS_RECORD:持续录制,在该规则类型配置后,只要有流推送到录制系统,就触发录制。
  • COMMAND_RECORD:命令录制,在该规则类型配置后,在流推送到录制系统后,租户需要通过命令控制该流的录制开始和结束。

default_record_config

DefaultRecordConfig object

默认录制规则配置

表4 DefaultRecordConfig

参数

是否必选

参数类型

描述

record_format

Array of strings

录制格式,当前支持:FLV,HLS,MP4三种格式,设置格式时必须使用大写字母

obs_addr

RecordObsFileAddr object

录制保存的租户的桶信息

hls_config

HLSRecordConfig object

HLS配置规则

flv_config

FLVRecordConfig object

FLV配置规则

mp4_config

MP4RecordConfig object

MP4配置规则

表5 RecordObsFileAddr

参数

是否必选

参数类型

描述

bucket

String

OBS的bucket名称

location

String

OBS Bucket所在RegionID

object

String

OBS对象路径,遵守OBS Object定义。如果为空则保存到根目录

表6 HLSRecordConfig

参数

是否必选

参数类型

描述

record_cycle

Integer

周期录制时长

单位:秒,最小1分钟(60秒),最大12小时(43200秒)。

如果为0,则使用默认值6小时(21600秒)。

record_prefix

String

录制m3u8文件,含路径和文件名的前缀, 默认Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time}

record_ts_prefix

String

录制ts文件名的前缀, 默认{file_start_time_unix}_{file_end_time_unix}_{ts_sequence_number}

record_slice_duration

Integer

录制HLS时ts的切片时长,非必填。

取值范围:[2,60]

单位:秒

默认值:10

record_max_duration_to_merge_file

Integer

录制HLS文件拼接时长,如果流中断超过该时间,则生成新文件。

单位:秒

默认值:0

  • 0:表示流中断就生成新文件。
  • -1:表示相同的流中断恢复后,继续在30天内的前一个文件保存。
表7 FLVRecordConfig

参数

是否必选

参数类型

描述

record_cycle

Integer

周期录制时长

单位:秒,最小1分钟(60秒),最大6小时(21600秒)。

如果为0,则使用默认值2小时(7200秒)。

record_prefix

String

录制FLV文件,含路径和文件名的前缀, 默认Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{file_start_time}

record_max_duration_to_merge_file

Integer

录制FLV文件拼接时长,如果流中断超过该时间,则生成新文件。如果为0表示流中断就生成新文件。

单位:秒

默认值:0

表8 MP4RecordConfig

参数

是否必选

参数类型

描述

record_cycle

Integer

周期录制时长

单位:秒,最小1分钟(60秒),最大6小时(21600秒)。

如果为0,则使用默认值2小时(7200秒)。

record_prefix

String

录制文件含路径和文件名的前缀, 默认Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{file_start_time}

record_max_duration_to_merge_file

Integer

录制mp4文件拼接时长,如果流中断超过该时间,则生成新文件。如果为0表示流中断就生成新文件。

单位:秒

默认值:0

support.huaweicloud.com/api-live/UpdateRecordRule.html