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

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

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

  • AddonScreenshareInfo.sidePanelUrl: عنوان URL الذي تفتحه اللوحة الجانبية بعد إضافة الإضافة تبدأ، مثل https://www.example.com. يجب أن ينتمي عنوان URL إلى عنوان URL نفسه origin كما هي عناوين 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 تتم المقارنة بالمصادر في الإضافة البيان الخاص برقم مشروع Cloud المقدَّم. إذا تطابق كل شيء، فسيحتاج المستخدم السماح لهم بتشغيل الوظيفة الإضافية.

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

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