إدارة كائنات العميل

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

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

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

استبدِل CLOUD_PROJECT_NUMBER برقم مشروعك على Google Cloud.

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

• MeetMainStageClient لإضافة يتم تشغيلها في المرحلة الأساسية، ويمكن استرجاعها باستخدام await session.createMainStageClient().

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

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

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

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

استبدِل CLOUD_PROJECT_NUMBER برقم مشروعك على Cloud.

الميزات المشتركة

تتوفّر بعض الميزات في كلّ من "MeetMainStageClient" و MeetSidePanelClient، في حين أن الميزات الأخرى خاصة بعنصر البرنامج.

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

• getActivityStartingState() تحصل على معلومات حول الحالة الأولية عندما يقبل المشارك الدعوة للانضمام إلى النشاط.
• getMeetingInfo() تحصل على تفاصيل حول الاجتماع الذي تشغيل الوظيفة الإضافية.
• setActivityStartingState() الطريقة التي تضبط الحالة الأولية للإضافة عندما يقبل المشارك الدعوة للانضمام إلى النشاط
• للحصول على قائمة شاملة بالميزات في كلا العميلين، يُرجى الاطّلاع على MeetAddonClient الخاص بك.

الميزات الخاصة بالعميل

الميزات المتاحة فقط في MeetMainStageClient الكائن:

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

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

• unloadSidePanel() لإغلاق إطار iframe في اللوحة الجانبية. الإضافة في Meet عند استدعاء الطريقة. يُرجى العِلم أنّه على الإضافة الاحتفاظ بأي حالة للإضافة قبل استدعاء هذه الطريقة.

الميزات المتوفّرة في عنصر MeetSidePanelClient فقط:

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