Method: createConferenceWithBots.create

Tạo một hội nghị và thêm các bot.

Độ phân giải video mà các bot yêu cầu giống với độ phân giải mà ứng dụng Meet yêu cầu bằng cách sử dụng chế độ "Tự động" của bạn. Hãy truy cập vào https://support.google.com/meethardware/answer/9295022.

  • nếu numOfBots == 1: bot sẽ yêu cầu HD (1280x720) từ người nói đang hoạt động.
  • nếu numOfBots < 6: các bot sẽ yêu cầu VGA (640x360) từ tất cả những người tham gia.
  • nếu numOfBots < 16: các bot sẽ yêu cầu HVGA (480x270) từ tất cả người tham gia.
  • nếu không: bot sẽ yêu cầu HQVGA (240x135) từ tất cả người tham gia.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "numOfBots": integer,
  "ttlSecs": integer,
  "defaultBotOptions": {
    object (BotOptions)
  },
  "perBotOptions": [
    {
      object (BotOptions)
    }
  ]
}
Trường
numOfBots

integer

Bắt buộc. Số lượng bot cần thêm phải nằm trong khoảng từ 1 đến 50.
ttlSecs

integer

Bắt buộc. Thời gian tồn tại (TTL tính bằng giây) để bot ở lại cuộc họp.
defaultBotOptions

object (BotOptions)

Không bắt buộc. Các lựa chọn mặc định cho tất cả bot được tạo theo yêu cầu này.
perBotOptions[]

object (BotOptions)

Không bắt buộc. Các lựa chọn cho mỗi bot đối với các bot được tạo theo yêu cầu này. Nếu số lượng bot đưa ra ít hơn số lượng bot, thì các lựa chọn mặc định sẽ được sử dụng cho những bot còn lại.

Nội dung phản hồi

Phản hồi cho {@link CreateConferenceWithBotsRequest}

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "conferenceCode": string,
  "errorMessages": [
    string
  ]
}
Trường
conferenceCode

string

Hội nghị truyền hình đã tạo.
errorMessages[]

string

Thông báo lỗi do các bot bị lỗi trả về.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

BotOptions

Các lựa chọn dành riêng cho từng bot

Biểu diễn dưới dạng JSON 
{
  "requestedResolution": enum (SupportedVideoResolutions),
  "muteAudio": boolean,
  "muteVideo": boolean,
  "playbackVideo": enum (VideoFile),
  "outputResolution": enum (SupportedVideoResolutions)
}
Trường
requestedResolution

enum (SupportedVideoResolutions)

Không bắt buộc. Độ phân giải do bot yêu cầu.
muteAudio

boolean

Không bắt buộc. Tắt tiếng âm thanh gửi từ bot, mặc định là False
muteVideo

boolean

Không bắt buộc. Tắt tiếng video do bot gửi, mặc định là False
playbackVideo

enum (VideoFile)

Không bắt buộc. Tệp video mà bot sẽ phát
outputResolution

enum (SupportedVideoResolutions)

Không bắt buộc. Độ phân giải của video đi do bot gửi sẽ chọn một video phát phù hợp với độ phân giải này. Tính năng này chỉ được sử dụng nếu bạn chưa thiết lập trường videoPlaybackVideo.

SupportedVideoResolutions

Chế độ đặt sẵn độ phân giải video được hỗ trợ

Enum
SUPPORTED_VIDEO_RESOLUTIONS_UNSPECIFIED Chưa xác định độ phân giải
THUMBNAIL_160_120 Độ phân giải hình thu nhỏ
QVGA_320_180 Độ phân giải QVGA theo tỷ lệ 16:9
HVGA_480_270 Độ phân giải HVGA theo tỷ lệ 16:9
VGA_640_360 Độ phân giải VGA theo tỷ lệ 16:9
HD_1280_720 Độ phân giải HD theo tỷ lệ 16:9
FHD_1920_1080 Độ phân giải FHD theo tỷ lệ 16:9

VideoFile

Video phát được hỗ trợ cho các đối tác bên ngoài

Enum
VIDEO_FILE_UNSPECIFIED Tệp chưa được chỉ định
SINGLE_ATTENDEE_IDLE_1 Một người tham dự cuộc họp đang không hoạt động
SINGLE_ATTENDEE_CLAPPING_1 Một người tham dự cuộc họp đang vỗ tay