腾讯会议添加自定义布局_办公协同解决方案

接口描述

描述:对当前会议添加高级自定义布局,支持批量添加。用户座次设置需设置参会成员。单个会议最多允许添加20个布局。目前暂不支持 OAuth2.0 鉴权访问。目前仅会应用于 H.323/SIP 终端。请求方式: POST接口请求域名:

https://api.meeting.qq.com/v1/meetings/{meeting_id}/advanced-layouts

输入参数

参数名称 必选 参数类型 参数描述
operator_id String 操作人 ID。
operator_id_type Integer 操作人 ID 类型。1:userid4:ms_open_id
instanceid Integer 用户的终端设备类型:0:PSTN1:PC2:Mac3:Android4:iOS5:Web6:iPad7:Android Pad8:小程序9:voip、sip 设备10:Linux20:Rooms for Touch Windows21:Rooms for Touch MacOS22:Rooms for Touch Android30:Controller for Touch Windows32:Controller for Touch Android33:Controller for Touch iOS
layout_list layout_list 对象数组 布局对象列表。

layout_list 对象

参数名称 必选 参数类型 参数描述
layout_name String 布局名称。
page_list PageList 对象数组 布局单页对象列表。

PageList 对象

参数名称 必选 参数类型 参数描述
layout_template_id String 布局模板 ID。
enable_polling Boolean 开启或关闭轮询,默认关闭。
polling_setting PollingSetting 对象 轮询参数设置对象。
user_seat_list UserSeatList 对象数组 用户座次对象列表。

PollingSetting 对象

参数名称 必选 参数类型 参数描述
polling_interval_unit Integer 轮询开启后设置参数。 轮询间隔时间类型: 1:秒 2:分钟
polling_interval Integer 轮询开启后设置参数 轮询间隔时长,允许取值范围1~999999。
ignore_user_novideo Boolean 轮询开启后设置参数,设置是否忽略没开启视频成员。
ignore_user_absence String 轮询开启后设置参数,设置是否忽略未入会成员。

UserSeatList 对象

参数名称 必选 参数类型 参数描述
grid_id String 宫格 ID。
grid_type Integer 宫格类型: 1:视频画面2:共享画面
video_type Integer 视频画面来源: 1:演讲者 2:自动填充 3:指定人员根据 user_list 的定义显示视频内容(此类型需传递 userid 或 ms_open_id、username 入参,作为视频画面展示;若会中参会成员有外部企业用户,需传递该用户的 ms_open_id;如果 userid、ms_open_id 同时传递则以 ms_open_id 为准)。
user_list UserList 对象数组 宫格中的用户列表:轮询关闭,只有一个用户:轮询开启后,可以包含多个用户。

UserList 对象

参数名称 必选 参数类型 参数描述
userid String 用户 ID。
ms_open_id String 用户当前会议临时身份 ID,单场会议唯一。
username String 用户昵称,base64 编码。

输出参数

参数名称 必选 参数类型 参数描述
layout_list LayoutList 对象数组 布局对象列表

LayoutList 对象

参数名称 必选 参数类型 参数描述
layout_id String 布局 ID。
layout_name String 布局名称。
page_list PageList 对象数组 布局单页对象列表。

PageList 对象

参数名称 必选 参数类型 参数描述
layout_template_id String 布局模板 ID。
enable_polling Boolean 开启或关闭轮询,默认关闭。
polling_setting PollingSetting 对象 轮询参数设置对象。
user_seat_list UserSeatList 对象数组 用户座次对象列表。

PollingSetting 对象

参数名称 必选 参数类型 参数描述
polling_interval_unit Integer 轮询开启后设置参数。 轮询间隔时间类型: 1:秒 2:分钟
polling_interval Integer 轮询开启后设置参数 轮询间隔时长,允许取值范围1~999999。
ignore_user_novideo Boolean 轮询开启后设置参数,设置是否忽略没开启视频成员。
ignore_user_absence String 轮询开启后设置参数,设置是否忽略未入会成员。

UserSeatList 对象

参数名称 必选 参数类型 参数描述
grid_id String 宫格 ID。
grid_type Integer 宫格类型: 1:视频画面 2:共享画面
video_type Integer 视频画面来源: 1:演讲者 2:自动填充 3:指定人员根据 user_list 的定义显示视频内容(此类型需传递 userid 或 ms_open_id、username 入参,作为视频画面展示;若会中参会成员有外部企业用户,需传递该用户的 ms_open_id;如果 userid、ms_open_id 同时传递则以 ms_open_id 为准)。
user_list UserList 对象数组 宫格中的用户列表:轮询关闭,只有一个用户:轮询开启后,可以包含多个用户。

UserList 对象

参数名称 是否必须 参数类型 参数描述
userid 非必须 String 用户 ID。
ms_open_id 非必须 String 用户当前会议临时身份 ID,单场会议唯一。
username 非必须 String 用户昵称,base64 编码。

示例

输入示例

{    "operator_id": "test_restapi_user_937",    "operator_id_type": 1,    "instanceid": 7,    "layout_list": [{        "layout_name": "testmictest",        "page_list": [{            "layout_template_id": "3",            "enable_polling": true,            "polling_setting": {                "polling_interval_unit": 1,                "polling_interval": 10,                "ignore_user_novideo": false,                "ignore_user_absence": false            },            "user_seat_list": [{                "grid_id": "1",                "grid_type": 1,                "video_type": 3,                "user_list": [{                    "userid": "test_restapi_user_938",                    "username": "test_restapi_user_938"                }]            }]        }]    }]}

输出示例

{    "layout_list": [{        "layout_id": "04bcd40d-xxxx-xxxx-xxxx-424716cd5f50",        "layout_name": "testmictest",        "page_list": [{            "layout_template_id": "3",            "enable_polling": true,            "polling_setting": {                "polling_interval": 10,                "polling_interval_unit": 1,                "ignore_user_absence": false,                "ignore_user_novideo": false            },            "user_seat_list": [{                "grid_id": "1",                "grid_type": 1,                "video_type": 3,                "user_list": [{                    "userid": "test_restapi_user_938",                    "username": "test_restapi_user_938"                }]            }]        }]    }]}



对腾讯办公协同的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案