视频直播 LIVE-创建录制规则:请求参数
下载视频直播 LIVE用户手册完整版
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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信息。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
publish_domain |
是 |
String |
直播推流 域名 |
|
app |
是 |
String |
应用名，如需匹配任意应用则填写*。录制规则匹配的时候，优先精确app匹配，如果匹配不到，则匹配* |
|
stream |
是 |
String |
录制的流名，如需匹配任流名则填写*。录制规则匹配的时候，优先精确stream匹配，如果匹配不到，则匹配* |
|
record_type |
否 |
String |
录制类型，包括：CONTINUOUS_RECORD，COMMAND_RECORD。默认CONTINUOUS_RECORD。
|
|
default_record_config |
是 |
DefaultRecordConfig object |
默认录制规则配置 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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配置规则 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
bucket |
是 |
String |
OBS的bucket名称 |
|
location |
是 |
String |
OBS Bucket所在RegionID |
|
object |
是 |
String |
OBS对象路径，遵守OBS Object定义。如果为空则保存到根目录 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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
|
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
