調用AddCustomLiveStreamTranscode添加自定義轉碼配置信息。
本接口目前支持以下自定義轉碼模版類型,取值:
- h264:自定義H264標準模版。
- h264-nbhd:自定義H264窄帶高清?模版。
- h265:自定義H265標準模版。
- h265-nbhd:自定義H265窄帶高清模版。
- audio:純音頻模板。
QPS限制
本接口的單用戶QPS限制為6000次/分鐘。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | AddCustomLiveStreamTranscode | 系統規定參數。取值:AddCustomLiveStreamTranscode。 |
Domain | String | 是 | example.com | 主播流域名。 |
App | String | 是 | liveApp**** | 播流所屬應用名稱。 |
KmsKeyID | String | 否 | afce5722-81d2-43c3-9930-7601da11**** | 用戶KMS主密鑰ID。 |
KmsUID | String | 否 | 25346073170691**** | 用戶KMS主賬號ID。 |
KmsKeyExpireInterval | String | 否 | 3600 | 換Key周期。取值范圍:60~3600,單位:秒。 |
Template | String | 是 | LiveCusTranscode**** | 轉碼模板自定義名稱。 說明 支持數字、大小寫字母或短橫線(-),且字段必須以大小寫字母或數字開頭,不能與標準的轉碼模板命名重復。 |
TemplateType | String | 是 | h264 | 自定義轉碼模版類型。取值:
說明 TemplateType取值為視頻類型時(例如h264、h264-nbhd、h265或 h265-nbhd),請求參數Height、Width、FPS和VideoBitrate的值必須填寫。 |
Height | Integer | 否 | 720 | 轉碼視頻高度。單位:像素。取值: 需要同時滿足如下三個條件:
說明 265窄帶高清模板不得超過1280×720。 |
Width | Integer | 否 | 576 | 轉碼視頻寬度。單位:像素。取值: 需要同時滿足如下三個條件:
說明 265窄帶高清模板不得超過1280×720。 |
FPS | Integer | 否 | 30 | 轉碼視頻幀率。單位:FPS,取值:1~60。 |
VideoBitrate | Integer | 否 | 720 | 轉碼視頻比特率。單位:kbps,取值:1~6000。 說明 轉碼視頻會盡量接近您所設定的比特率,但轉碼視頻的實際比特率不能保證和您所設定的完全一致,尤其是當您設定的比特率過大或過小時。 |
AudioBitrate | Integer | 否 | 512 | 轉碼音頻比特率。單位:kbps,取值:1~1000。 |
Gop | String | 否 | 1 | 視頻GOP(Group of Picture),單位可選幀或者秒。
|
Profile | Integer | 否 | 2 | 編碼級別。視頻支持的一組特定的編碼功能,一般值越大得到的畫面質量越好,同時編解碼消耗的資源也越高。取值:
|
AudioProfile | String | 否 | aac_low | 音頻編碼。取值:
|
AudioCodec | String | 否 | AAC | 音頻編碼格式。取值:
|
AudioRate | Integer | 否 | 96000 | 音頻采樣率。取值:22050~96000。 重要 如果AudioProfile取值為aac_ld,則采樣率不能超過44100。
|
AudioChannelNum | Integer | 否 | 2 | 音頻聲道數。取值
|
Lazy | String | 否 | yes | 是否開啟觸發轉碼。取值:
|
EncryptParameters | String | 否 | {"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"} | 加密配置。JSON格式,各字段說明如下:
說明 EncryptParameters參數若配置,則KmsKeyID、KmsUID、KmsKeyExpireInterval參數不能為空 |
ResWithSource | String | 否 | {"Type":"short","Value":"1080"} | 分辨率隨源配置,若設置了該字段,分辨率以該字段為主。包含的字段如下:
|
FpsWithSource | String | 否 | {"UpLimit":60,"LowerLimit":1} | 幀率隨源配置,若設置了該字段,幀率以該字段為主。包含的字段如下:
|
BitrateWithSource | String | 否 | {"UpLimit":2500,"LowerLimit":800,"Factor":1} | 碼率隨源配置,若設置了該字段,碼率以該字段為主。包含的字段如下:
|
ExtWithSource | String | 否 | {"KeyFrameOpen":"yes","Copyts":"yes","SeiMode":1} | 其他隨源配置,包含的字段如下:
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F**** | 請求ID。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=AddCustomLiveStreamTranscode
&App=liveApp****
&Domain=example.com
&Template=LiveCusTranscode****
&TemplateType=h264
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<AddCustomLiveStreamTranscodeResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddCustomLiveStreamTranscodeResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"AddCustomLiveStreamTranscodeResponse" : {
"RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。