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

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