Method: createConferenceWithBots.create

建立會議並新增機器人。

機器人會模仿 Meet 用戶端使用「自動」指令要求的解析度版面配置。詳情請參閱 https://support.google.com/meethardware/answer/9295022。

  • if numOfBots == 1：機器人將向播放中的喇叭要求 HD (1280x720)。
  • if numOfBots <6：機器人會要求所有參與者使用 VGA (640x360)。
  • if 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

必要欄位。機器人要留在會議中的存留時間 (單位為秒)。
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 QVGA 解析度，比例為 16:9
HVGA_480_270 HVGA 解析度 (長寬比為 16:9)
VGA_640_360 VGA 解析度 (長寬比為 16:9)
HD_1280_720 HD 高畫質解析度 (長寬比：16:9)
FHD_1920_1080 FHD 解析度，比例為 16:9

VideoFile

外部合作夥伴支援的播放影片

列舉
VIDEO_FILE_UNSPECIFIED 未指定檔案
SINGLE_ATTENDEE_IDLE_1 單一會議與會者坐著閒置
SINGLE_ATTENDEE_CLAPPING_1 單一會議與會者拍手