UpdateRtsLiveStreamTranscode - 更新RTS自定义转码配置 - 视频直播

更新RTS自定义转码配置信息。

接口说明

本接口目前只支持 h264、h264-nbhd、h264-origin、audio 四种自定义转码模版类型。

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

live:UpdateRtsLiveStreamTranscode

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否
Domain	string	是	主播流域名，不可修改。	example.com
App	string	是	播流所属应用名称，不可修改。	aliyun-test
Template	string	是	转码模板自定义名称，不可修改。	ld
TemplateType	string	是	自定义转码模版类型，不可修改。	h264
Height	integer	否	转码视频高度。单位：像素。取值：需要同时满足如下三个条件： Height ≥ 100：视频的高需要不小于 100 像素。 max（Height,Width）≤ 2560：视频的宽、高中较大的一个最大不能大于 2560。 min（Height,Width）≤ 1440：视频的宽、高中较小的一个最大不能大于 1440。例如：1560×1560（正方形视频）是不合法的。说明当 TemplateType（自定义转码模版类型）设为 h264 或 h264-nbhd 或 h264-origin 时，本参数必填。原画模板由于需要保持片源的信息，分辨率最高支持到 4K。	1280
Width	integer	否	转码视频宽度。单位：像素。取值：需要同时满足如下三个条件： Width≥ 100：视频的宽需要不小于 100 像素。 max（Height,Width）≤ 2560：视频的宽、高中较大的一个最大不能大于 2560。 min（Height,Width）≤ 1440：视频的宽、高中较小的一个最大不能大于 1440。例如：1560×1560（正方形视频）是不合法的。说明当 TemplateType（自定义转码模版类型）设为 h264 或 h264-nbhd 或 h264-origin 时，本参数必填。原画模板由于需要保持片源的信息，分辨率最高支持到 4K。	720
FPS	integer	否	转码视频帧率。单位：FPS。取值：1~60。说明当 TemplateType（自定义转码模版类型）设为 h264 或 h264-nbhd 或 h264-origin 时，本参数必填。	30
VideoBitrate	integer	否	转码视频比特率。单位：kbps。取值：1~6000。说明当 TemplateType（自定义转码模版类型）设为 h264 或 h264-nbhd 或 h264-origin 时，本参数必填。转码视频会尽量接近您所设定的比特率，但转码视频的实际比特率不能保证和您所设定的完全一致，尤其是当您设定的比特率过大或过小时。	2000
AudioBitrate	integer	否	转码音频比特率。单位：kbps。取值：1~1000。说明当 TemplateType（自定义转码模版类型）设为 audio 时，本参数必填。	128
Gop	string	否	视频 GOP（Group of Picture）。主要用于控制关键帧间隔。单位：秒。取值：1~3。	2
DeleteBframes	boolean	否	是否使用 B 帧进行转码。取值： true：转码后的视频无 B 帧。 false：包含 B 帧，默认包含 B 帧。说明当 TemplateType（自定义转码模版类型）设为 h264 或 h264-nbhd 或 h264-origin 时，本参数必填。不传参数时默认为 false。	false
Opus	boolean	否	音频转码是否使用 opus 进行转码（主要用户兼容原生 webrtc 问题）。取值： true：音频转码为 opus 格式。 false：不使用 opus 格式转码。说明不传参数时默认为 false。	true
Profile	integer	否	编码级别。视频支持的一组特定的编码功能，一般值越大得到的画面质量越好，同时编解码消耗的资源也越高。取值： 1：baseline（适合移动设备）。 2：main（适合标准分辨率设备）。 3：high（适合高分辨率设备）。	2
AudioProfile	string	否	音频编码级别。取值： aac_low。 aac_he。 aac_he_v2。 aac_ld。	aac_low
AudioCodec	string	否	音频编码器。取值： aac。 mp3。说明如果要使用 opus 编码，把 Opus 选项参数置为 true 即可。	aac
AudioRate	integer	否	音频采样率。取值：22050，32000，44100，48000，96000。其中 44100 比较常用。单位：Hz。说明如果音频编码 AudioProfile 是 aac_ld，则采样率不能超过 44100。	44100
AudioChannelNum	integer	否	音频声道数。取值： 1 ：单声道。 2：立体声。	2
Lazy	string	否	是否开启触发转码。取值： yes：开启触发转码。 no：不开启触发转码。	no

返回参数

名称	类型	描述	示例值
	object	请求 ID。
RequestId	string	请求 ID。	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

示例

正常返回示例

JSON格式

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameters	%s Please check and try again later.	存在异常参数，请检查后重试。
400	ConfigAlreadyExists	%s Please check and try again later.	配置已存在，请检查后重试。
400	TemplateLimit	%s Please check and try again later.	模板数量达到上限。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。