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

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

أولاً، تحتاج الإضافة إلى إنشاء جلسة:

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

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

من المهم استرداد كائن العميل الصحيح إما للمرحلة الرئيسية أو اللوحة الجانبية. في حال استرداد العميل الخاطئ، تعرض حزمة تطوير البرامج (SDK) لإضافات 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: