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

קידום תוסף במסך בשיתוף.

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

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

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

  • additionalData: מידע שבעזרתו התוסף יכול לאתחל את עצמו. אפשר להגדיר את הערך רק אם המאפיין startActivityOnOpen מוגדר כ-True ואפשר לגשת אליו באמצעות ActivityStartingState. מידע נוסף זמין במאמר שימוש בפעילות שמתחילה ב- .

  • cloudProjectNumber: זהו שדה חובה. מספר הפרויקט ב-Google Cloud.

  • mainStageUrl: כתובת ה-URL שהשלב הראשי נפתח אחרי שהתוסף נפתח מתחיל, למשל https://www.example.com. כתובת ה-URL חייבת להשתייך לאותה origin ככתובות ה-URL שצוינו מניפסט של תוסף.

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

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

התאמת מקור

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

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

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