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

查询布局列表

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

描述

查询布局列表

请求参数

参数 类型 必须? 描述
Action String 操作接口名,系统规定参数,取值:DescribeCasterLayouts
CasterId String 导播台Id

返回参数

参数 类型 描述
RequestId String 该条任务请求Id
Layouts []Layout 布局列表

Layout

参数 类型 描述
LayoutId String 布局Id
VideoLayers []VideoLayer videolayer配置列表,采用数组默认序列
AudioLayers []AudioLayer Audiolayer配置列表
BlendList []String 位置关联列表,与VideoLayers顺序保持一致
MixList []String 位置关联列表,与AudioLayers顺序保持一致

videoLayer

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

AudioLayer

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

特殊错误码

错误代码 描述 Http 状态码 语义
IllegalOperation Permission Denied 401 无权访问导播台
InvalidCaster.NotFound Caster 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=DescribeCasterLayouts&CasterId=a2b8e671-2fe5-4642-a2ec-bf93880e1a49&<公共请求参数>
  2. }

返回示例

  1. {
  2. "RequestId": "3be7ade8-d907-483c-b24a-0dad4595beaf",
  3. "Layouts": [
  4. {
  5. "MixList": [
  6. "RV01"
  7. ],
  8. "AudioLayers": [
  9. {
  10. "ValidChannel": "all",
  11. "VolumeRate": 1
  12. }
  13. ],
  14. "VideoLayers": [
  15. {
  16. "HeightNormalized": 0.5,
  17. "PositionRefer": "topLeft",
  18. "WidthNormalized": 0.5,
  19. "PositionNormalized": [
  20. 0,
  21. 0.3
  22. ]
  23. },
  24. {
  25. "HeightNormalized": 0.5,
  26. "PositionRefer": "topLeft",
  27. "WidthNormalized": 0.5,
  28. "PositionNormalized": [
  29. 0.5,
  30. 0.3
  31. ]
  32. }
  33. ],
  34. "LayoutId": "72d2ec7a-4cd7-4a01-974b-7cd53947f053",
  35. "BlendList": [
  36. "RV01",
  37. "RV02"
  38. ]
  39. },
  40. {
  41. "MixList": [
  42. "RV01"
  43. ],
  44. "AudioLayers": [
  45. {
  46. "ValidChannel": "all",
  47. "VolumeRate": 0.5
  48. }
  49. ],
  50. "VideoLayers": [
  51. {
  52. "HeightNormalized": 1,
  53. "PositionRefer": "topLeft",
  54. "WidthNormalized": 1,
  55. "PositionNormalized": [
  56. 0,
  57. 0
  58. ]
  59. },
  60. {
  61. "HeightNormalized": 0.4,
  62. "PositionRefer": "topLeft",
  63. "WidthNormalized": 0.4,
  64. "PositionNormalized": [
  65. 0.1,
  66. 0.1
  67. ]
  68. }
  69. ],
  70. "LayoutId": "21926b36-7dd2-4fde-ae25-51b5bc8e52d8",
  71. "BlendList": [
  72. "RV01",
  73. "RV02"
  74. ]
  75. }
  76. ]
  77. }
本文导读目录