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

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

توضِّح هذه الصفحة كيفية الترويج لمكوّن إضافي للمستخدمين أثناء مشاركة شاشة علامة تبويب مع 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 نفسه origin باعتبارها عناوين URL المحددة في بيان الإضافة.

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

تثبيت حزمة SDK واستيرادها

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

إذا كان مشروعك يستخدم npm، يمكنك اتباع إرشادات حزمة npm لحزمة تطوير البرامج لإضافات 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، وهو نطاق يعرض محتوى ثابتًا.

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

<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: سلسلة. رقم مشروع المشروع على السحابة الإلكترونية.
  • ‫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 ضمن الإضافة .

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