このガイドでは、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 です。値が想定される場所で 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 |
ユーザーが現在のアクティビティの開始者ではない。 | ユーザーが現在のアクティビティの開始者であるか、アクティビティが終了していることを確認します。 |