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