Method: createConferenceWithBots.create

创建会议并添加聊天机器人。

聊天机器人要求的视频分辨率与 Meet 客户端使用“自动”时要求的分辨率相同。布局。请参阅 https://support.google.com/meethardware/answer/9295022。

  • 如果 numOfBots == 1：机器人将向当前说话者请求高清 (1280x720)。
  • 如果 numOfBots <6：聊天机器人将请求所有参与者使用 VGA (640x360)。
  • 如果 numOfBots <16：机器人会向所有参与者请求 HVGA (480x270)。
  • 否则：机器人会向所有参与者请求 HQVGA (240x135)。

HTTP 请求

POST https://botsondemand.googleapis.com/v1/createConferenceWithBots

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  },
  "perBotOptions": [
    {
      object (BotOptions)
    }
  ]
}
字段
numOfBots

integer

必需。要添加的聊天机器人数量必须介于 1 到 50 之间。
ttlSecs

integer

必需。聊天机器人在会议中保留的 TTL（以秒为单位）。
defaultBotOptions

object (BotOptions)

可选。根据此请求创建的所有聊天机器人的默认选项。
perBotOptions[]

object (BotOptions)

可选。针对此请求中创建的聊天机器人的“每个聊天机器人”选项。如果提供的选项少于聊天机器人的数量，系统会为剩余聊天机器人使用默认选项。

响应正文

对 {@link CreateConferenceWithBotsRequest} 的响应

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
字段
conferenceCode

string

已创建的会议。
errorMessages[]

string

失败的聊天机器人返回的错误消息。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/meetings

如需了解详情，请参阅 OAuth 2.0 概览。

BotOptions

各聊天机器人特有的选项

JSON 表示法 
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean,
  "playbackVideo": enum (VideoFile),
  "outputResolution": enum (SupportedVideoResolutions)
}
字段
requestedResolution

enum (SupportedVideoResolutions)

可选。聊天机器人请求的传入解决方案。
muteAudio

boolean

可选。将聊天机器人发送的音频设为静音，默认值为 False
muteVideo

boolean

可选。将聊天机器人发送的视频静音（默认值为“False”）
playbackVideo

enum (VideoFile)

可选。聊天机器人应播放的视频文件
outputResolution

enum (SupportedVideoResolutions)

可选。漫游器发送的视频分辨率， 将选择与此分辨率匹配的视频播放。仅当未设置 playVideo 时，才使用此字段。

SupportedVideoResolutions

支持的视频分辨率预设

枚举
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED 未指定分辨率
THUMBNAIL_160_120 缩略图分辨率
QVGA_320_180 宽高比为 16:9 的 QVGA 分辨率
HVGA_480_270 宽高比为 16:9 的 HVGA 分辨率
VGA_640_360 16:9 宽高比的 VGA 分辨率
HD_1280_720 高清分辨率（16:9 宽高比）
FHD_1920_1080 全高清分辨率（16:9 宽高比）

VideoFile

支持外部合作伙伴的视频播放

枚举
VIDEO_FILE_UNSPECIFIED 未指定文件
SINGLE_ATTENDEE_IDLE_1 单个会议参加者坐着不动
SINGLE_ATTENDEE_CLAPPING_1 单个会议参加者鼓掌