调用UpdateMixStream更新合流任务。

支持更新输入源以及布局,不支持更新输出分辨率等内容。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateMixStream

系统规定参数,取值: UpdateMixStream

DomainName String www.yourdomain.com

主播流域名。

说明 域名所属直播中心必须和RegionId在同一地域。
InputStreamList String {"InputStreamList":[{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":1,"ResourceValue":"rtmp://domain1.com/caster/8564a8d1659b4dc69df5f66cf4c9****","ResourceType":"live"},{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0.5,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":2,"ResourceValue":"http://domain2.alicdn.com/3c3c25426cf744fdb90423e76b78a28a/69b1a16e2b1d423d9841bf27a96f134e-0b1cba51f58bb5ad3a854x96a2c735f****.mp4","ResourceType":"url"},{"LayoutConfig":{"fillSizeNormalized":[1,0.5],"fillPositionNormalized":[0,0.5],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":3,"ResourceValue":"http://domain3.com/c0c6c5446b56432389e91535864938da/ed4adc5263b4474c954b95607a5350ae-fda757b3328438a8cf-4k57f373a0f0****.mp4","ResourceType":"url"}]}

合流输入列表,JSON数组。

参考下方的InputStreamConfig

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

合流任务ID。

RegionId String cn-shanghai

地域。直播所在地域ID,支持地域:

  • cn-beijing
  • cn-shanghai
    说明 当地域为cn-shanghai时,合流里传的资源不能是rtc的,即ResourceValue不能是rtc://开头的地址。
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,则为直播流地址。

如果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=www.newdomain.com
&InputStreamList={"InputStreamList":[{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":1,"ResourceValue":"rtmp://domain1.com/caster/8564a8d1659b4dc69df5f66cf4c9****","ResourceType":"live"},{"LayoutConfig":{"fillSizeNormalized":[0.5,0.5],"fillPositionNormalized":[0.5,0],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":2,"ResourceValue":"http://domain2.alicdn.com/3c3c25426cf744fdb90423e76b78a28a/69b1a16e2b1d423d9841bf27a96f134e-0b1cba51f58bb5ad3ac-4k96a2c735f****.mp4","ResourceType":"url"},{"LayoutConfig":{"fillSizeNormalized":[1,0.5],"fillPositionNormalized":[0,0.5],"positionRefer":"topLeft","fillMode":"fit"},"LayoutChildId":3,"ResourceValue":"http://domain3.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格式

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

错误码

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