Gamepad API

L'API Gamepad est un moyen pour les développeurs d'accéder aux signaux provenant des manettes des jeu et des autres unités de commande du jeu d'y répondre de manière simple et systématiq. Il contient trois interfaces, deux événements et une fonction spécialisée, pour répondre aux manettes connectées et déconnectées, et pour accéder à d'autres informations sur les manettes elles-mêmes, ainsi que sur les boutons et autres commandes sur lesquels vous appuyez actuellement.

Interfaces

Gamepad
Représente une manette de jeu / unités de commande du jeu connecté à l'ordinateur.
GamepadButton
Représente un bouton sur un gamepad connecté.
GamepadEvent
L'objet d'événement qui déclenche des événements sur la manette de jeu contiguë de manière représentative.

Extensions de manette du jeu expérimentales

GamepadHapticActuator
Represents hardware in the controller designed to provide haptic feedback to the user (if available), most commonly vibration hardware.
GamepadPose
Represents the pose of a controller (e.g. position and orientation in 3D space) in the case of a WebVRcontroller.

See also the extensions to the Gamepad interface, for features that allow you to access the above information.

Extensions à d'autres interfaces

Navigator.getGamepads()
An extension to the Navigator object that returns an array of Gamepad objects, one for each connected gamepad.

Window events

Window.ongamepadconnected
Represents an event handler that will run when a gamepad is connected (when the gamepadconnected event fires).
Window.ongamepaddisconnected
Represents an event handler that will run when a gamepad is disconnected (when the gamepaddisconnected event fires).

Tutoriels et guides

Caractéristiques

Spécification Statut Commentaire
Gamepad Extensions Brouillon de l'éditeur Defines the Experimental Gamepad extensions.
Gamepad
La définition de 'The Gamepad API specification' dans cette spécification.
Version de travail Initial definition

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
GamepadChrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet OuiFirefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
Gamepad() constructorChrome Support complet 35Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35Firefox Android Support complet 32Opera Android Support complet 22Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
axesChrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
buttonsChrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
connectedChrome Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
displayId
ExpérimentaleObsolète
Chrome Support complet Oui
Notes Désactivée
Support complet Oui
Notes Désactivée
Notes Only works on desktop in an experimental version of Chrome (other builds won't return any devices when Navigator.getVRDisplays() is invoked).
Désactivée This feature is behind the WebVR preference. To change preferences in Chrome, visit chrome://flags.
Edge Support complet 15Firefox Support complet 55
Notes
Support complet 55
Notes
Notes Windows support was enabled in Firefox 55.
Support complet 64
Notes
Notes macOS support was enabled in Firefox 64.
IE Aucun support NonOpera ? Safari Aucun support NonWebView Android Aucun support NonChrome Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Currently supported only by Google Daydream.
Firefox Android Support complet 55Opera Android ? Safari iOS Aucun support NonSamsung Internet Android Support complet Oui
hand
Expérimentale
Chrome Aucun support NonEdge Support complet 15Firefox Support complet Oui
Notes Désactivée
Support complet Oui
Notes Désactivée
Notes The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.
Désactivée 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 Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Non
hapticActuators
Expérimentale
Chrome Aucun support NonEdge Support complet 15Firefox Support complet Oui
Notes Désactivée
Support complet Oui
Notes Désactivée
Notes The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.
Désactivée 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 Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Non
id
Expérimentale
Chrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Aucun support NonWebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Aucun support NonSamsung Internet Android Support complet Oui
index
Expérimentale
Chrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
mappingChrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui
pose
Expérimentale
Chrome Aucun support NonEdge Support complet 15Firefox Support complet Oui
Notes Désactivée
Support complet Oui
Notes Désactivée
Notes The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.
Désactivée 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 Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support NonOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Non
timestampChrome Support complet 35
Support complet 35
Aucun support 21 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Edge Support complet 12Firefox Support complet 29
Support complet 29
Aucun support 24 — 28
Désactivée
Désactivée 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 Aucun support NonOpera Support complet 22
Support complet 22
Aucun support 15 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari Support complet 10.1WebView Android Aucun support NonChrome Android Support complet 35
Support complet 35
Aucun support 25 — 34
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Firefox Android Support complet 32Opera Android Support complet 22
Support complet 22
Aucun support 14 — 21
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : webkit
Safari iOS Support complet 10.3Samsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.

Voir également