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

添加布局

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

描述

添加布局,定义布局中的画面来源、数量、位置、坐标、宽高等。

请求参数

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

系统规定参数。取值:AddCasterLayout

BlendList.N RepeatList RV01

资源位置locationId关联列表,与videoLayers顺序保持一致。

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

导播台Id。

MixList.N RepeatList RV01

资源位置locationId关联列表,与audioLayers顺序保持一致。

AudioLayer.N.ValidChannel String all

Audiolayer配置列表,元素为音频配置信息 - 输入声道,确定哪些声道可以作为音量输入。取值范围:

  • leftChannel
  • rightChannel
  • all
默认值: all

AudioLayer.N.VolumeRate Float 1

Audiolayer配置列表,元素为音频配置信息 - 音量。调节音频流的音量大小倍数:

  • 1.0表示保持原有音量,
  • <1表示降低音量的倍数,
  • >1表示放大的倍数
取值范围:[0,10.0]
默认值:1.0

Version String 2016-11-01

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

VideoLayer.N.HeightNormalized Float 1

Videolayer配置列表,元素为视频画面的配置信息 - 高度。设置该layer元素的高度归一化比例值,其中元素的宽度会按照该高度来进行等比缩放。
默认值:0,表示按照元素的原始尺寸进行显示。

VideoLayer.N.PositionNormalized.N RepeatList 0.3

Videolayer配置列表,元素为视频画面的配置信息 - 位置。设置该layer 元素的位置归一化值[x,y]。
默认值:[0,0]
注意 x、y 需要进行归一化计算。

VideoLayer.N.PositionRefer String topLeft

Videolayer配置列表,元素为视频画面的配置信息 - 参考坐标。设置元素的position参考坐标值。取值范围:

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

VideoLayer.N.WidthNormalized Float 1

Videolayer配置列表,元素为视频画面的配置信息 - 宽度。设置该layer元素的宽度归一化比例值,其中元素的高度会按照该宽度来进行等比缩放。
默认值:0,表示按照元素的原始尺寸进行显示。

返回参数

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

该条任务请求Id

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

布局Id

示例

请求示例

  1. https://live.aliyuncs.com?Action=AddCasterLayout&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. }

错误码

查看本产品错误码

本文导读目录