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

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

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

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

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

דוגמה: טעינה בשלב הראשי

בדוגמת הקוד הבאה, משתמש שמשתף מסך משתף דף אינטרנט ב-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 הוגדר כ-False, לחצן התחלת הפעילות מושבת עד שהCollaborationStartingState יוגדר. למידע נוסף ראו את המאמר שימוש במצב ההתחלה של שיתוף הפעולה.

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

התאמת מוצא

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

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

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