修改布局配置,传递修改项,非修改内容无需传递。

请求参数

参数 类型 是否必选 描述
Action String 操作接口名,系统规定参数,取值:ModifyCasterLayout
CasterId String 导播台Id。
LayoutId String 布局Id。
VideoLayers []VideoLayer Videolayer配置列表,采用数组默认序列。
AudioLayers []AudioLayer Audiolayer配置列表。
BlendLists []String 元素为资源的位置ID(locationId参见添加视频源),与VideoLayers元素顺序对应。
MixLists []String 元素为资源的位置ID(locationId参见添加视频源),与VideoLayers元素顺序对应。
videoLayer
参数 类型 是否必选 描述
FillMode String 元素填充方式。
  • 不填充:”none”
  • 自适应:”fit”
  • 默认:不填充
  • 若采用不填充模式,则以画面作为配置目标进行Layer设置。
  • 若采用自适应模式,则以填充区(框)作为配置目标进行Layer设置,此时画面会按照原始的宽高比缩放,长边对齐的自适应方式在填充区(框)内居中填充,若填充区宽高比和画面不一致,则短边两侧无填充(显示为下层Layer画面,若下层未配置Layer,默认为底图黑色)。
HeightNormalized Float 设置该layer元素的高度归一化比例值。
  • 若采用不填充模式,元素的宽度会按照该高度来进行等比缩放,默认为0,表示按照画面的原始尺寸进行显示。
  • 若采用自适应方式时,该字段必输且大于0,表示填充区(框)高度归一化比例值。
WidthNormalized Float 设置该layer元素的宽度归一化比例值。
  • 若采用不填充模式,元素的高度会按照该宽度来进行等比缩放,默认为0,表示按照画面的原始尺寸进行显示。
  • 若采用自适应方式时,该字段必输且大于0,表示填充区(框)宽度归一化比例值。
PositionNormalized []Float 设置该layer 元素的位置归一化值[x,y]。
默认值:[0,0]
说明 x,y需要进行归一化计算。
PositionRefer String 设置元素的position 参考坐标值。
  • 取值范围:”topLeft”、”topRight”、”bottomLeft”、”bottomRight”以及”center”、”topCenter”、”bottomCenter”、”leftCenter”、”rightCenter”
  • 默认值:”topLeft”
FixedDelayDuration Integer 该字段对视频进行固定延迟设置,可用于字幕同步。
  • 单位:ms
  • 默认值:0
  • 取值范围:[0-5000]
AudioLayer
参数 类型 是否必选 描述
VolumeRate Float 设置该layer元素的高度归一化比例值,其中元素的宽度会按照该高度来进行等比缩放。

默认值:0,表示按照元素的原始尺寸进行显示。

ValidChannel String 确定哪些声道可以作为音量输入。
  • 取值范围:”leftChannel”、”rightChannel”、”all”
  • 默认值:”all”
FixedDelayDuration Integer 该字段对视频进行固定延迟设置,可用于字幕同步。
  • 单位:ms
  • 默认值:0
  • 取值范围:[0-5000]

返回参数

名称 类型 描述
RequestId String 该条任务请求Id
LayoutId String 布局Id

示例

请求示例
 https://live.aliyuncs.com?Action=ModifyCasterLayout&CasterId=a2b8e671-2fe5-4642-a2ec-bf93880e1a49&AudioLayer.1.ValidChannel=all&AudioLayer.1.VolumeRate=1&AudioLayer.2.ValidChannel=all&AudioLayer.2.VolumeRate=1&VideoLayer.1.HeightNormalized=1&VideoLayer.1.WidthNormalized=1&VideoLayer.1.PositionNormalized.1=0.0&VideoLayer.1.PositionNormalized.2=0.3&VideoLayer.2.HeightNormalized=1&VideoLayer.2.WidthNormalized=1&VideoLayer.2.PositionNormalized.1=0.3&VideoLayer.2.PositionNormalized.2=1.0&BlendList.1=RV01&BlendList.2=RV02&MixList.1=RV01&MixList.2=RV02&<公共请求参数>
返回示例
{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
    "LayoutId": "21926b36-7dd2-4fde-ae25-51b5bc8e52d8"
}

特殊错误码

错误代码 描述 Http 状态码 语义
IllegalOperation Permission Denied 401 无权访问导播台
InvalidVideoLayersAndBlendListSize.Mismatch Specified parameter VideoLayers and BlendList size is invalid. 400 指定VideoLayers参数不合法
InvalidVideoLayersAndBlendListSize.Mismatch Specified parameter AudioLayers and MixList size is invalid. 400 指定AudioLayers参数不合法
InvalidPositionNormalized.Malformed Specified parameter PositionNormalized size should be 2 is invalid. 400 指定位置信息数组不合法,由两个浮点数组成
InvalidLayout.NotFound Layout is not found 404 找不到该布局
InvalidResource.NotFound Reference resource of layout is not found 404 找不到该资源
InternalError The request processing has failed due to some unknown error, exception or failure. 500 内部错误