Method: createConferenceWithBots.create

يتم إنشاء مكالمة فيديو وإضافة برامج تتبُّع.

إن درجة دقة الفيديو التي تطلبها برامج التتبُّع تحاكي درجة الدقة التي قد يطلبها عميل Meet باستخدام الخيار "تلقائي". التصميم. يُرجى الاطّلاع على https://support.google.com/meethardware/answer/9295022.

  • إذا كان numOfBots == 1: ستطلب برامج التتبُّع دقة عالية (1280x720) من المتحدّث.
  • إذا كان numOfBots < 6: ستطلب برامج التتبع VGA (640×360) من جميع المشاركين.
  • إذا كان numOfBots < 16: ستطلب برامج التتبُّع HVGA (480×270) من جميع المشاركين.
  • وإلا ستطلب برامج التتبُّع HQVGA (بحجم 240 × 135) من جميع المشاركين.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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 CreateconfWithBotsRequest}

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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)

اختياريّ. درجة دقة الفيديو الصادرة التي ترسلها برامج التتبُّع، سيختار المستخدم تشغيل فيديو مطابق لدرجة الدقة هذه. ولا يتم استخدام ذلك إلا إذا لم يتم ضبط 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 دقة عالية بنسبة 16:9
FHD_1920_1080 دقة FHD بنسبة 16:9

VideoFile

فيديوهات التشغيل المتوافقة للشركاء الخارجيين

عمليات التعداد
VIDEO_FILE_UNSPECIFIED لم يتم تحديد الملف
SINGLE_ATTENDEE_IDLE_1 ضيف في اجتماع واحد يجلس خاملاً
SINGLE_ATTENDEE_CLAPPING_1 الحاضرون في اجتماع واحد يصفقون