更新合流任務(wù)
調(diào)用UpdateMixStream更新合流任務(wù)。
使用說明
調(diào)用本接口更新合流任務(wù)。本接口目前支持更新輸入源以及布局,不支持更新輸出分辨率等內(nèi)容。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制,API調(diào)用會被限流,這可能會影響您的業(yè)務(wù),請合理調(diào)用。更多信息,請參見QPS限制。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | UpdateMixStream | 系統(tǒng)規(guī)定參數(shù)。取值:UpdateMixStream。 |
DomainName | String | 是 | example.com | 主播流域名。 重要 目前僅支持華東2(cn-shanghai)和華北2(cn-beijing)兩個區(qū)域的域名。
|
MixStreamId | String | 是 | 5b2a046e-74d7-385e-d2d7-8a5b87e4**** | 合流任務(wù)ID。如果您通過CreateMixStream接口創(chuàng)建合流任務(wù),請查看CreateMixStream接口調(diào)用返回的參數(shù)MixStreamId值。 |
InputStreamList | String | 是 | {"InputStreamList":[{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":1,"ResourceValue":"rtmp://aliyundoc.com/caster/8564a8d1659b4dc69df5f66cf4c9****","ResourceType":"live"},{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0.5,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":2,"ResourceValue":"http://developer.aliyundoc.com/3c3c25426cf744fdb90423e76b78a28a/69b1a16e2b1d423d9841bf27a96f134e-0b1cba51f58bb5ad3a854x96a2c735f****.mp4","ResourceType":"url"},{"LayoutConfig":{"fillSizeNormalized":[1,0.5],"fillPositionNormalized":[0,0.5],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":3,"ResourceValue":"http://aliyundoc.com/c0c6c5446b56432389e91535864938da/ed4adc5263b4474c954b95607a5350ae-fda757b3328438a8cf-4k57f373a0f0****.mp4","ResourceType":"url"}]} | 合流輸入列表,JSON數(shù)組。 參考下方的InputStreamConfig。 |
LayoutId | String | 否 | MixStreamLayout-3-2 | 布局ID。支持:
|
InputStreamConfig
名稱 |
類型 |
描述 |
ResourceType |
String |
資源類型。 live:直播流地址。 url:文件流地址。 |
ResourceValue |
String |
資源地址。 如果ResourceType為live,則為直播流地址。直播流地址支持RTMP、FLV和ARTC協(xié)議,不支持HLS協(xié)議。 如果ResourceType為url,則為文件流地址。 |
LayoutChildId |
String |
布局方格對應(yīng)ID(也代表合流的疊加順序)。 |
LayoutConfig |
LayoutConfig[] |
JSON數(shù)組,代表所在位置、填充方式等布局信息。 如果使用預(yù)設(shè)布局,則此參數(shù)可以不填。 如果設(shè)置了該值,則忽略LayoutChildId對應(yīng)的預(yù)設(shè)布局信息。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
MixStreamId | String | 5b2a046e-74d7-385e-d2d7-8a5b87e4**** | 合流任務(wù)ID。可作為查詢合流任務(wù)列表和刪除合流任務(wù)的請求參數(shù)。 |
RequestId | String | 1A8CDDFF-0121-4ABB-DA60-AEF095A8W34F | 請求ID。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=UpdateMixStream
&DomainName=example.com
&InputStreamList={"InputStreamList":[{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":1,"ResourceValue":"rtmp://aliyundoc.com/caster/8564a8d1659b4dc69df5f66cf4c9****","ResourceType":"live"},{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0.5,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":2,"ResourceValue":"http://developer.aliyundoc.com/3c3c25426cf744fdb90423e76b78a28a/69b1a16e2b1d423d9841bf27a96f134e-0b1cba51f58bb5ad3a854x96a2c735f****.mp4","ResourceType":"url"},{"LayoutConfig":{"fillSizeNormalized":[1,0.5],"fillPositionNormalized":[0,0.5],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":3,"ResourceValue":"http://aliyundoc.com/c0c6c5446b56432389e91535864938da/ed4adc5263b4474c954b95607a5350ae-fda757b3328438a8cf-4k57f373a0f0****.mp4","ResourceType":"url"}]}
&MixStreamId=5b2a046e-74d7-385e-d2d7-8a5b87e4****
&<公共請求參數(shù)>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateMixStreamResponse>
<MixStreamId>5b2a046e-74d7-385e-d2d7-8a5b87e4****</MixStreamId>
<RequestId>1A8CDDFF-0121-4ABB-DA60-AEF095A8W34F</RequestId>
</UpdateMixStreamResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"MixStreamId" : "5b2a046e-74d7-385e-d2d7-8a5b87e4****",
"RequestId" : "1A8CDDFF-0121-4ABB-DA60-AEF095A8W34F"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
SDK示例
詳細示例,請參見合流代碼示例。