調用CreateCustomTemplate創(chuàng)建合流自定義模板。
使用說明
調用本接口創(chuàng)建好自定義模板后，請記錄模板名。通過CreateMixStream接口創(chuàng)建合流任務時，MixStreamTemplate傳入模板名來使用自定義模板。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制，API調用會被限流，這可能會影響您的業(yè)務，請合理調用。更多信息，請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | CreateCustomTemplate | 系統(tǒng)規(guī)定參數(shù)。取值：CreateCustomTemplate。 |
| CustomTemplate | String | 是 | {"height":"1060","scale":"[16:9]","gop":"60","bframes":"30","cdesc":"h264"} | JSON格式{height:xxx,scale:xxx,gop:xxx,bframes:xxx,cdesc:xxx}，所有字段均必填，缺少其中任意字段會調用失敗。 說明 具體參數(shù)請參考下表CustomTemplate說明。 |
| Template | String | 是 | TestTemplate | 需要添加的模板名。 說明 請在創(chuàng)建時記錄模板名，用于使用、查詢和刪除操作。 |
名稱 |
類型 |
必選 |
描述 |
height |
String |
必選 |
輸出分辨率的高。 scale為16:9時最大支持1920x1080。 scale為4:3時最大支持1440x1080 。 |
scale |
String |
必選 |
輸出分辨率高寬比。只能接受 String 取值如下： [3:4] [4:3] [16:9] [9:16] |
bframes |
String |
必選 |
輸出流b幀數(shù)。取值需要大于0小于9。 |
cdesc |
String |
必選 |
編碼格式。只能取值 h264。 |
gop |
String |
必選 |
關鍵幀間隔。取值大于25小于250。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
| RequestId | String | 0D715397-2E66-4AE1-694h-C546628AD145 | 請求ID。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=CreateCustomTemplate
&CustomTemplate={height:1080,scale:[16:9],gop:60,bframes:30,cdesc:h264}
&Template=TestTemplate
&<公共請求參數(shù)>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateCustomTemplateResponse>
<RequestId>0D715397-2E66-4AE1-694h-C546628AD145</RequestId>
</CreateCustomTemplateResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "0D715397-2E66-4AE1-694h-C546628AD145"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。