הדף הזה מתאר איך לקבל את אובייקט הלקוח התוסף צריך לתקשר עם Google Meet.
קודם כל, התוסף צריך ליצור סשן:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
מהסשן אפשר ליצור שני אובייקטים של לקוח:
MeetMainStageClient
בשביל תוסף שפועל שלב, שניתן לאחזר באמצעותawait session.createMainStageClient()
.MeetSidePanelClient
בשביל תוסף שפועל בצד חלונית, ניתן לאחזר באמצעותawait session.createSidePanelClient()
.
חשוב לאחזר את אובייקט הלקוח הנכון בכל השלב הראשי
או בחלונית הצדדית. אם מאחזרים את הלקוח הלא נכון, מתבצעת דחייה של ה-SDK של Google Meet לתוספים.
חריג. כדי לבדוק איזה iframe (שלב ראשי או חלונית צדדית) צריך להוסיף
שבו התוסף פועל, צריך להשתמש
MeetAddon.getFrameType
.
דוגמת הקוד הבאה מראה איך ליצור את אובייקט הלקוח בשלב הראשי:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
const mainStageClient = await session.createMainStageClient();
פונקציונליות משותפת
חלק מהתכונות זמינות גם ב-MeetMainStageClient
וגם
MeetSidePanelClient
, ואילו פונקציונליות אחרת היא ספציפית
הלקוח.
לדוגמה, חלק מהפונקציונליות הזמינה בשני הלקוחות כוללת:
MeetAddonClient.getCollaborationStartingState
מקבלת מידע על המצב הראשוני של תוסף כשהמשתתף מאשר את ההזמנה לעבוד יחד.MeetAddonClient.getMeetingInfo
שמקבלת פרטים על הפגישה שבה פועל.MeetAddonClient.getMeetPlatformInfo
שמקבלת פרטים על הפלטפורמה של הפגישות שבה פועל.MeetAddonClient.setCollaborationStartingState
שקובע את המצב הראשוני של התוסף כאשר המשתתף מקבל את ההזמנה לשתף פעולה.- לרשימה מקיפה של הפונקציונליות בשני הלקוחות:
MeetAddonClient
לאובייקט.
פונקציונליות ספציפית ללקוח
הפונקציונליות הזמינה רק
MeetMainStageClient
:
MeetMainStageClient.notifySidePanel
שולח הודעה לחלונית הצדדית. ההודעה יכולה להתקבל על ידי הרשמה ל-frameToFrameMessage קריאה חוזרת בחלונית הצדדית.MeetMainStageClient.loadSidePanel
פותח את ה-iframe של החלונית הצדדית. מקור ה-iframe מוגדר כתובת ה-URL של החלונית הצדדית מקובץ המניפסט.MeetMainStageClient.unloadSidePanel
סוגר את ה-iframe של החלונית הצדדית. התוסף המצב לא נשמר ב-Meet כשמפעילים את השיטה. הבחירה של התוסף תישאר בתוקף את מצב התוסף לפני הקריאה של השיטה הזו.
הפונקציונליות הזמינה רק
MeetSidePanelClient
:
MeetSidePanelClient.notifyMainStage
שולחת הודעה לשלב הראשי. ניתן לקבל את ההודעה באמצעות הרשמה ל-frameToFrameMessage של קריאה חוזרת בשלב הראשי.