本指南將說明如何解決您在建構及測試 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 提供的 Cloud 專案編號與 Meet 外掛程式 SDK 傳入的編號不符。 | 請務必在呼叫 createAddonSession 屬性或 exposeToMeetWhenScreenSharing() 方法時，將正確的 Cloud 專案編號以字串形式傳遞至 SDK。Meet 會自動將這個參數附加到任何 iframe 網址。請確認基礎架構不會在使用傳入的值前修改網址參數 (例如做為重新導向的一部分)。 |
MissingUrlParameter |
缺少 Meet 外掛程式 SDK 網址參數。 | Meet 會自動將這個參數附加到 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 |
使用者並非目前活動的發起者。 | 請確認使用者是目前活動的發起者，或是活動已結束。 |