קידום תוסף למשתמשים באמצעות שיתוף המסך

בדף הזה נסביר איך לקדם תוסף מסוים למשתמשים בזמן שיתוף כרטיסייה עם Google Meet באמצעות הצבת קוד קטן בדף אינטרנט אחר.

השיטה MeetAddonScreenshare.exposeToMeetWhenScreensharing מאפשרת לאתר לשלוח מידע ל-Meet כשהכרטיסייה שלו משותפת במסך. המידע הזה ישמש בחוויית התוסף ב-Meet כשהמשתמש ילחץ על 'התחלת הפעילות' בבאנר של המצגת, אם התוסף מותקן אצלו. אם התוסף לא מותקן אצל המשתמש כשהוא משתף כרטיסייה במסך, תופיע בקשה להתקין אותו.

האובייקט AddonScreenshareInfo מכיל חמישה שדות שאפשר להוסיף בהתאם לתרחיש לדוגמה הרלוונטי:

• AddonScreenshareInfo.additionalData: מידע שהתוסף יכול להשתמש בו כדי לאתחל את עצמו. אפשר להגדיר אותה רק אם הערך של AddonScreenshareInfo.startActivityOnOpen הוא True ואפשר לגשת אליו באמצעות 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.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 הוגדר כ-False, הלחצן 'התחלת הפעילות' מושבת עד להגדרת CollaborationStartingState. מידע נוסף מופיע במאמר שימוש במצב ההתחלה של שיתוף הפעולה.

אחרי שהפעילות מתחילה, משתמשים אחרים בשיחה מתבקשים להפעיל או להתקין את התוסף.

התאמת מקור

המקורות שצוינו ב-AddonScreenshareInfo.mainStageUrl וב-AddonScreenshareInfo.sidePanelUrl מושווים למקורות במניפסט התוסף של מספר הפרויקט בענן שסופק. אם הכול תואם, המשתמש יוכל להפעיל את התוסף.

בנוסף, צריך לציין את המקור של האתר שמתחיל את שיתוף המסך בשדה addOnOrigins במניפסט התוספים.

למידע נוסף, ראו אבטחת תוספים.

נושאים קשורים

• שימוש במצב ההתחלה של שיתוף הפעולה
• אבטחת תוספים