调用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)两个区域的域名。
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

MixStreamId String 5b2a046e-74d7-385e-d2d7-8a5b87e4****

合流任务ID。如果您通过CreateMixStream接口创建合流任务,请查看CreateMixStream接口调用返回的参数MixStreamId值。

RegionId String cn-shanghai

地域ID。

LayoutId String MixStreamLayout-3-2

布局ID。支持:

  • MixStreamLayout-1-1
  • MixStreamLayout-2-1
  • MixStreamLayout-2-2
  • MixStreamLayout-2-3
  • MixStreamLayout-3-1
  • MixStreamLayout-3-2
  • MixStreamLayout-4-1
  • USERDEFINED(非上述预设布局,取固定值USERDEFINED

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格式

<UpdateMixStreamResponse>
  <MixStreamId>5b2a046e-74d7-385e-d2d7-8a5b87e4****</MixStreamId>
  <RequestId>1A8CDDFF-0121-4ABB-DA60-AEF095A8W34F</RequestId>
</UpdateMixStreamResponse>

JSON格式

{
    "UpdateMixStreamResponse": {
        "MixStreamId": "5b2a046e-74d7-385e-d2d7-8a5b87e4****",
        "RequestId": "1A8CDDFF-0121-4ABB-DA60-AEF095A8W34F"
    }
}

错误码

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

SDK示例

详细示例,请参见合流代码示例