توضّح هذه الصفحة كيفية الحصول على كائن العميل الذي تحتاج إليه الإضافة للاتصال بتطبيق Google Meet.
أولاً، تحتاج الإضافة إلى إنشاء جلسة:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
من الجلسة، يمكن إنشاء كائنين للعميل:
MeetMainStageClient
للإضافة التي يتم تشغيلها في المرحلة الرئيسية، ويمكن استردادها باستخدامawait session.createMainStageClient()
.MeetSidePanelClient
للإضافة التي يتم تشغيلها في اللوحة الجانبية، ويمكن استردادها باستخدامawait session.createSidePanelClient()
.
من المهم استرداد كائن العميل الصحيح إما للمرحلة الرئيسية أو اللوحة الجانبية. في حال استرداد العميل الخاطئ، تعرض حزمة تطوير البرامج (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
:
- يتم إرسال رسالة إلى
المنصة الرئيسية من خلال
MeetSidePanelClient.notifyMainStage
. يمكن تلقي الرسالة من خلال الاشتراك في رد اتصال frameToFrameMessage في الشاشة الرئيسية.