全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
视频直播

修改布局

更新时间:2018-03-20 10:07:38

描述

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

请求参数

参数 类型 是否必选 示例值 描述
Action String ModifyCasterLayout

系统规定参数。取值:ModifyCasterLayout

BlendList.N RepeatList RV02

位置关联列表,与VideoLayers顺序保持一致。

CasterId String a2b8e671-2fe5-4642-a2ec-bf93880e1a49

导播台Id。

LayoutId String 21926b36-7dd2-4fde-ae25-51b5bc8e52d8

布局Id

MixList.N RepeatList RV02

位置关联列表,与AudioLayers顺序保持一致。

AudioLayer.N.ValidChannel String all

确定哪些声道可以作为音量输入,取值范围"leftChannel/rightChannel/all"默认是"all"。

AudioLayer.N.VolumeRate Float 1

设置该layer元素的高度归一化比例值,其中元素的宽度会按照该高度来进行等比缩放。
默认值:0,表示按照元素的原始尺寸进行显示。

Version String 2016-11-01

API 版本号为日期形式:YYYY-MM-DD。本版本对应为:2016-11-01。

VideoLayer.N.HeightNormalized Float 1

设置该layer元素的高度归一化比例值,其中元素的宽度会按照该高度来进行等比缩放。
默认值:0,表示按照元素的原始尺寸进行显示。

VideoLayer.N.PositionNormalized.N RepeatList 0.3

设置该layer元素的位置归一化值[x,y]。
默认值:[0,0]
注意 x、y 需要进行归一化计算。

VideoLayer.N.PositionRefer String topLeft

设置元素的position 参考坐标值。取值范围:

  • topLeft
  • topRight
  • bottomLeft
  • bottomRight
  • center
  • topCenter
  • bottomCenter
  • leftCenter
  • rightCenter
默认值: topLeft

VideoLayer.N.WidthNormalized Float 1

设置该layer元素的宽度归一化比例值,其中元素的高度会按照该宽度来进行等比缩放。
默认值:0,表示按照元素的原始尺寸进行显示。

  • 该字段和heightNormalized有冲突,一旦heightNormalized和widthNormalized都设置了,则只有heightNormalized有效。
  • 如果heightNormalized和widthNormalized设置只能同时设置一个,后面设置的值会影响前面设置的。

返回参数

参数 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

该条任务请求Id

LayoutId String 21926b36-7dd2-4fde-ae25-51b5bc8e52d8

布局Id

示例

请求示例

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

正常返回示例

JSON 格式

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

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"live.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
  6. }

错误码

查看本产品错误码

本文导读目录