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

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

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

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

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

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

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

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

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

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

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