開発者コンソール

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

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

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: 2023年8月30日