调用UpdateMixStream更新合流任务。
使用说明
调用本接口更新合流任务。本接口目前支持更新输入源以及布局，不支持更新输出分辨率等内容。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | UpdateMixStream | 系统规定参数。取值：UpdateMixStream。 |
| DomainName | String | 是 | example.com | 主播流域名。 重要 目前仅支持华东2（cn-shanghai）和华北2（cn-beijing）两个区域的域名。
|
| MixStreamId | String | 是 | 5b2a046e-74d7-385e-d2d7-8a5b87e4**** | 合流任务ID。如果您通过CreateMixStream接口创建合流任务，请查看CreateMixStream接口调用返回的参数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数组。 参考下方的InputStreamConfig。 |
| LayoutId | String | 否 | MixStreamLayout-3-2 | 布局ID。支持：
|
InputStreamConfig
名称 |
类型 |
描述 |
ResourceType |
String |
资源类型。 live：直播流地址。 url：文件流地址。 |
ResourceValue |
String |
资源地址。 如果ResourceType为live，则为直播流地址。直播流地址支持RTMP、FLV和ARTC协议，不支持HLS协议。 如果ResourceType为url，则为文件流地址。 |
LayoutChildId |
String |
布局方格对应ID（也代表合流的叠加顺序）。 |
LayoutConfig |
LayoutConfig[] |
JSON数组，代表所在位置、填充方式等布局信息。 如果使用预设布局，则此参数可以不填。 如果设置了该值，则忽略LayoutChildId对应的预设布局信息。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| MixStreamId | String | 5b2a046e-74d7-385e-d2d7-8a5b87e4**** | 合流任务ID。可作为查询合流任务列表和删除合流任务的请求参数。 |
| 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****
&<公共请求参数>正常返回示例
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示例
详细示例，请参见合流代码示例。