このガイドでは、Meet 用アドオンのビルドとテスト中に発生する可能性のある特定の Google Meet アドオン SDK エラーを解決する方法について説明します。
エラーの詳細を取得するには、MeetAddonError オブジェクトを使用します。エラーのタイプを指定する errorType プロパティが含まれます。
エラータイプ
Meet アドオン SDK がエラーをスローしたときに生成されるエラータイプと、その解釈方法、エラーが発生した場合の対処方法について説明します。
| エラー | エラー メッセージ | アクション |
|---|---|---|
ActivityIsOngoing |
アクティビティの進行中はオペレーションを実行できません。 | アクティビティが進行中ではないことを確認します。 |
ActivityStartingStateEmpty |
アクティビティの開始状態は空です。 | ActivityStartingState オブジェクトが指定されましたが、属性が含まれていません。 |
ActivityStartingStateMissingAttributes |
アクティビティの開始状態に認識された属性が含まれていません。 | ActivityStartingState オブジェクトに、mainStageUrl、sidePanelUrl、additionalData のいずれかの属性が 1 つ以上含まれていることを確認します。 |
ActivityStartingStateUnrecognizedAttributes |
アクティビティの開始状態に認識されない属性が含まれています。 | ActivityStartingState オブジェクトに mainStageUrl、sidePanelUrl、additionalData の属性のみが含まれていることを確認します。 |
AddonSessionAlreadyCreated |
アドオン セッションはすでに作成されています。 | AddonSession は 1 回だけインスタンス化します。 |
AddonStartingStateMissingAttributes |
アドオンの開始状態に認識された属性が含まれていません。 | AddonStartingState オブジェクトに sidePanelUrl、additionalData のいずれかの属性が 1 つ以上含まれていることを確認します。 |
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 パラメータが変更されないようにしてください（リダイレクトの一部など）。 |
MeetingPolicyPreventsStartingActivity |
会議ポリシー（ホスト制御設定の使用など）により、ユーザーがアクティビティを開始できない。 | 会議の主催者または管理者に必要な設定を変更してもらい、現在のユーザーがアクティビティを開始できるようにします。 |
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 |
ユーザーが現在のアクティビティの開始者ではない。 | ユーザーが現在のアクティビティの開始者であるか、アクティビティが終了していることを確認します。 |