本指南提供相關操作說明，協助您解決建構及測試 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 網址。請確認基礎架構不會在您使用傳遞的值之前，修改網址參數 (例如，做為重新導向的一部分)。 |
MeetingPolicyPreventsStartingActivity |
會議政策 (例如使用主辦人控制項設定) 會禁止使用者發起活動。 | 請會議主辦人或管理員修改必要設定，允許目前使用者啟動活動。 |
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 |
使用者不是目前活動的發起人。 | 請確認使用者是目前活動的發起者，或活動已結束。 |