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

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

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

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

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

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

  • cloudProjectNumber: يجب إدخال اسم صالح. رقم مشروعك على Google Cloud

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

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

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/1.0.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: سلسلة رقم مشروع مشروع Google Cloud.
  • MAIN_STAGE_URL: سلسلة عنوان URL للمرحلة الرئيسية.

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

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

في نموذج الرمز البرمجي التالي، تشارك شاشة أحد المستخدمين صفحة مع تريد أن تبدأ في اللوحة الجانبية بدلاً من أعلى من المرحلة الرئيسية:

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

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

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

<script src="https://www.gstatic.com/meetjs/addons/1.0.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. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام حالة البدء للنشاط.

بعد بدء النشاط، يُطلب من المستخدمين الآخرين في المكالمة اتّخاذ أحد الإجراءَين التاليَين: تشغيل أو تثبيت الوظيفة الإضافية.

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

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

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

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