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

本指南提供相關操作說明,說明如何解決在建構及測試 Meet 外掛程式時,可能會遇到的特定 Google Meet 外掛程式 SDK 錯誤。

如要取得錯誤的詳細資料,請使用 MeetAddonError 物件。其中包含 errorType 屬性,可指定錯誤類型。

錯誤類型

以下是 Meet 外掛程式 SDK 擲回錯誤時產生的錯誤類型,以及如何解讀這些錯誤的說明,以及收到錯誤時該如何處理的說明。

錯誤 錯誤訊息 動作
ActivityIsOngoing 活動執行期間無法執行作業。 確認活動並未持續進行。
ActivityStartingStateEmpty 活動啟動狀態為空白。 您已提供 ActivityStartingState 物件,但該物件不含任何屬性。
ActivityStartingStateMissingAttributes 活動啟動狀態不含任何已辨識的屬性。 請確認 ActivityStartingState 物件至少包含下列其中一個屬性:mainStageUrlsidePanelUrladditionalData
ActivityStartingStateUnrecognizedAttributes 活動啟動狀態包含系統無法辨識的屬性。 請確認 ActivityStartingState 物件僅含有下列屬性:mainStageUrlsidePanelUrladditionalData
AddonSessionAlreadyCreated 外掛程式工作階段已建立。 只將 AddonSession 例項化一次。
AddonStartingStateMissingAttributes 外掛程式啟動狀態不含任何可辨識的屬性。 請確認 AddonStartingState 物件至少包含下列其中一個屬性:sidePanelUrladditionalData
AddonStartingStateUnrecognizedAttributes 外掛程式啟動狀態含有系統無法辨識的屬性。 請確認 AddonStartingState 物件只有下列屬性:sidePanelUrladditionalData
ArgumentNullError 在預期值的情況下,提供的物件值為空值。 請確認您傳遞的值符合引數的預期類型。
ArgumentTypeError 提供的物件類型與預期的類型不符。 請確認提供的引數類型與預期類型相符。
DestinationNotReady 接收者畫面未使用 Meet 外掛程式 SDK 連線,因此無法接收通知。 請先確認目的地影格已連線,再傳送訊息。
InternalError Meet 發生內部錯誤, 我們無法提供更多資訊。
InvalidActivityStartingState ActivityStartingState 個 iframe 網址與外掛程式資訊清單中提供的網址來源不符。 請確認 ActivityStartingState iframe 網址來源與外掛程式資訊清單中提供的網址來源相符。詳情請參閱「外掛程式安全性」。
InvalidAddonStartingState AddonStartingState iFrame 網址與擴充功能資訊清單中提供的網址來源不符。 請確認 AddonStartingState iframe 網址來源與外掛程式資訊清單中提供的網址來源相符。
InvalidCloudProjectNumber Meet 提供的雲端專案編號與 Meet 外掛程式 SDK 傳入的編號不符。 請務必在呼叫 createAddonSession 屬性或 exposeToMeetWhenScreenSharing() 方法時,將正確的 Cloud 專案編號以字串形式傳遞至 SDK。Meet 會自動將這個參數附加到任何 iframe 網址。請確認基礎架構不會在使用傳入的值前修改網址參數 (例如在重新導向中)。
MissingUrlParameter 缺少 Meet 外掛程式 SDK 網址參數。 系統會自動將這個參數附加至 iframe 網址。請確認基礎架構不會修改網址參數 (例如在重新導向的過程中)。
NeedsMainStageContext 只有在外掛程式在主要階段執行時,才能叫用此方法。 叫用這個方法前,請先使用 getFrameType 屬性檢查外掛程式是否在主要階段執行。
NeedsSidePanelContext 只有在外掛程式在側邊面板中執行時,才能叫用這個方法。 在叫用這個方法前,請使用 getFrameType 屬性,檢查外掛程式是否正在側邊面板中執行。
NoActivityFound 執行作業時找不到任何活動。 請務必先啟動活動,再執行這項作業。
NotSupportedInMeetCall Meet 通話不支援這個方法。 請勿在 Meet 通話期間呼叫這個方法。
NotSupportedInStandalone 獨立模式不支援這個方法。 請勿在獨立模式下呼叫此方法。
RequiresEapEnrollment 所要求的方法需要 EAP 註冊。 Google Meet 外掛程式搶先體驗方案的註冊已關閉。
SizeLimitExceededActivityStartingState ActivityStartingState 個網址及/或其中的資料大小超出允許的上限。 請確認 ActivityStartingState 網址大小不超過 512 個半形字元,且其他資料大小小於 4,096 個半形字元。
SizeLimitExceededAddonStartingState AddonStartingState 網址和/或資料的大小超出允許的限制。 請確認 AddonStartingState 網址大小少於 512 個半形字元,且其他資料大小少於 4,096 個半形字元。
SizeLimitExceededFrameToFrameMessage 畫面至頁框的訊息大小超過允許的上限。 請確認影格間訊息大小不超過 1,000,000 個半形字元。
UserCancelled 使用者已取消啟動活動。 使用者必須點選「繼續」才能開始活動。
UserNotInitiator 使用者並非目前活動的發起者。 請確認使用者是目前活動的發起者,或是活動已結束。