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

توضّح هذه الصفحة كيفية إدارة كائنات العميل التي تحتاج إليها إضافة للتواصل مع 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() method.

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

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

استبدِل CLOUD_PROJECT_NUMBER برقم مشروع على السحابة الإلكترونية الخاص بك.

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

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

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

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

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

الميزات المتوفّرة في الكائن MeetMainStageClient فقط:

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

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

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

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

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