Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
このページを使用して、メディアアプリのVegaメディアコントロールに関する次のような問題を診断してください。
  • リモコンの早送りボタンと早戻しボタンが反応しない。
  • Alexaの音声コマンドが無視されるか、想定と異なるハンドラーが呼び出される。
  • シークバーが再生位置と一致しない。
  • メディアコントロールが一部の時間しか機能しない。

クイックトリアージ: プラットフォームまたはアプリの問題

アプリコードを調べる前に、次の質問に答えてください。 2つ以上の質問の回答が「はい」の場合は、プラットフォームに問題がある可能性があります。Amazonの担当者に問い合わせるか、トリアージのガイドラインに従って報告してください。それ以外の場合は、このページの一般的な問題に進んでください。

早送りボタンと早戻しボタンが反応しない

症状
  • リモコンの早送りボタンと早戻しボタンが反応しない。
  • 左右のD-padは引き続きシークする。
  • 再生と一時停止は正常に機能する。
原因 アプリがVegaメディアコントロールに登録されていません。これは通常、W3C Media統合が設定されていないためです。 解決策
  1. manifest.tomlファイル内の主要なインタラクティブコンポーネントにメディアカテゴリがあり、インターフェイスプロバイダーとして識別されていることを確認します。マニフェスト全文については、Vegaメディアコントロールを始めるを参照してください。
  2. マニフェストに、アプリがサポートするコマンドと機能が記載されていることを確認してください。アプリは、command_optionsに表示されない限りSkipForwardおよびSkipBackwardを受信しません。また、VariableSpeedがfeaturesに表示されない限り、FastForwardおよびRewindを受信しません。
  3. W3C MediaとVegaメディアコントロールの統合で説明されているように、再生を開始する前にプレーヤーでsetMediaControlFocusを呼び出します。
  4. 登録チェックを実行して、アプリが登録されていることを確認します。

メディアコントロールが一部の時間しか機能しない

症状
  • 早送りと早戻しは時々機能するが、常に機能するとは限らない。
  • アプリを再起動すると、コントロールが機能し始める。
原因 再生がすでに開始された後や、コンポーネントインスタンスが使用可能になる前など、アプリのsetMediaControlFocus呼び出しが遅すぎます。 解決策 コンポーネントインスタンスが使用可能になったら、再生が開始される前にsetMediaControlFocusを呼び出します。
再生を開始する関数内にフォーカスを設定しないでください。

シークバーが再生位置と一致しない

症状
  • 早送りと早戻しは機能するが、シークバーが動かない。
  • 表示位置が実際の再生位置からずれる。
原因 アプリはメディアコントロールコマンド自体を処理しますが、再生位置が変更された後に新しい状態をVegaメディアコントロールに公開していません。 解決策 再生位置またはステータスが変わるたびに、セッション状態を更新してupdateMediaSessionStatesを呼び出します。次の例は、Vegaメディアコントロールの概要のMediaPlayerStateパターンを拡張したものです。
独自のUIからのシークなど、ハンドラーの外側でアプリの位置が変わる場所にはすべて同じパターンを適用します。

Alexa音声コマンドが想定とは異なるハンドラーを呼び出す

症状
  • 「アレクサ、止めて」と言うと、handleStopを呼び出すのではなく再生が一時停止する。
  • 「アレクサ、早送りして」と言うと、handleFastForwardを呼び出すのではなくシークする。
原因 Alexaが、一部のトランスポートコントロールの発話を、その発話名が示すものとは別のVegaメディアコントロールコマンドに変換する。 解決策 次の表のハンドラーを実装します。これらはAlexaが実際に呼び出すものです。

診断ツール

これらのチェックでは、VegaメディアコントロールクライアントAPIを使用して、システムがどのように動作するかをアプリを確認します。アプリのテストビルドから実行してください。クライアントAPIの詳細については、メディアコントロールクライアントアプリの場合を参照してください。

アプリが登録されていることを確認する

エンドポイントロケーターは、メディアアプリのランク付けされたリストを返します。通常、最初のエントリは、現在フォーカスされているアプリです。
アプリのパッケージIDがリストにない場合は、マニフェストとsetMediaControlFocus呼び出しを確認してください。

テストコマンドルーティング

フォーカスされたアプリにコマンドを送信し、ハンドラーがコマンドを受信することを確認します。

最小限の作業実装

次の例は、リモートおよびAlexaメディアコマンドを受け取る最小のW3C Media統合です。
package.jsonファイルには次の依存関係が含まれている必要があります。

関連トピック

最終更新日 2026年10月13日