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

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

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

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

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

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

  • AddonScreenshareInfo.cloudProjectNumber: مطلوبة رقم مشروع Google Cloud للإضافة.

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

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

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

استبدِل ما يلي:

  • CLOUD_PROJECT_NUMBER: سلسلة رقم مشروعك على السحابة الإلكترونية.
  • MAIN_STAGE_URL: سلسلة عنوان URL للمرحلة الرئيسية.

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.0/meet.addons.screenshare.js"></script>
<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. يؤدي النقر على الزرّ في إعلان البانر إلى فتح الإضافة الخاصة برقم المشروع على السحابة الإلكترونية في اللوحة الجانبية. يتمّ تحميل AddonScreenshareInfo.sidePanelUrl ويتم استخدام AddonScreenshareInfo.additionalData لضبط حالة بدء التعاون للإضافة. يُطلب على الفور من المستخدمين الآخرين في المكالمة تثبيت الإضافة أو تشغيلها.

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

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.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. يؤدي النقر على الزرّ في إعلان البانر إلى فتح الإضافة الخاصة برقم المشروع على السحابة الإلكترونية في اللوحة الجانبية. بما أنّه تم ضبط AddonScreenshareInfo.startActivityOnOpen على "خطأ"، تم إيقاف زر بدء النشاط إلى أن يتم ضبط CollaborationStartingState. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام حالة بدء التعاون.

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

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

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

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

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