الحصول على كائن العميل

تصف هذه الصفحة كيفية الحصول على كائن العميل الذي الإضافة إلى الاتصال بـ Google Meet.

أولاً، يجب أن تنشئ الإضافة جلسة:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

من الجلسة، يمكن إنشاء كائنَين للعميل:

• MeetMainStageClient للحصول على إضافة تعمل في الصفحة الرئيسية المرحلة، قابلة للاسترداد باستخدام await session.createMainStageClient().

• MeetSidePanelClient للحصول على وظيفة إضافية يتم تشغيلها في جانب لوحة، قابلة للاسترداد باستخدام await session.createSidePanelClient().

من المهم استرداد كائن العميل الصحيح لأي من المرحلة الرئيسية أو اللوحة الجانبية في حال استرداد العميل الخاطئ، سيتم طرح حزمة تطوير البرامج للإضافات في Google Meet. باستثناء كاليفورنيا. للتحقق من إطار iframe (المرحلة الرئيسية أو اللوحة الجانبية) تشغيل الإضافة، استخدم MeetAddon.getFrameType .

يعرض نموذج التعليمات البرمجية التالي كيفية إنشاء مثيل لكائن عميل المرحلة الرئيسية:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });
  const mainStageClient = await session.createMainStageClient();

الوظائف المشتركة

تتوفّر بعض الوظائف في كل من MeetMainStageClient و MeetSidePanelClient، في حين أن الوظائف الأخرى تعتمد على نوع معين البرنامج.

على سبيل المثال، تشمل بعض الوظائف المتوفرة في كلا العميلين ما يلي:

• MeetAddonClient.getCollaborationStartingState تحصل على معلومات حول الحالة الأولية عندما يقبل المشارك الدعوة للتعاون.
• MeetAddonClient.getMeetingInfo تحصل على تفاصيل حول الاجتماع الذي تشغيل الوظيفة الإضافية.
• MeetAddonClient.getMeetPlatformInfo تحصل على تفاصيل حول منصة الاجتماعات التي تشغيل الوظيفة الإضافية.
• MeetAddonClient.setCollaborationStartingState يضبط الحالة الأولية للوظيفة الإضافية عند المشارك قبول الدعوة للتعاون.
• للحصول على قائمة شاملة بالوظائف في كلا البرنامجين، راجع MeetAddonClient الخاص بك.

الوظائف الخاصة بالعميل

تتوفّر الوظائف فقط في MeetMainStageClient:

• MeetMainStageClient.notifySidePanel إرسال رسالة إلى اللوحة الجانبية. يمكن استلام الرسالة من خلال الاشتراك في frameToFrameMessage رد الاتصال في اللوحة الجانبية.

• MeetMainStageClient.loadSidePanel يفتح إطار iframe في اللوحة الجانبية. تم ضبط مصدر iframe على عنوان URL في اللوحة الجانبية من ملف البيان.

• MeetMainStageClient.unloadSidePanel لإغلاق إطار iframe في اللوحة الجانبية. الإضافة في Meet عند استدعاء الطريقة. الأمر متروك للإضافة للاحتفاظ بأي حالة الوظيفة الإضافية قبل استدعاء هذه الطريقة.

تتوفّر الوظائف فقط في MeetSidePanelClient:

• MeetSidePanelClient.notifyMainStage يرسل رسالة إلى الصفحة الرئيسية. يمكن تلقّي الرسالة عند الاشتراك. إلى frameToFrameMessage للاتصال في المرحلة الرئيسية.