as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
テスト
公開
収益化
ユーザーエンゲージメント
デバイスの仕様
リソース

ウェブアプリのコントローラー対応

ウェブアプリのコントローラー対応

Amazon Fire TVは、Amazon Fire TVリモコンやAmazon Fire TVゲームコントローラー(日本では現在お取り扱いできません)だけでなく、Bluetooth HIDゲームパッドプロファイルをサポートするほかのゲームコントローラーからのユーザー入力にも対応しています。このようなコントローラーを使うことで、アプリ内を移動したり、アイテムを選択したりできるようになります。

Amazon Fire TVリモコンからの入力の使用

ほとんどのAmazon Fire TVリモコンには次のボタンがあります。一部のFire TVリモコンには [マイク] ボタンまたは [音声認識] ボタンが付属していません。

リモコン
リモコン

一部のリモコンには、音量ボタン、電源ボタン、Netflix、Amazonプライムといったアプリのボタンが追加されています。ただし、これらのボタンはサードパーティ製アプリのイベントにはマッピングできません。

ユーザーがリモコンを使用してウェブアプリを操作できるようにするには、ユーザーがいずれかのキーを押したときのキーイベントをキャプチャする必要があります。キーを押す操作のほとんどは、ブラウザでの標準のキーボードイベントとしてキャプチャできます。

キーコードのマッピングについては、次の表を参照してください。ホームボタン、メニューボタン、音声検索ボタンはキャプチャできません。

Amazon Fire TVリモコンのボタン キーコード 標準的な動作
選択(D-padの [選択] 13 現在フォーカスが置かれているユーザーインターフェイスアイテムを選択します。
上(D-pad) 38 ユーザーインターフェイス内でフォーカスを上方向に移動します。
下(D-pad) 40 ユーザーインターフェイス内でフォーカスを下方向に移動します。
左(D-pad) 37 ユーザーインターフェイス内でフォーカスを左方向に移動します。
右(D-pad) 39 ユーザーインターフェイス内でフォーカスを右方向に移動します。
再生/一時停止 179 メディアの再生を制御します。再生と一時停止は、相互に切り替わります。
早戻し 227 再生中のメディアコンテキストを早戻しします。
早送り 228 再生中のメディアコンテキストを早送りします。
戻る 4 履歴スタックを遡って移動するか、履歴スタックが空の場合はホーム画面に戻ります。

これらのキーイベントは、フォーカスされているアプリにのみ送信されます。

Amazon Fire TVゲームコントローラー(日本では現在お取り扱いできません)からの入力を使用

Amazon Fire TVゲームコントローラー(日本では現在お取り扱いできません)に対応するアプリの開発は簡単です。

  • Amazon WebViewは、W3C標準ゲームパッドAPIをサポートしています。
  • Amazon Fire TVゲームコントローラーのボタンは、標準ゲームパッド形式にマッピングされます。
  • Amazon Fire TVゲームコントローラーにおけるゲームパッドAPIの使用では、[戻る] ボタンは標準コントローラーの [選択] に相当し、[メニュー] ボタンは[スタート] に相当します。ゲームパッドAPIを使用しない場合、これらのボタンは [戻る] ボタンおよび [メニュー] ボタンとして動作します。

標準ゲームパッドAPI対応アプリの開発の詳細については、Jumping the Hurdles with the Gamepad API(英語のみ)を参照してください。

ゲームパッドAPIを使用しないことを選択した場合、Amazon Fire TVゲームコントローラーのボタンは、通常、Amazon Fire TVリモコンの同じ機能にマッピングされます(Bボタン以外)。

Amazon Fire TV(第2世代)ゲームコントローラーには次のボタンがあります。

Amazon Fire TV(第1世代)ゲームコントローラーには次のボタンがあります。

キーのマッピングを次の表に示します。

Amazonゲームパッドコントローラーボタン キーコード 標準的な動作
上(D-pad/ジョイスティック) 38 ユーザーインターフェイス内でフォーカスが上方向に移動します。
下(D-pad/ジョイスティック) 40 ユーザーインターフェイス内でフォーカスが下方向に移動します。
左(D-pad/ジョイスティック) 37 ユーザーインターフェイス内でフォーカスが左方向に移動します。
右(D-pad/ジョイスティック) 39 ユーザーインターフェイス内でフォーカスが右方向に移動します。
A 13 現在フォーカスが置かれているユーザーインターフェイスアイテムが選択されます。
B 8 なし
X 13 現在フォーカスが置かれているユーザーインターフェイスアイテムが選択されます。
Y 13 現在フォーカスが置かれているユーザーインターフェイスアイテムが選択されます。
戻る 4 履歴スタックを遡って移動するか、履歴スタックが空の場合はホーム画面に戻ります。

[再生/一時停止] メディアボタン

Amazon Fire TV用として申請されるメディアアプリでは、メディアの [再生/一時停止] キーイベントを処理してメディアの再生を制御できることが必要です。ゲームアプリでは、メディアの [再生/一時停止] キーイベントを処理してゲームを再生または一時停止できることも必要です。[再生/一時停止] ボタンのキーコードは179です。

[戻る] ボタン

ユーザーがFire TVのウェブアプリで [戻る] ボタンを押すと、ウェブアプリはKeyEventクラスから標準のAndroidキーイベントを受信します。Fire TVリモコンのキーイベントをキャプチャする方法の詳細については、リモコン入力を参照してください。Amazon Fire TVゲームコントローラー(日本では現在お取り扱いできません)のキーイベントをキャプチャする方法の詳細については、ゲームコントローラー入力を参照してください。


Last updated: 2026年1月30日