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

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