视频点播 VOD-查询转码模板列表:响应参数

时间:2024-11-18 10:32:30

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

template_group_list

Array of TransTemplateRsp objects

模板组信息

total

Integer

总记录条数

表5 TransTemplateRsp

参数

参数类型

描述

group_id

String

模板组id

name

String

模板组名称

is_default

Boolean

是否设置成默认转码模板

type

String

模板组类型

is_auto_encrypt

Boolean

配置是否加密输出音视频,默认false不加密。

当前只支持加密输出HLS格式的音视频流,不会对原始上传的音视频进行加密处理。非HLS转码输出的音视频格式,此字段不可配置。开启此配置前,请参考《VOD用户指南》的“HLS加密设置”章节获取密钥URL。

additional_manifests

Array of AdditionalManifest objects

自定义索引后缀列表。

quality_info_list

Array of QualityInfoList objects

画质配置信息列表

watermark_template_ids

Array of strings

绑定的水印模板组ID数组

description

String

模板介绍

common

CommonInfo object

高清低码开关,高清低码Version,编码格式多路共同参数

表6 AdditionalManifest

参数

参数类型

描述

manifest_name_modifier

String

索引后缀名

selected_outputs

Array of strings

选择流名列表

表7 QualityInfoList

参数

参数类型

描述

video

VideoInfo object

模板视频信息。video和audio至少配置一个参数。

audio

AudioInfo object

模板音频信息

表8 VideoInfo

参数

参数类型

描述

stream_name

String

流名,流名仅支持数字、字母、下划线、中划线。

如果流名不填,则点播会按照video_stream_l{index}形式,生成一个流名。

quality

String

画质

  • 4K默认分辨率3840*2160,码率8000kbit/s

  • 2K默认分辨率2560*1440,码率7000kbit/s

  • FULL_HD默认分辨率1920*1080,码率3000kbit/s

  • HD默认分辨率1280*720,码率1000kbit/s

  • SD默认分辨率854*480,码率600kbit/s

  • FLUENT默认分辨率480*270,码率300kbit/s

width

Integer

视频宽度

height

Integer

视频高度

bitrate

Integer

码率,单位:kbit/s

frame_rate

Integer

帧率,单位是帧每秒。

取值范围:0或[5,60]之间的整数。

默认为0,0代表自适应。

表9 AudioInfo

参数

参数类型

描述

sample_rate

String

音频采样率(有效值范围)

  • AUDIO_SAMPLE_AUTO (default),

  • AUDIO_SAMPLE_22050:22050Hz

  • AUDIO_SAMPLE_32000:32000Hz

  • AUDIO_SAMPLE_44100:44100Hz

  • AUDIO_SAMPLE_48000:48000Hz

  • AUDIO_SAMPLE_96000:96000Hz

bitrate

Integer

音频码率(单位:Kbps)

channels

String

声道数(有效值范围)

  • AUDIO_CHANNELS_1:单声道

  • AUDIO_CHANNELS_2:双声道

  • AUDIO_CHANNELS_5_1:5.1声道

表10 CommonInfo

参数

参数类型

描述

pvc

Boolean

高清低码开关

video_codec

String

视频编码格式

  • H264

  • H265

audio_codec

String

音频编码格式

  • AAC:AAC格式 (default)

  • HEAAC1:HEAAC1格式

  • HEAAC2:HEAAC2格式

  • MP3:MP3格式

is_black_cut

Boolean

黑边剪裁类型,默认false不开启黑边剪裁

format

String

转码格式

  • MP4

  • HLS

  • DASH

  • DASH_HLS

  • MP3

  • ADTS

  • UNKNOW

hls_interval

Integer

分片时长,范围2-10(默认为5秒)

upsample

Boolean

上采样开关,开启后可以提升视频的分辨率,增加采样点的数量,默认值:false,表示不开启上采样。

adaptation

String

转码后的片源分辨率自适应方式。

取值如下:

  • SHORT:短边自适应。转码模板的宽和高都设置,用其中的短边与片源短边对比,然后片源长边按此比例进行缩放。

  • LONG:长边自适应。转码模板的宽和高都设置,用其中的长边与片源长边对比,然后片源短边按此比例进行缩放。

  • NONE:按设置宽高适应,为默认值。按照转码模板设置的宽高输出。

说明:
  • V1接口(已废弃)不支持设置该参数,默认按SHORT处理。V2接口默认按NONE处理,V1和V2接口默认值有差异,在调用时需要注意该参数值的设置。

  • 控制台是通过V2接口创建的转码模板,实际与V1接口创建转码模板的默认值保持一致,为SHORT。

preset

Integer

编码质量等级,取值[0,2] 0表示默认方式,1表示转码效率优先,2表示转码质量优先。

max_iframes_interval

Integer

I帧最大间隔,取值范围:[2,10]。默认值:5,单位秒。

hls_audio_separate

Boolean

转码后音频是否独立存储。

hls_segment_type

String

HLS分片的封装格式,目前支持TS和FMP4,默认TS格式

状态码: 403

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

support.huaweicloud.com/api-vod/ListTranscodeTemplate.html