排解及修正 Meet 外掛程式錯誤

本指南說明如何解決 建構及測試時可能遇到的 Google Meet 外掛程式 SDK 錯誤 Meet 外掛程式。

如要取得錯誤詳細資料,請使用 MeetAddonError敬上 物件。這個 SDK 包含 errorType敬上 屬性,用來指定錯誤類型。

錯誤類型

以下是 Meet 外掛程式 SDK 時產生的錯誤類型 會產生錯誤,並提供如何解讀錯誤內容的說明 收到相關通知時該怎麼做

錯誤 錯誤訊息 動作
CoactivityIsOngoing 正在進行協作,因此無法執行作業。 確認不再進行協作。
DestinationNotReady 收件者頁框未使用 Meet 外掛程式 SDK 連線,因此無法接收通知。 請先確認目的地頁框已連線,再傳送訊息。
InvalidCloudProjectNumber Meet 提供的 Cloud 專案編號與 Meet 外掛程式 SDK 傳遞的檔案不符。 確認在呼叫 createAddonSessionexposeToMeetWhenScreenSharing 時,正確的 Cloud 專案編號會以字串形式傳遞至 SDK。Meet 會自動將這個參數附加至所有 iframe 網址。請先確認基礎架構並未修改網址參數 (例如在重新導向時),再使用傳送的值。
InvalidCollaborationStartingState CollaborationStartingState iframe 網址與外掛程式資訊清單中提供的網址來源不符。 請確認 CollaborationStartingState iframe 網址來源與外掛程式資訊清單中提供的網址來源相符。詳情請參閱外掛程式安全性
MissingUrlParameter 缺少必要的 Meet 外掛程式 SDK 網址參數。 系統會自動將這個參數附加至 iframe 網址。確認基礎架構並未修改網址參數 (例如重新導向的過程中)。
NeedsMainStageContext 只有在外掛程式在主要階段執行時,才能叫用這個方法。 叫用這個方法前,請先使用 getFrameType 檢查外掛程式是否在主要階段執行。
NeedsSidePanelContext 只有在外掛程式是在側邊面板中執行時,才能叫用這個方法。 叫用這個方法前,請先使用 getFrameType 檢查外掛程式是否正在側邊面板中執行。
NotSupportedInStandalone 獨立模式不支援這個方法。 請勿在獨立模式下呼叫這個方法。
RequiresEapEnrollment 這項功能僅供搶先體驗合作夥伴使用。 由於 Meet 外掛程式 SDK 搶先體驗註冊已關閉,因此請勿使用這項功能。
SizeLimitExceededCollaborationStartingState CollaborationStartingState 網址及/或其中的資料大小超出允許的上限。 請確認 CollaborationStartingState 網址大小不超過 512 個半形字元,且資料大小不超過 4,096 個半形字元。
SizeLimitExceededFrameToFrameMessage 畫面至頁框的訊息大小超過允許的上限。 確認頁框對頁框的郵件大小小於 1 MB。
UserNotInitiator 使用者不是目前的協作發起者。 確認使用者是目前的協作發起者,或是協作已結束。
InternalError Meet 發生內部錯誤, 無法提供進一步的資訊。
CollaborationStartingStateMissingAttributes 協作的起始狀態不含任何可識別的屬性。 提供的 CollaborationStartingState 物件不含任何可辨識的屬性。
CollaborationStartingStateEmpty 協作的起始狀態空白。 已提供 CollaborationStartingState 物件,但當中不含任何屬性。
CollaborationStartingStateUnrecognizedAttributes 協作的起始狀態含有無法辨識的屬性。 提供的 CollaborationStartingState 物件含有無法辨識的屬性。