调用AddLiveStreamTranscode添加转码配置信息_视频直播(LIVE)-阿里云帮助中心

使用说明

先通过密钥管理服务KMS获取用户KMS主密钥ID，再调用本接口添加通用转码配置信息，目前本接口只支持标准质量模板和窄带高清™转码模板两种转码模板。

QPS限制

本接口的单用户QPS限制为30次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	AddLiveStreamTranscode	系统规定参数。取值：AddLiveStreamTranscode。
Domain	String	是	example.com	主播流域名。
App	String	是	liveApp****	播流所属应用名称。 App取值必须与推流地址中的AppName名称一样，转码模板才能生效。取值不超过256字符，支持数字、大小写字母、短划线（-）、下划线（_）。 App也支持取值为单个星号（）字符，表示匹配任意字符串（包括空字符串）。说明如果配置了App为单个星号（）的转码模板：当用户拉流转码时，优先匹配和推流地址中AppName名称一样的转码模板；若不存在和推流地址中AppName名称一样的转码模板，则会匹配App为单个星号（*）的转码模板。
Template	String	是	lsd	转码模版。取值：标准质量模板： lld：流畅。 lsd：标清。 lhd：高清。 lud ：超清。窄带高清™转码模板： ld：流畅。 sd：标清。 hd：高清。 ud：超清。
EncryptParameters	String	否	{"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}	加密配置。JSON格式，各字段说明如下： EncryptType：加密类型。固定取值aliyun。 KmsKeyID：用户KMS主密钥ID。 KmsKeyExpireInterval：换Key周期。取值范围：60~3600，单位：秒。
Lazy	String	否	yes	是否开启触发转码。取值： yes：开启触发转码。 no：不开启触发转码。

返回数据

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

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddLiveStreamTranscode
&App=liveApp****
&Domain=example.com
&Template=lsd
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<AddLiveStreamTranscodeResponse>
	  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveStreamTranscodeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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