このガイドでは、Meet アドオンの作成とテスト中に発生する可能性のある、Google Meet アドオン SDK の特定のエラーの解決方法について説明します。
エラーの詳細を取得するには、MeetAddonError オブジェクトを使用します。エラーのタイプを指定する errorType プロパティが含まれます。
エラータイプ
Meet Add-ons SDK がエラーをスローしたときに生成されるエラーの種類と、その解釈方法、発生した場合の対処方法は次のとおりです。
| エラー | エラー メッセージ | アクション |
|---|---|---|
ActivityIsOngoing |
アクティビティの進行中はオペレーションを実行できません。 | アクティビティが進行中でない。 |
ActivityStartingStateEmpty |
アクティビティの開始状態が空です。 | ActivityStartingState オブジェクトが指定されていますが、属性が含まれていません。 |
ActivityStartingStateMissingAttributes |
アクティビティの開始状態に、認識された属性が含まれていません。 | ActivityStartingState オブジェクトに、mainStageUrl、sidePanelUrl、additionalData のいずれかの属性が 1 つ以上含まれていることを確認します。 |
ActivityStartingStateUnrecognizedAttributes |
アクティビティの開始状態に認識されない属性が含まれています。 | ActivityStartingState オブジェクトに mainStageUrl、sidePanelUrl、additionalData の属性のみが含まれていることを確認します。 |
AddonSessionAlreadyCreated |
アドオン セッションはすでに作成されています。 | AddonSession を 1 回だけインスタンス化します。 |
AddonStartingStateMissingAttributes |
アドオンの開始状態に認識された属性が含まれていません。 | AddonStartingState オブジェクトに sidePanelUrl または additionalData のいずれかの属性が含まれていることを確認します。 |
AddonStartingStateUnrecognizedAttributes |
アドオンの開始状態に認識されない属性が含まれています。 | AddonStartingState オブジェクトに sidePanelUrl、additionalData の属性のみがあることを確認します。 |
ArgumentNullError |
指定されたオブジェクトの値が null である（値が期待されている）。 | 引数に想定される型の値を渡すようにしてください。 |
ArgumentTypeError |
指定されたオブジェクトの型が想定される型と一致しませんでした。 | 指定した引数の型が、想定される型と一致していることを確認してください。 |
DestinationNotReady |
受信者のフレームが Meet アドオン SDK を使用して接続されていないため、通知を受信できません。 | 宛先フレームにメッセージを送信する前に、宛先フレームが接続されていることを確認してください。 |
InternalError |
Meet の内部エラーが発生しました。 | 詳細情報はありません。 |
InvalidActivityStartingState |
ActivityStartingState iframe の URL が、アドオン マニフェストに指定されている URL のオリジンと一致していません。 |
ActivityStartingState iframe URL のオリジンが、アドオン マニフェストで指定された URL のオリジンと一致していることを確認します。詳しくは、アドオンのセキュリティをご覧ください。 |
InvalidAddonStartingState |
AddonStartingState iframe の URL が、アドオン マニフェストに指定されている URL のオリジンと一致していません。 |
AddonStartingState iframe の URL 生成元が、アドオン マニフェストで指定した URL の生成元と一致していることを確認します。 |
InvalidCloudProjectNumber |
Meet から提供された Cloud プロジェクト番号が、Meet アドオン SDK から渡された番号と一致しません。 | createAddonSession プロパティまたは exposeToMeetWhenScreenSharing() メソッドを呼び出すときに、正しい Cloud プロジェクト番号が文字列として SDK に渡されていることを確認します。このパラメータは、Meet によって iframe URL に自動的に追加されます。渡された値を使用する前に、インフラストラクチャが URL パラメータを変更していないことを確認してください（リダイレクトの一部として変更されている場合など）。 |
MissingUrlParameter |
必須の Meet アドオン SDK URL パラメータがありません。 | このパラメータは、Meet によって iframe URL に自動的に追加されます。インフラストラクチャが URL パラメータを変更していないことを確認します（リダイレクトの一部として変更しないでください）。 |
NeedsMainStageContext |
このメソッドは、アドオンがメインステージで実行されている場合にのみ呼び出すことができます。 | このメソッドを呼び出す前に、getFrameType プロパティを使用して、アドオンがメインステージで実行されているかどうかを確認してください。 |
NeedsSidePanelContext |
このメソッドは、アドオンがサイドパネルで実行されている場合にのみ呼び出すことができます。 | このメソッドを呼び出す前に、getFrameType プロパティを使用して、サイドパネルでアドオンが実行されているかどうかを確認します。 |
NoActivityFound |
オペレーションの実行時にアクティビティが見つかりません。 | このオペレーションを実行する前に、アクティビティが開始されていることを確認してください。 |
NotSupportedInMeetCall |
このメソッドは Meet の通話ではサポートされていません。 | Meet 通話中にこのメソッドを呼び出さないでください。 |
NotSupportedInStandalone |
この方法はスタンドアロン モードではサポートされていません。 | スタンドアロン モードではこのメソッドを呼び出さないでください。 |
RequiresEapEnrollment |
リクエストされた方法では EAP の登録が必要です。 | Google Meet アドオンの早期アクセスの登録受付は終了しました。 |
SizeLimitExceededActivityStartingState |
ActivityStartingState URL またはそのデータのサイズが許容上限を超えています。 |
ActivityStartingState の URL サイズは 512 文字未満、追加のデータサイズは 4,096 文字未満にしてください。 |
SizeLimitExceededAddonStartingState |
AddonStartingState 個の URL またはそのデータのサイズが上限を超えています。 |
AddonStartingState URL のサイズが 512 文字未満で、追加データのサイズが 4,096 文字未満であることを確認します。 |
SizeLimitExceededFrameToFrameMessage |
フレーム間メッセージのサイズが上限を超えています。 | フレーム間メッセージのサイズが 1,000,000 文字未満であることを確認してください。 |
UserCancelled |
ユーザーがアクティビティの開始をキャンセルしました。 | ユーザーが [続行] をクリックしてアクティビティを開始する必要があります。 |
UserNotInitiator |
ユーザーが現在のアクティビティの開始者ではない。 | ユーザーが現在のアクティビティを開始したユーザーであるか、アクティビティが終了していることを確認します。 |