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

الترويج لإضافة من خلال مشاركة الشاشة

توضِّح هذه الصفحة كيفية الترويج لمكوّن إضافي للمستخدمين أثناء مشاركة شاشة علامة تبويب مع 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، يمكنك اتّباع تعليمات حزمة npm لحزمة تطوير برامج Add-ons SDK في Meet.

أولاً، ثبِّت حزمة npm:

npm install @googleworkspace/meet-addons

بعد ذلك، تتوفّر حزمة SDK لـ "ملحقات Meet" من خلال استيراد واجهة MeetAddonScreenshareExport:

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

بالنسبة إلى مستخدمي TypeScript، يتم تجميع تعريفات TypeScript مع الوحدة.

لغة gstatic

تتوفّر حزمة تطوير البرامج (SDK) لـ "إضافات Google Meet" كمجموعة JavaScript من gstatic، وهو نطاق يعرض محتوى ثابتًا.

لاستخدام حزمة SDK لـ Meet Add-ons، أضِف علامة النص البرمجي التالية إلى تطبيقك:

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

تتوفّر حزمة SDK الخاصة بإضافات Meet من خلال واجهة MeetAddon ضمن window.meet.addon.

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

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

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

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

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

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

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

تتضمن نموذج الوظيفة الإضافية "Animation" على 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: سلسلة رقم مشروعك على Cloud
  • SIDE_PANEL_URL: سلسلة تمثّل هذه السمة عنوان URL الخاص باللوحة الجانبية.

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

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

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

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

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