التعاون باستخدام إضافة Meet

يمكن للمشاركين في اجتماع التعاون في نشاط إضافة Google Meet. عند بدء نشاط تعاوني، يتلقّى جميع المشاركين في الاجتماع إشعارًا بأنّ النشاط جارٍ.

يتم تكييف هذا الإشعار مع حالة توفّر الإضافة وتثبيتها:

  • إذا كانت الإضافة مثبَّتة لدى المشارك: يمكنه الانضمام إلى النشاط.

  • إذا لم تكن الإضافة مثبَّتة لدى المشارك: سيتم توجيهه لتثبيتها.

  • إذا لم تكن الإضافة متاحة للنظام الأساسي الذي يستخدمه المشارك: سيتم إبلاغه بأنّه لا يمكنه الانضمام إلى النشاط باستخدام جهازه الحالي.

عندما ينضم مستخدم إلى النشاط، سيتم تحميل إطارات iframe الخاصة به مع محتوى الإضافة. يمكنك تخصيص ما إذا كان يجب على المنضمين الجدد فتح النشاط التعاوني في المرحلة الرئيسية أو اللوحة الجانبية.

بدء النشاط

يتم بدء نشاط من خلال استدعاء الطريقة startActivity() التي تستخدم واجهة ActivityStartingState.

الخطوة 1 (اختيارية): تضبط الإضافة حالة بدء النشاط

يحتوي ActivityStartingState على معلومات حول الحالة الأولية للإضافة التي يتم استخدامها عندما يقبل المشارك الدعوة للانضمام إلى النشاط.

يمكن للإضافة ضبط أو تعديل ActivityStartingState من خلال استدعاء طريقة setActivityStartingState() في أي وقت قبل النشاط أو أثناءه. يمكن حذف المكالمات إلى setActivityStartingState() إذا تم ضبط ActivityStartingState حصريًا في المكالمة إلى startActivity().

الخطوة 2: تبدأ الإضافة النشاط

يبدأ النشاط عندما تستدعي الإضافة طريقة startActivity() في MeetSidePanelClient. تستخدم الطريقة startActivity() كائن ActivityStartingState كمَعلمة، لذا يمكن استدعاء startActivity() بدلاً من استدعاء setActivityStartingState().

بعد أن يكمل المستخدم اختيار المحتوى ويصبح جاهزًا لبدء نشاط، يمكنك استدعاء طريقة startActivity() في الإضافة على النحو التالي:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

عند استدعاء الإجراء startActivity()، ينفّذ Meet الإجراءات التالية:

  • بالنسبة إلى المشاركين الآخرين: يعرض Meet إشعارًا بأنّ النشاط جارٍ.

  • بالنسبة إلى البادئ: إذا تم تحديد عنوان URL للعرض الرئيسي في ActivityStartingState، يفتح Meet العرض الرئيسي باستخدام عنوان URL من ActivityStartingState.

الخطوة 3: الحصول على حالة بدء النشاط

عندما ينضم مستخدم إلى النشاط، يتم تحميل الإضافة في العرض الرئيسي أو اللوحة الجانبية حسب ActivityStartingState.

باستخدام السمة additionalData، يمكنك مشاركة البيانات الأولية (يُشار إليها أيضًا باسم الحالة) مع المستخدمين الذين ينضمون إلى النشاط. بعد إعداد MainStageClient أو SidePanelClient، يمكنك استدعاء طريقة getActivityStartingState() لاسترداد السمة additionalData.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

الخطوة 4 (اختيارية): مشاركة حالة الإضافة في نشاط

يمكنك أيضًا مشاركة الحالة بين المستخدمين أثناء استمرار النشاط من خلال إنشاء الخلفية الخاصة بك للمزامنة.

مثال: إضافة Animation على GitHub

تتضمّن نموذج الإضافة "Animation" على GitHub التعاون في إضافة. الخطوة 1 من هذا الدليل غير مضمّنة في النموذج. بدلاً من ذلك، عندما ينقر المستخدم الذي بدأ الإضافة على الزر "بدء الصورة المتحركة" في اللوحة الجانبية، يتم استدعاء الطريقة startActivity() (الخطوة 2) من خلال تعبئة حالة البدء باللون الذي اختاره المستخدم. بعد بدء النشاط، يستردّ المسرح الرئيسي الحالة الأولية من خلال استدعاء الطريقة getActivityStartingState() (الخطوة 3). يتم حذف الخطوة 4، لأنّ الحالة (اللون المحدّد) لا تتم مشاركتها بين المشاركين أثناء النشاط في هذه الإضافة النموذجية. ومع ذلك، يمكن للمستخدمين الفرديين تغيير حالتهم من خلال اختيار لون يتم إرساله من إطار اللوحة الجانبية إلى إطار العرض الرئيسي باستخدام المراسلة من إطار إلى إطار.

القيود

  • يجب أن تنتمي عناوين URL المحدّدة في ActivityStartingState إلى المصدر نفسه الذي تنتمي إليه المصادر المحدّدة في بيان الإضافة. لمزيد من المعلومات، يُرجى الاطّلاع على أمان الإضافات.
  • يجب أن يتوافق عدد أحرف السمة sidePanelUrl والسمة mainStageUrl والسمة additionalData مع حدود الحجم الخاصة بكل منها كما هو منشور في المستندات المرجعية لحزمة تطوير البرامج (SDK).