本指南提供相關操作說明,說明如何解決在建構及測試 Meet 外掛程式時,可能會遇到的特定 Google Meet 外掛程式 SDK 錯誤。
如要取得錯誤的詳細資料,請使用 MeetAddonError
物件。其中包含 errorType
屬性,可指定錯誤類型。
錯誤類型
以下是 Meet 外掛程式 SDK 擲回錯誤時產生的錯誤類型,以及如何解讀這些錯誤的說明,以及收到錯誤時該如何處理的說明。
錯誤 | 錯誤訊息 | 動作 |
---|---|---|
ActivityIsOngoing |
活動執行期間無法執行作業。 | 確認活動並未持續進行。 |
ActivityStartingStateEmpty |
活動啟動狀態為空白。 | 您已提供 ActivityStartingState 物件,但該物件不含任何屬性。 |
ActivityStartingStateMissingAttributes |
活動啟動狀態不含任何已辨識的屬性。 | 請確認 ActivityStartingState 物件至少包含下列其中一個屬性:mainStageUrl 、sidePanelUrl 或 additionalData 。 |
ActivityStartingStateUnrecognizedAttributes |
活動啟動狀態包含系統無法辨識的屬性。 | 請確認 ActivityStartingState 物件僅含有下列屬性:mainStageUrl 、sidePanelUrl 或 additionalData 。 |
AddonSessionAlreadyCreated |
外掛程式工作階段已建立。 | 只將 AddonSession 例項化一次。 |
AddonStartingStateMissingAttributes |
外掛程式啟動狀態不含任何可辨識的屬性。 | 請確認 AddonStartingState 物件至少包含下列其中一個屬性:sidePanelUrl 、additionalData 。 |
AddonStartingStateUnrecognizedAttributes |
外掛程式啟動狀態含有系統無法辨識的屬性。 | 請確認 AddonStartingState 物件只有下列屬性:sidePanelUrl 、additionalData 。 |
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 |
使用者並非目前活動的發起者。 | 請確認使用者是目前活動的發起者,或是活動已結束。 |