التعاون باستخدام إضافة 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 (اختيارية): مشاركة حالة الإضافة في نشاط

يمكنك أيضًا مشاركة الحالة بين المستخدمين أثناء استمرار النشاط. يمكنك مشاركة الحالة بطريقتين:

  • يمكنك معالجة ذلك بنفسك من خلال إنشاء الخلفية الخاصة بالمزامنة.
  • استخدِم Co-Doing API، وهي طريقة ملائمة وسريعة لمشاركة البيانات العشوائية بين المستخدمين.

مثال: إضافة الصور المتحركة على GitHub

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

القيود

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