Method: createConferenceWithBots.create

یک کنفرانس ایجاد می کند و ربات ها را اضافه می کند.

وضوح ویدیویی درخواست شده توسط ربات‌ها، وضوحی را تقلید می‌کند که توسط مشتری Meet با استفاده از طرح‌بندی «خودکار» درخواست می‌شود. به https://support.google.com/meethardware/answer/9295022 مراجعه کنید.

  • اگر numOfBots == 1: ربات ها HD (1280x720) را از بلندگوی فعال درخواست می کنند.
  • اگر numOfBots < 6: ربات ها VGA (640x360) را از همه شرکت کنندگان درخواست خواهند کرد.
  • اگر numOfBots < 16: ربات ها HVGA (480x270) را از همه شرکت کنندگان درخواست خواهند کرد.
  • در غیر این صورت: ربات ها HQVGA (240x135) را از همه شرکت کنندگان درخواست خواهند کرد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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

اختیاری. صدای ارسال شده از ربات را بی صدا کنید، پیش فرض نادرست است

muteVideo

boolean

اختیاری. نادیده گرفتن ویدیو ارسال شده از ربات، نادرست پیش فرض

playbackVideo

enum ( VideoFile )

اختیاری. فایل ویدیویی که ربات باید پخش کند

outputResolution

enum ( SupportedVideoResolutions )

اختیاری. رزولوشن ویدیوی خروجی ارسال شده توسط ربات‌ها، ویدیوی پخشی مطابق با این وضوح را انتخاب می‌کند. این فقط در صورتی استفاده می شود که پخش ویدیو تنظیم نشده باشد.

Resolution های ویدیویی پشتیبانی شده

از پیش تنظیم وضوح تصویر پشتیبانی می شود

Enums
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

پشتیبانی از پخش ویدیو برای شرکای خارجی

Enums
VIDEO_FILE_UNSPECIFIED فایل نامشخص
SINGLE_ATTENDEE_IDLE_1 شرکت کننده مجرد جلسه بیکار نشسته است
SINGLE_ATTENDEE_CLAPPING_1 کف زدن تک شرکت کننده در جلسه