שיתוף פעולה באמצעות תוסף ל-Meet

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

ההתראה הזו הותאמה לזמינות ולסטטוס ההתקנה של :

  • אם התוסף מותקן אצל המשתתף: הם יוכלו להצטרף לפעילות.

  • אם לנוכח/ת לא מותקן התוסף מותקנים: הם מקבלים הנחיה להתקין את

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

כשמשתמש יצטרף לפעילות, הוא יטען את מסגרות ה-iframe שלו עם תוכן של תוספים. אתם יכולים לקבוע אם משתמשים חדשים יצטרכו לפתוח את הפעילות המשותפת בשלב הראשי או בחלונית הצדדית.

התחלת הפעילות

כדי להפעיל פעילות, צריך להפעיל את השיטה startActivity() שמשתמשת בממשק ActivityStartingState.

שלב 1 (אופציונלי): התוסף מגדיר את מצב ההתחלה של הפעילות

ActivityStartingState מכיל מידע על המצב הראשוני של שנעשה בו שימוש כשהמשתתף מאשר את הזמנה להצטרף לפעילות.

התוסף יכול להגדיר או לעדכן ActivityStartingState באמצעות קריאה אל setActivityStartingState() בכל שלב לפני הפעילות או במהלכה. אפשר להשמיט קריאות ל-setActivityStartingState() אם הערך של ActivityStartingState מוגדר באופן בלעדי בקריאה ל-startActivity().

שלב 2: התוסף מתחיל את הפעילות

הפעילות מתחילה כשהתוסף קורא לשיטה startActivity() ב-MeetSidePanelClient. ה-method ‏startActivity() מקבל אובייקט ActivityStartingState כפרמטר, כך שאפשר להפעיל את startActivity() במקום להפעיל את setActivityStartingState().

אחרי שהמשתמש משלים את בחירת התוכן ומתכונן להתחיל פעילות, צריך להפעיל את השיטה startActivity() בתוסף באופן הבא:

    sidePanelClient.startActivity({
        mainStageUrl: "https://app.example.com/mainstage",
        additionalData: JSON.stringify({
            // State to send to participants.
        })
    });

כשמפעילים את method startActivity(), Meet מבצע את את הפעולות הבאות:

  • למשתתפים אחרים: ב-Meet מוצגת התראה הפעילות היא פעילות.

  • ליוזם המודעה: אם כתובת ה-URL של השלב הראשי צוינה ActivityStartingState, השלב הראשי ב-Meet ייפתח באמצעות את כתובת ה-URL מ-ActivityStartingState.

שלב 3: מציגים את מצב התחלת הפעילות

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

עם הנכס additionalData, אפשר לשתף נתונים ראשוניים (שנקראים גם כמצב) עם משתמשים שמצטרפים לפעילות. אחרי אתחול MainStageClient או SidePanelClient, את יכול לקרוא getActivityStartingState() כדי לאחזר את המאפיין additionalData.

const startingState = client.getActivityStartingState();
const additionalData = JSON.parse(startingState.additionalData);

שלב 4 (אופציונלי): שיתוף המצב של התוסף בפעילות

אפשר גם לשתף את המצב בין משתמשים בזמן שהפעילות מתבצעת. יש שתי דרכים לשתף מצב:

  • לטפל בזה בעצמכם על ידי יצירת קצה עורפי משלכם לסנכרון.
  • להשתמש ב-Co-Doing API, שהוא דרך נוחה ומהירה לשיתוף נתונים שרירותיים בין משתמשים.

דוגמה: תוסף אנימציה ב-GitHub

"אנימציה" דוגמה של תוסף ב-GitHub כולל שיתוף פעולה בתוסף. שלב 1 מהמדריך הזה לא נכלל בדוגמה. במקום זאת, מפעיל התוסף לוחץ על "הפעלת האנימציה" לחצן בחלונית הצדדית, השיטה startActivity() נקראת (שלב 2) על ידי אכלוס המצב ההתחלתי בצבע שנבחר על ידי המשתמש. אחרי שהפעילות מתחילה, השלב הראשי מאחזר את מצב ההתחלה על ידי קריאה ל-method‏ getActivityStartingState() (שלב 3). שלב 4 לא מופיע בתור מצב ( בצבע שנבחר) לא ישותף בין המשתתפים במהלך הפעילות. של תוסף לדוגמה. עם זאת, משתמשים ספציפיים יכולים לשנות את הסטטוס שלהם על ידי בחירת צבע, שיישלח מהמסגרת של החלונית הצדדית למסגרת של הבמה הראשית באמצעות הודעות ממסגרת למסגרת.

מגבלות