במדריך הזה מפורטות הוראות לפתרון שגיאות ספציפיות ב-SDK של תוספים ל-Google Meet, שיכול להיות שתיתקלו בהן כשאתם יוצרים ובודקים תוספים ל-Meet.
כדי לקבל פרטים על שגיאה, משתמשים באובייקט MeetAddonError. הוא מכיל מאפיין errorType שמציין את סוג השגיאה.
סוגי שגיאות
בהמשך מפורטים סוגי השגיאות שנוצרים כש-Meet add-ons 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 |
ActivityStartingState כתובות ה-URL של ה-iframe לא תואמות למקורות של כתובות ה-URL שצוינו במניפסט של התוסף. |
מוודאים שמקורות כתובות ה-URL של ה-iframe זהים למקורות של כתובות ה-URL שצוינו במניפסט של התוסף.ActivityStartingState מידע נוסף זמין במאמר בנושא אבטחת תוספים. |
InvalidAddonStartingState |
AddonStartingState כתובות ה-URL של ה-iframe לא תואמות למקורות של כתובות ה-URL שצוינו במניפסט של התוסף. |
מוודאים שמקורות כתובות ה-URL של ה-iframe זהים למקורות של כתובות ה-URL שצוינו במניפסט של התוסף.AddonStartingState |
InvalidCloudProjectNumber |
מספר הפרויקט בענן שסופק על ידי Meet לא תואם למספר שהועבר על ידי Meet Add-ons SDK. | חשוב לוודא שמספר הפרויקט הנכון ב-Cloud מועבר ל-SDK כמחרוזת כשקוראים לנכס createAddonSession או לשיטה exposeToMeetWhenScreenSharing(). הפרמטר הזה מצורף אוטומטית על ידי Meet לכל כתובות ה-URL של iframe. חשוב לוודא שהתשתית שלכם לא משנה פרמטרים של כתובות URL (לדוגמה, כחלק מהפניה אוטומטית) לפני שמשתמשים בערך שהועבר. |
MeetingPolicyPreventsStartingActivity |
מדיניות הפגישה (למשל, שימוש בהגדרות של בקרת המארח) מונעת מהמשתמש להתחיל את הפעילות. | מארח הפגישה או האדמין צריכים לשנות את ההגדרות הנדרשות כדי לאפשר למשתמש הנוכחי להתחיל את הפעילות. |
MissingUrlParameter |
חסר פרמטר חובה של כתובת URL ב-Meet Add-ons SDK. | הפרמטר הזה מצורף אוטומטית על ידי Meet לכתובת ה-URL של ה-iframe. חשוב לוודא שהתשתית שלכם לא משנה את הפרמטרים של כתובות ה-URL (לדוגמה, כחלק מהפניה אוטומטית). |
NeedsMainStageContext |
אפשר להפעיל את השיטה הזו רק אם התוסף פועל בשלב הראשי. | כדי לבדוק אם התוסף פועל בשלב הראשי לפני שמפעילים את השיטה הזו, משתמשים במאפיין getFrameType. |
NeedsSidePanelContext |
אפשר להפעיל את השיטה הזו רק אם התוסף פועל בחלונית הצדדית. | לפני שמפעילים את השיטה הזו, צריך להשתמש במאפיין getFrameType כדי לבדוק אם התוסף פועל בחלונית הצדדית. |
NoActivityFound |
לא נמצאה פעילות במהלך ביצוע פעולה. | חשוב לוודא שהפעילות התחילה לפני שמבצעים את הפעולה הזו. |
NotSupportedInMeetCall |
השיטה הזו לא נתמכת בגרסה החדשה של Meet לשיחות. | אל תפעילו את ה-method הזו במהלך שיחה ב-Meet. |
NotSupportedInStandalone |
השיטה הזו לא נתמכת במצב עצמאי. | אל תפעילו את ה-method הזו במצב עצמאי. |
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 |
המשתמש לא יזם את הפעילות הנוכחית. | מוודאים שהמשתמש הוא היוזם של הפעילות הנוכחית או שהפעילות הסתיימה. |