Navigator: getGamepads() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年3月以降、すべてのブラウザーで利用可能です。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Navigator.getGamepads() メソッドは Gamepad の配列を返します。それぞれがこの端末に接続されているゲームパッドを表します。
セッション中にゲームパッドが切断された場合、配列の要素は null になる可能性がありますので、残りのゲームパッドは同じインデックスを保持します。
構文
js
getGamepads()
引数
なし。
返値
例外
SecurityErrorDOMException-
権限ポリシーによって、この機能の使用がブロックされた場合。
例
js
window.addEventListener("gamepadconnected", (e) => {
const gp = navigator.getGamepads()[e.gamepad.index];
console.log(
`Gamepad connected at index ${gp.index}: ${gp.id} with ${gp.buttons.length} buttons, ${gp.axes.length} axes.`,
);
});
仕様書
| 仕様書 |
|---|
| Gamepad # dom-navigator-getgamepads |