الترويج لإضافة للمستخدمين

يمكن للمطوّرين زيادة فرص العثور على إضافاتهم من خلال الترويج لها عبر محادثة Meet أثناء المكالمة ومن خلال ميزة مشاركة الشاشة في Meet.

المحادثة أثناء المكالمة

يتم الترويج لإضافات Google Meet للمستخدمين في المحادثة داخل المكالمة في Meet تلقائيًا عندما تحتوي الرسالة على روابط مرتبطة بإضافة. ليس على المطوّر اتّخاذ أي إجراء للترويج للإضافات في المحادثة. يحدّد فريق المراجعة الروابط التي سيتم ربطها بإضافة معيّنة استنادًا إلى معرّف الموارد المنتظم(URI) للّوحة الجانبية ومصادر الإضافة التي تم ضبطها في بيان النشر.

عندما يرسل المستخدمون رسالة من خلال محادثة داخل المكالمة مرتبطة بإضافة، يحدث أحد الأمرين التاليين:

1. إذا لم تكن الإضافة مثبَّتة، ستطلب بطاقة من المستخدم تثبيتها.
2. إذا كانت الإضافة مثبَّتة، سيظهر زر لتذكير المستخدم بفتحها.

مشاركة الشاشة

توضّح هذه الصفحة كيفية الترويج لإضافة للمستخدمين أثناء مشاركة شاشة علامة تبويب باستخدام Google Meet من خلال وضع جزء صغير من الرمز على صفحة ويب أخرى.

تتيح طريقة exposeToMeetWhenScreensharing() للموقع الإلكتروني إرسال معلومات إلى Meet عند مشاركة علامة التبويب على الشاشة. تُستخدَم هذه المعلومات في تجربة الإضافة مع Meet عندما ينقر المستخدم على "بدء النشاط" في بانر العرض التقديمي إذا كانت الإضافة مثبّتة لديه. إذا لم تكن الإضافة مثبَّتة لدى المستخدم عند مشاركة علامة تبويب، سيُطلب منه تثبيتها.

يحتوي العنصر AddonScreenshareInfo على خمس سمات يمكن إضافتها استنادًا إلى حالة الاستخدام:

• additionalData: معلومات يمكن أن تستخدمها الإضافة لتهيئة نفسها. لا يمكن ضبطها إلا إذا كانت السمة startActivityOnOpen مضبوطة على "صحيح"، ويمكن الوصول إليها باستخدام ActivityStartingState. لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على حالة بدء النشاط.

• cloudProjectNumber: هذه السمة مطلوبة. رقم مشروعك على Google Cloud

• استبدِل mainStageUrl بما يلي: عنوان URL الذي تفتح فيه النافذة الرئيسية عند بدء تشغيل الإضافة، مثل https://www.example.com. يجب أن ينتمي عنوان URL إلى المصدر نفسه الذي تنتمي إليه عناوين URL المحدّدة في بيان الإضافة.

• استبدِل sidePanelUrl بما يلي: عنوان URL الذي تفتح به اللوحة الجانبية عند بدء تشغيل الإضافة، مثل https://www.example.com. يجب أن ينتمي عنوان URL إلى المصدر نفسه الذي تنتمي إليه عناوين URL المحدّدة في بيان الإضافة.

• startActivityOnOpen: هذه السمة مطلوبة. تحديد ما إذا كان سيتم بدء تجربة إضافة النشاط في Meet فورًا عندما يبدأ المستخدم الإضافة من بانر العرض التقديمي يجب أن تكون القيمة صحيحة في حال استخدام السمة mainStageUrl.

تثبيت حزمة تطوير البرامج (SDK) واستيرادها

يمكنك الوصول إلى حزمة تطوير البرامج (SDK) باستخدام npm أو gstatic.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

مثال: التحميل في اللوحة الجانبية بدون بدء نشاط

في نموذج الرمز البرمجي التالي، يشارك مستخدم شاشة مع إضافة تتطلب تعديل أذونات الموارد قبل أن يتمكن من بدء النشاط. بسبب هذا الشرط، يجب بدء الإضافة في اللوحة الجانبية، بدون بدء النشاط للجميع.

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

غيِّر القيم في السلسلة على الشكل التالي:

• ‫CLOUD_PROJECT_NUMBER: سلسلة. يشير ذلك إلى رقم مشروعك على السحابة الإلكترونية.
• ‫SIDE_PANEL_URL: سلسلة. تمثّل هذه السمة عنوان URL الخاص باللوحة الجانبية.

عندما يشارك المستخدم الصفحة من شاشة مكالمة Meet، يظهر له بانر عرض تقديمي في Meet. يؤدي النقر على الزر في البانر إلى فتح الإضافة الخاصة برقم مشروع السحابة الإلكترونية المحدّد في اللوحة الجانبية. بما أنّ قيمة السمة startActivityOnOpen تم ضبطها على "خطأ"، سيتم إيقاف زر بدء النشاط إلى أن يتم ضبط قيمة ActivityStartingState. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام حالة بدء النشاط.

بعد بدء النشاط، يُطلب من المستخدمين الآخرين في المكالمة إما تشغيل الإضافة أو تثبيتها.

يتضمّن نموذج الإضافة"الرسوم المتحركة" على GitHub هذا المثال كجزء من إضافة كاملة. عندما يتم عرض صفحة الفهرس لتطبيق الويب المرتبط بالإضافة، سيُطلب من المستخدم الذي يعرض الصفحة تثبيت الإضافة أو إعدادها.

مثال: التحميل في الشاشة الرئيسية

في نموذج الرمز البرمجي التالي، يُطلب من مستخدم يشارك شاشة صفحة ويب في اجتماع Meet يتضمّن الرمز التالي تشغيل الإضافة:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

غيِّر القيم في السلسلة على الشكل التالي:

• ‫CLOUD_PROJECT_NUMBER: سلسلة. رقم مشروعك على Google Cloud
• ‫MAIN_STAGE_URL: سلسلة. عنوان URL للمسرح الرئيسي

عندما يشارك المستخدم الصفحة من شاشة مكالمة Meet، يظهر له بانر عرض تقديمي في Meet. يؤدي النقر على الزر في البانر إلى فتح الإضافة لرقم مشروع السحابة الإلكترونية المحدّد في المرحلة الرئيسية. يتم تحميل السمة mainStageUrl، ويتم استخدام السمة additionalData لضبط حالة بدء النشاط للإضافة. سيُطلب من المستخدمين الآخرين في المكالمة على الفور تثبيت الإضافة أو تشغيلها.

مثال: التحميل في اللوحة الجانبية

في نموذج الرمز التالي، يشارك المستخدم شاشة مع إضافة تريد أن تبدأ في اللوحة الجانبية بدلاً من المساحة الرئيسية:

<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

غيِّر القيم في السلسلة على الشكل التالي:

• ‫CLOUD_PROJECT_NUMBER: سلسلة. يشير ذلك إلى رقم مشروعك على السحابة الإلكترونية.
• ‫SIDE_PANEL_URL: سلسلة. تمثّل هذه السمة عنوان URL الخاص باللوحة الجانبية.

عندما يشارك المستخدم الصفحة من شاشة مكالمة Meet، يظهر له بانر عرض تقديمي في Meet. يؤدي النقر على الزر في البانر إلى فتح الإضافة الخاصة برقم مشروع السحابة الإلكترونية المحدّد في اللوحة الجانبية. يتم تحميل السمة sidePanelUrl، ويتم استخدام السمة additionalData لضبط حالة بدء النشاط للإضافة. سيُطلب من المستخدمين الآخرين في المكالمة على الفور تثبيت الإضافة أو تشغيلها.

مطابقة المصدر

تتم مقارنة المصادر المقدَّمة في السمة mainStageUrl والسمة sidePanelUrl بالمصادر الواردة في ملف بيان الإضافة الخاص برقم مشروع السحابة الإلكترونية المقدَّم. إذا تطابقت جميع المعلومات، سيُسمح للمستخدم بتشغيل الإضافة.

بالإضافة إلى ذلك، يجب إدراج مصدر الموقع الإلكتروني الذي يبدأ مشاركة الشاشة في الحقل addOnOrigins في بيان الإضافة.

لمزيد من المعلومات، يُرجى الاطّلاع على أمان الإضافات.

مواضيع ذات صلة

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