华为云会议 MEETING-设置自定义多画面:请求参数

时间:2025-03-27 14:48:52

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

conferenceID

String

Query

会议ID。

X-Conference-Authorization

String

Header

会控Token,通过获取会控token接口获得。

manualSet

Integer

Body

是否为手工设置多画面。

  • 0: 系统自动多画面
  • 1: 手工设置多画面

picLayoutInfo

PicLayoutInfo object

Body

会议自定义多画面布局信息。

说明:

预留参数,当前版本不可用。

imageType

String

Body

画面类型。手工设置多画面时有效。imageType取值和画面布局的对应关系详见图1

subscriberInPics

Array of SubscriberInPic objects

Body

子画面列表(手工设置多画面时必填)。

switchTime

Integer

Body

表示轮询间隔,取值范围:10-120,默认10。单位:秒。

当同一个子画面中包含有多个与会者时,此参数有效。

说明:

仅针对专业会议终端生效,对软终端不生效。

multiPicSaveOnly

Boolean

Body

多画面是否仅保存。

  • true: 仅保存
  • false: 保存并应用
说明:
  • ”仅保存“效果:仅保存当前画面布局,不进行广播等操作。
  • ”保存并应用“效果:

    1、当会议状态为广播多画面、声控单画面、声控多画面、主持人观看多画面时,保存并应用后,改变画面布局,不改变状态。

    2、当会议状态为非广播多画面、声控单画面、声控多画面、主持人观看多画面时,如自动多画面、广播与会者、点名与会者时,保存并应用后,变为广播多画面。

  • 当处于广播多画面、声控多画面、声控单画面状态下,无法设置主持人观看多画面。
图1 imageType(画面类型)参考

imageType取布局图下方的字符串。举例说明:如果需要设置多画面样式为均分四画面,则imageType设置为“Four”。

表3 PicLayoutInfo数据结构

参数

是否必须

类型

描述

x

Integer

多画面布局的宽度。

y

Integer

多画面布局的高度。

subPicLayoutInfoList

Array of SubPicLayoutInfo objects

子画面布局具体列表。

表4 SubPicLayoutInfo数据结构

参数

是否必须

类型

描述

id

Integer

画面索引号。

left

Integer

画面从左到右的坐标点。

top

Integer

画面从上到下的坐标点。

xSize

Integer

小画面的宽度。

ySize

Integer

小画面的高度。

表5 SubscriberInPic 数据结构

参数

是否必须

类型

描述

index

Integer

多画面中每个画面的编号。编号从1开始。

默认值为“1”

subscriber

Array of strings

每个画面中与会者号码,从查询会议实时信息接口返回participants中的phone中获取。

isAssistStream

Integer

是否为辅流。默认值为0。

  • 0: 不是辅流
  • 1: 是辅流
support.huaweicloud.com/api-meeting/meeting_21_0418.html