Gamepad
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
* Some parts of this feature may have varying levels of support.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Gamepad はゲームパッド API のインターフェイスで、それぞれのゲームパッドやその他のコントローラーを定義し、ボタン押下や軸位置や ID といった情報にアクセスできるようにします。
Gamepad オブジェクトを取得する方法は 2 つあります。 gamepadconnected または gamepaddisconnected イベントの gamepad プロパティか、 Navigator.getGamepads() から返される配列の任意の位置から取得します。
プロパティ
Gamepad.axes読取専用-
機器上に軸があるコントロールを表す配列です（例: アナログスティック）。
-
機器上のボタンを表す
gamepadButtonのオブジェクトの配列。 Gamepad.connected読取専用-
ゲームパッドがシステムに繋がっているかを表す論理値。
Gamepad.displayId読取専用 非推奨; 非標準-
関連する
VRDisplayのVRDisplay.displayIdを返します）該当する場合）。ゲームパッドが表示されているシーンを制御しているVRDisplayを返します。 Gamepad.hand読取専用 Experimental-
コントローラーがどの手で握られているか、または握られる可能性が高いかを定義する列挙型です。
Gamepad.hapticActuators読取専用 Experimental-
GamepadHapticActuatorオブジェクトを格納した配列で、各オブジェクトはコントローラーで利用できる触覚フィードバックのハードウェアを表します。 Gamepad.vibrationActuator読取専用 非標準-
GamepadHapticActuatorオブジェクトで、コントローラーで利用できる触覚フィードバックのハードウェアを表します。 Gamepad.id読取専用-
文字列で、コントローラーに関する識別情報を示します。
Gamepad.index読取専用-
システムに現在接続しているそれぞれの機器を表す固有の整数値。
Gamepad.mapping読取専用-
ブラウザーが機器上のコントロールを既知のレイアウトに再マップしたかどうかを示す文字列。
Gamepad.pose読取専用 Experimental-
WebVR コントローラーに関連するポーズ情報（3D 空間における位置や向きなど）を表す
GamepadPoseオブジェクトです。 Gamepad.timestamp読取専用-
このゲームパッドのデータが最後に更新された時刻を表す
DOMHighResTimeStampです。
例
window.addEventListener("gamepadconnected", (e) => {
console.log(
"Gamepad connected at index %d: %s. %d buttons, %d axes.",
e.gamepad.index,
e.gamepad.id,
e.gamepad.buttons.length,
e.gamepad.axes.length,
);
});
仕様書
| Specification |
|---|
| Gamepad # gamepad-interface |
| Gamepad Extensions # partial-gamepad-interface |