视频直播 LIVE-创建直播转码模板:请求参数

时间:2024-07-19 14:22:40

请求参数

表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参数

参数

是否必选

参数类型

描述

domain

String

推流 域名

app_name

String

应用名称

trans_type

String

转码流触发模式。

  • play:拉流触发转码。

  • publish:推流触发转码。

    默认为play

quality_info

Array of QualityInfo objects

视频质量信息

表4 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帧对齐。

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