Gamepad API

Gamepad API es la manera de los desarrolladores de acceder y responder a las señales de los gamepads y otros controles para juegos de una manera simple y consistente. Éste contiene tres interfaces, dos eventos y una función especializada, para responder a los gamepads siendo conectados y desconectados, y acceder a otra información sobre los mismos gamepads, y que botones y otros controles están siendo presionados.

Interfaces

Gamepad: Representa un gamepad/control conectado a la computadora.
GamepadButton: Representa un botón en uno de los gamepads conectados.
GamepadEvent: El evento objeto representa eventos que son enviados a los gamepads.

Extensiones experimentales de los gamepads

GamepadHapticActuator: Representa el hardware en el control designado para proveer retroalimentación háptica al usuario (si está disponible), más comunmente hardware de vibración.
GamepadPose: Representa la posición de un control (ej. posición y orientación el espacio 3D) en el caso de un controllador WebVR. Éste no es usado por el nuevo estándar WebXR.

Ver también las extensiones para la interfaz del navegador, para caracteristicas que le permitan acceder a la información mencionada.

Extensiones y otras interfaces

Navigator

Navigator.getGamepads(): Una extensión a el objeto Navigator que devuelve un arreglo de objetos Gamepad, uno para cada gamepad conectado.

Eventos del Window

Window.ongamepadconnected: Representa un manejador de evento que se ejecutará cuando un gamepad es conectado (cuando se dispara el evento gamepadconnected).
Window.ongamepaddisconnected: Representa un manejador de evento que se ejecutará cuando un gamepad es desconectado (cuando se dispara el evento gamepaddisconnected).

Guías y tutoriales

Especificaciones

Especificación	Estatus	Comentario
Gamepad Extensions	Editor's Draft	Defines the Experimental Gamepad extensions.
Gamepad La definición de 'The Gamepad API specification' en esta especificación.	Working Draft	Initial definition

Compatibilidad del navegador

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome para Android	Firefox para Android	Opera para Android	Safari en iOS	Samsung Internet
`Gamepad`	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`axes`	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`buttons`	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`connected`	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`displayId` ExperimentalDeprecado	Chrome Sin soporte ? — 80 Notas Deshabilitado Sin soporte ? — 80 Notas Deshabilitado Notas Only works on desktop in an experimental version of Chrome (other builds won't return any devices when `Navigator.getVRDisplays()` is invoked). Deshabilitado Until version 80 (exclusive): this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	Edge Soporte completo 15	Firefox Soporte completo 55 Notas Soporte completo 55 Notas Notas Windows support was enabled in Firefox 55. Soporte completo 64 Notas Notas macOS support was enabled in Firefox 64.	IE Sin soporte No	Opera ?	Safari Sin soporte No	WebView Android Sin soporte No	Chrome Android Sin soporte ? — 80 Notas Sin soporte ? — 80 Notas Notas Currently supported only by Google Daydream.	Firefox Android Soporte completo 55	Opera Android ?	Safari iOS Sin soporte No	Samsung Internet Android Sin soporte ? — 13.0 Notas Sin soporte ? — 13.0 Notas Notas Currently supported only by Google Daydream.
`hand` Experimental	Chrome Sin soporte No	Edge Sin soporte 15 — 79	Firefox Soporte completo Si Notas Deshabilitado Soporte completo Si Notas Deshabilitado Notas The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Deshabilitado This feature is behind the `dom.gamepad-extensions.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Sin soporte No	Opera Sin soporte No	Safari Sin soporte No	WebView Android Sin soporte No	Chrome Android Sin soporte No	Firefox Android Sin soporte No	Opera Android Sin soporte No	Safari iOS Sin soporte No	Samsung Internet Android Sin soporte No
`hapticActuators` Experimental	Chrome Sin soporte No	Edge Sin soporte 15 — 79	Firefox Soporte completo Si Notas Deshabilitado Soporte completo Si Notas Deshabilitado Notas The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Deshabilitado This feature is behind the `dom.gamepad-extensions.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Sin soporte No	Opera Sin soporte No	Safari Sin soporte No	WebView Android Sin soporte No	Chrome Android Sin soporte No	Firefox Android Sin soporte No	Opera Android Sin soporte No	Safari iOS Sin soporte No	Samsung Internet Android Sin soporte No
`id` Experimental	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Sin soporte No	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Sin soporte No	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`index` Experimental	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`mapping`	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`pose` Experimental	Chrome Sin soporte No	Edge Sin soporte 15 — 79	Firefox Soporte completo Si Notas Deshabilitado Soporte completo Si Notas Deshabilitado Notas The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Deshabilitado This feature is behind the `dom.gamepad-extensions.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Sin soporte No	Opera Sin soporte No	Safari Sin soporte No	WebView Android Sin soporte No	Chrome Android Sin soporte No	Firefox Android Sin soporte No	Opera Android Sin soporte No	Safari iOS Sin soporte No	Samsung Internet Android Sin soporte No
`timestamp`	Chrome Soporte completo 35 Soporte completo 35 Sin soporte 21 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Edge Soporte completo 12	Firefox Soporte completo 29 Soporte completo 29 Sin soporte 24 — 28 Deshabilitado Deshabilitado 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.	IE Sin soporte No	Opera Soporte completo 22 Soporte completo 22 Sin soporte 15 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari Soporte completo 10.1	WebView Android Sin soporte No	Chrome Android Soporte completo 35 Soporte completo 35 Sin soporte 25 — 34 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Firefox Android Soporte completo 32	Opera Android Soporte completo 22 Soporte completo 22 Sin soporte 14 — 21 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit	Safari iOS Soporte completo 10.3	Samsung Internet Android Soporte completo 4.0 Soporte completo 4.0 Sin soporte 2.0 — 3.0 Prefijado Prefijado Requiere de un prefijo de vendedor : webkit
`vibrationActuator` ExperimentalNo estándar	Chrome Soporte completo 68	Edge Soporte completo 79	Firefox Sin soporte No	IE Sin soporte No	Opera Soporte completo 55	Safari Sin soporte No	WebView Android Sin soporte No	Chrome Android Soporte completo 68	Firefox Android Sin soporte No	Opera Android Soporte completo 48	Safari iOS Sin soporte No	Samsung Internet Android Soporte completo 10.0

Leyenda

Soporte completo: Soporte completo
Sin soporte: Sin soporte
Compatibilidad desconocida: Compatibilidad desconocida
Experimental. Esperar que el comportamiento cambie en el futuro.: Experimental. Esperar que el comportamiento cambie en el futuro.
No estandar . Esperar poco soporte entre navegadores.: No estandar . Esperar poco soporte entre navegadores.
Deprecado. No debe ser usado en nuevos sitios web.: Deprecado. No debe ser usado en nuevos sitios web.
Ver notas de implementación.: Ver notas de implementación.
El usuario debe de habilitar explícitamente esta característica.: El usuario debe de habilitar explícitamente esta característica.
Requiere de un prefijo de proveedor o un de nombre diferente para su uso.: Requiere de un prefijo de proveedor o un de nombre diferente para su uso.

Ver también

La gamepad API por Ted Mielczarek y Robert Nyman
Página de demostración simple de la API (código fuente)