我们的志愿者还没有将这篇文章翻译为 中文 (简体)。加入我们帮助完成翻译!
您也可以阅读此文章的English (US)版。
The GamepadEvent interface of the Gamepad API contains references to gamepads connected to the system, which is what the gamepad events Window.gamepadconnected
and Window.gamepaddisconnected
are fired in response to.
Note: These events are not fired in Chrome, only Firefox. In Chrome you have to use Navigator.getGamepads()
to access Gamepad
objects.
Properties
GamepadEvent.gamepad
Read only- Returns a
Gamepad
object, providing access to the associated gamepad data for the event fired.
Examples
The gamepad property being called on a fired Window.gamepadconnected
event.
window.addEventListener("gamepadconnected", function(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); });
And on a Window.gamepaddisconnected
event.
window.addEventListener("gamepaddisconnected", function(e) { console.log("Gamepad disconnected from index %d: %s", e.gamepad.index, e.gamepad.id); });
Specifications
Specification | Status | Comment |
---|---|---|
Gamepad The definition of 'GamepadEvent' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
gamepad | 35 21 — 34 webkit | (Yes) | 29 24 — 281 | No | 22 15 — 21 webkit | No |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
gamepad | No | (Yes) | (Yes) | 32 | No | No | No |
1. From version 24 until version 28 (exclusive): this feature is behind the dom.gamepad.enabled
preference (needs to be set to true
). To change preferences in Firefox, visit about:config.