视频直播 LIVE-查询直播转码模板:响应参数

时间:2025-03-07 10:43:54

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total

Integer

查询结果的app数量

domain

String

播放 域名

templates

Array of AppQualityInfo objects

转码模板

表5 AppQualityInfo

参数

参数类型

描述

app_name

String

应用名称

quality_info

Array of QualityInfo objects

视频质量信息

表6 QualityInfo

参数

参数类型

描述

quality

String

包含如下取值:

  • lud:超高清,系统缺省名称。

  • lhd:高清,系统缺省名称。

  • lsd:标清,系统缺省名称。

  • lld:流畅,系统缺省名称。

  • userdefine:视频质量自定义。填写userdefine时,templateName字段不能为空。

templateName

String

自定义模板名称。

  • 若需要自定义模板名称,请将quality参数设置为userdefine。

  • 多个自定义模板名称之间不能重复。

  • 自定义模板名称不能与其他模板的quality参数重复。

  • 若quality不为userdefine,请勿填写此字段。

PVC

String

是否使用窄带高清转码。

注意:该字段已不再维护,建议使用hdlb。

包含如下取值:

  • off:不启用。

  • on:启用。

默认值:off。

hdlb

String

是否启用高清低码,较PVC相比画质增强。

提示:使用hdlb字段开启高清低码时,PVC字段不生效。

包含如下取值:

  • off:不开启高清低码。

  • on:开启高清低码。

默认值:off。

codec

String

视频编码格式。

包含如下取值:

  • H264:使用H.264。

  • H265:使用H.265。

默认为H264。

width

Integer

视频的长边。其中,横屏为宽,即长边,竖屏为高。单位:像素。

包含如下取值:

  • codec的取值为H264时,width建议取值范围为[32,3840],且必须为2整数倍。

  • codec的取值为H265时,width建议取值范围为[320,3840],且必须为2的整数倍。

注意:width和height全为0时,输出的分辨率和源保持一致;width和height只有一个为0时,输出的分辨率按非0项的比例进行缩放。

默认值:0。

height

Integer

视频的短边。其中,横屏为宽,竖屏为高,即短边。单位:像素。

包含如下取值:

  • codec的取值为H264时,height建议取值范围为[32,2160],且必须为2的整数倍。

  • codec的取值为H265时,height建议取值范围为[240,2160],且必须为2的整数倍。

注意:width和height全为0时,输出的分辨率和源保持一致;width和height只有一个为0时,输出的分辨率按非0项的比例进行缩放。

默认值:0。

bitrate

Integer

转码视频的码率。

单位:Kbps

取值范围:40-30000。

video_frame_rate

Integer

转码视频帧率。

单位:fps

取值范围:0-60,0表示保持帧率不变。

默认值:0。

protocol

String

转码输出支持的协议类型。默认为RTMP。当前只支持RTMP。

包含如下取值:

  • RTMP

iFrameInterval

Integer

最大I帧间隔。

单位:帧数

取值范围:[0, 500],默认值:50。

注意:若希望通过iFrameInterval设置i帧间隔,请将gop设为0,或不传gop参数。

gop

Integer

按时间设置I帧间隔。

单位:秒

取值范围:[0,10],默认值:2。

注意:gop不为0时,则以gop设置i帧间隔,iFrameInterval字段不生效。

bitrate_adaptive

String

自适应码率参数。

包含如下取值:

  • off:关闭码率自适应,目标码率按设定的码率输出。

  • minimum:目标码率按设定码率和源文件码率最小值输出(即码率不上扬)。

  • adaptive:目标码率按源文件码率自适应输出。

默认值:off。

i_frame_policy

String

编码输出I帧策略。

包含如下取值:

  • auto:I帧按设置的gop时长输出。

  • strictSync:编码输出I帧完全和源保持一致(源是I帧则编码输出I帧,源不是I帧则编码非I帧),设置该参数后gop时长设置无效。

默认值:auto。

注意:多码率场景下建议开启I帧随源,保障多码率I帧对齐。

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

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