במדריך הזה מפורטות הוראות לפתרון שגיאות ספציפיות ב-SDK של תוספים ל-Google Meet שעשויות להתרחש במהלך פיתוח ובדיקה של תוספים ל-Meet.
כדי לקבל פרטים על שגיאה, משתמשים באובייקט MeetAddonError. הוא מכיל את המאפיין errorType שמציין את סוג השגיאה.
סוגי שגיאות
ריכזנו כאן את סוגי השגיאות שנוצרים כש-SDK של התוספים ל-Meet מחזיר שגיאה, יחד עם הסבר על המשמעות שלהן והנחיות למקרה שתקבלו אותן.
| שגיאה | הודעת שגיאה | פעולה |
|---|---|---|
ActivityIsOngoing |
אי אפשר לבצע פעולה בזמן שפעילות מתבצעת. | ודאו שהפעילות לא מתבצעת. |
ActivityStartingStateEmpty |
המצב ההתחלתי של הפעילות ריק. | סופק אובייקט ActivityStartingState, אבל הוא לא מכיל מאפיינים. |
ActivityStartingStateMissingAttributes |
המצב ההתחלתי של הפעילות לא מכיל מאפיינים מזוהים. | חשוב לוודא שהאובייקט ActivityStartingState מכיל לפחות אחד מהמאפיינים הבאים: mainStageUrl, sidePanelUrl או additionalData. |
ActivityStartingStateUnrecognizedAttributes |
המאפיינים של סטטוס ההתחלה של הפעילות לא מזוהים. | חשוב לוודא שלאובייקט ActivityStartingState יש רק את המאפיינים הבאים: mainStageUrl, sidePanelUrl או additionalData. |
AddonSessionAlreadyCreated |
סשן התוסף כבר נוצר. | יוצרים את AddonSession רק פעם אחת. |
AddonStartingStateMissingAttributes |
מצב ההתחלה של התוסף לא מכיל מאפיינים מזוהים. | חשוב לוודא שהאובייקט AddonStartingState מכיל לפחות אחד מהמאפיינים הבאים: sidePanelUrl, additionalData. |
AddonStartingStateUnrecognizedAttributes |
מצב ההתחלה של התוסף מכיל מאפיינים לא מזוהים. | חשוב לוודא שלאובייקט AddonStartingState יש רק את המאפיינים הבאים: sidePanelUrl, additionalData. |
ArgumentNullError |
הערך של האובייקט שסופק הוא null כשצפוי ערך. | חשוב לוודא שאתם מעבירים ערך מהסוג הצפוי לארגומנט. |
ArgumentTypeError |
הסוג של האובייקט שסופק לא תואם לסוג הצפוי. | חשוב לוודא שהסוג של הארגומנט שסופק תואם לסוג הצפוי. |
DestinationNotReady |
המסגרת של הנמען לא מחוברת באמצעות ערכת ה-SDK של התוספים ל-Meet, ולכן לא ניתן לקבל את ההתראה. | לפני ששולחים הודעות למסגרת היעד, צריך לוודא שהיא מחוברת. |
InternalError |
אירעה שגיאה פנימית ב-Meet. | אין מידע נוסף זמין. |
InvalidActivityStartingState |
כתובות ה-URL של ActivityStartingState iframe לא תואמות למקורות של כתובות ה-URL שצוינו במניפסט של התוסף. |
חשוב לוודא שמקורות כתובות ה-URL של ה-iframe ב-ActivityStartingState תואמים למקורות של כתובות ה-URL שצוינו במניפסט של התוסף. מידע נוסף זמין במאמר אבטחת תוספים. |
InvalidAddonStartingState |
כתובות ה-URL של AddonStartingState iframe לא תואמות למקורות של כתובות ה-URL שצוינו במניפסט של התוסף. |
חשוב לוודא שמקורות כתובות ה-URL של ה-iframe ב-AddonStartingState תואמים למקורות של כתובות ה-URL שצוינו במניפסט של התוסף. |
InvalidCloudProjectNumber |
מספר הפרויקט ב-Cloud שסופק על ידי Meet לא תואם למספר שהוענק על ידי SDK של התוספים של Meet. | חשוב לוודא שמספר הפרויקט הנכון ב-Cloud מועבר ל-SDK כמחרוזת כשקוראים למאפיין createAddonSession או לשיטה exposeToMeetWhenScreenSharing(). הפרמטר הזה מצורף באופן אוטומטי על ידי Meet לכל כתובות ה-URL מסוג iframe. לפני שמשתמשים בערך המועבר, חשוב לוודא שהתשתית לא משנה את הפרמטרים של כתובות ה-URL (למשל, כחלק מהפניה אוטומטית לכתובת אחרת). |
MissingUrlParameter |
חסר פרמטר כתובת ה-URL הנדרש של ה-SDK של התוספים ל-Meet. | הפרמטר הזה מצורף באופן אוטומטי על ידי Meet לכתובת ה-URL של ה-iframe. חשוב לוודא שהתשתית לא משנה את הפרמטרים של כתובות ה-URL (לדוגמה, כחלק מהפניה אוטומטית). |
NeedsMainStageContext |
אפשר להפעיל את השיטה הזו רק אם התוסף פועל בשלב הראשי. | לפני שמפעילים את השיטה הזו, צריך להשתמש במאפיין getFrameType כדי לבדוק אם התוסף פועל בשלב הראשי. |
NeedsSidePanelContext |
אפשר להפעיל את השיטה הזו רק אם התוסף פועל בחלונית הצדדית. | לפני שמפעילים את השיטה הזו, צריך להשתמש במאפיין getFrameType כדי לבדוק אם התוסף פועל בחלונית הצדדית. |
NoActivityFound |
לא נמצאה פעילות בזמן ביצוע פעולה. | לפני ביצוע הפעולה הזו, חשוב לוודא שהפעילות מופעלת. |
NotSupportedInMeetCall |
אי אפשר להשתמש בשיטה הזו בשיחות ב-Meet. | אין להפעיל את השיטה הזו במהלך שיחת Meet. |
NotSupportedInStandalone |
אין תמיכה בשיטה הזו במצב עצמאי. | אין להפעיל את השיטה הזו במצב עצמאי. |
RequiresEapEnrollment |
השיטה המבוקשת דורשת הרשמה ל-EAP. | ההרשמה לגישה מוקדמת לתוסף של Google Meet נסגרה. |
SizeLimitExceededActivityStartingState |
גודל כתובות ה-URL של ActivityStartingState ו/או הנתונים שלהן חורג מהמגבלות המותרות. |
חשוב לוודא שגודל כתובת ה-URL של ActivityStartingState הוא פחות מ-512 תווים, ושהנתונים הנוספים הם פחות מ-4,096 תווים. |
SizeLimitExceededAddonStartingState |
גודל כתובות ה-URL של AddonStartingState ו/או הנתונים שלהן חורג מהמגבלות המותרות. |
חשוב לוודא שגודל כתובת ה-URL של AddonStartingState הוא פחות מ-512 תווים, ושהנתונים הנוספים הם פחות מ-4,096 תווים. |
SizeLimitExceededFrameToFrameMessage |
גודל ההודעה ממסגרת למסגרת חורג מהמגבלות המותרות. | חשוב לוודא שגודל ההודעה שמופיעה בכל פריים הוא פחות מ-1,000,000 תווים. |
UserCancelled |
המשתמש ביטל את ההתחלה של הפעילות. | המשתמש צריך ללחוץ על 'המשך' כדי להתחיל את הפעילות. |
UserNotInitiator |
המשתמש לא הוא זה שהתחיל את הפעילות הנוכחית. | מוודאים שהמשתמש הוא זה שהתחיל את הפעילות הנוכחית או שהפעילות הסתיימה. |