全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
视频直播

修改布局

更新时间:2017-11-29 15:11:09

描述

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

请求参数

参数 类型 必须? 描述
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

参数 类型 必须? 描述
HeightNormalized Float 设置该layer元素的高度归一化比例值,其中元素的宽度会按照该高度来进行等比缩放。默认值 0 表示按照元素的原始尺寸进行显示。
WidthNormalized Float 设置该layer元素的宽度归一化比例值,其中元素的高度会按照该宽度来进行等比缩放。默认值 0 表示按照元素的原始尺寸进行显示。该字段和heightNormalized有冲突,一旦heightNormalized和widthNormalized都设置了,则只有heightNormalized有效。如果heightNormalized和widthNormalized设置只能同时设置一个,后面设置的值会影响前面设置的。
PositionNormalizeds []Float 设置该layer 元素的位置归一化值[x,y], 默认为[0,0]。注意x,y需要进行归一化计算。

AudioLayer

参数 类型 必须? 描述
VolumeRate Float 设置该layer元素的高度归一化比例值,其中元素的宽度会按照该高度来进行等比缩放。默认值 0 表示按照元素的原始尺寸进行显示。
ValidChannel String 确定哪些声道可以作为音量输入,取值范围”leftChannel/rightChannel/all”默认是”all”。

返回参数

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

特殊错误码

错误代码 描述 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 内部错误

示例

请求示例:

  1. 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&<公共请求参数>

返回示例

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  3. "LayoutId": "21926b36-7dd2-4fde-ae25-51b5bc8e52d8"
  4. }
本文导读目录