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

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

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

  • AddonScreenshareInfo.sidePanelUrl כתובת ה-URL שהחלונית הצדדית נפתחת אחרי התוסף מתחיל, למשל https://www.example.com. כתובת ה-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 מוגדר כ-False, הלחצן 'התחלת פעילות' מושבת עד CollaborationStartingState הוגדרה. מידע נוסף זמין במאמר שימוש שיתוף הפעולה מתחיל .

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

התאמת מקור

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

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

למידע נוסף, ראו תוסף .