L'interface Gamepad
de l'API Gamepad définit une manette individuelle ou un autre contrôleur, autorisant l'accès à des informations telles que les boutons pressés, la position des axes et l'identifiant.
Un objet Gamepad
peut être retourné de deux manières :
- Via la propriété
gamepad
des événementsgamepadconnected
etgamepaddisconnected
. - Ou en prenant n'importe quelle position dans le tableau retourné par la méthode
Navigator.getGamepads()
.
Propriétés
Gamepad.axes
Lecture seule- Un tableau représentant les contrôles avec les axes présents sur le dispositif (par exemple : les joysticks analogiques).
Gamepad.buttons
Lecture seule- Un tableau d'objets
gamepadButton
représentant les boutons présents sur le dispositif. Gamepad.connected
Lecture seule- Un booléen indiquant si la manette est toujours connectée au système.
Gamepad.displayId
Lecture seule- Retourne
VRDisplay.displayId
associé àVRDisplay
— Le VRDisplay dont la manette contrôle la scène affichée. Gamepad.id
Lecture seule- Un
DOMString
contenant l'information d'identification de la manette. Gamepad.index
Lecture seule- Un entier qui s'auto-incrémente pour être unique à chaque dispositif actuellement connecté au système.
Gamepad.mapping
Lecture seule- Une chaîne de caractères indiquant si le navigateur a remappé les contrôles du dispositif à un layout connu.
Gamepad.timestamp
Lecture seule- Un
DOMHighResTimeStamp
représentant la dernière fois que les données pour cette manette a été mise à jour. Noter que cette propriété n'est pas supportée partout.
Extensions expérimentales apportées à Gamepad
Les interfaces suivantes sont définies dans la spécification Gamepad Extensions et fournissent un accès à des fonctionnalités expérimentales tels que les retours haptiques et informations de position des contrôleurs WebVR.
Gamepad.hand
Lecture seule- Une énumération qui définit dans quelle main le contrôleur est tenue (ou dans laquelle il est probablement tenue).
Gamepad.hapticActuators
Lecture seule- Un tableau contenant des objets
GamepadHapticActuator
dont chacun représente un matériel disponible pour le contrôleur pour les retours haptiques. Gamepad.pose
Lecture seule- Un objet
GamepadPose
qui représente la position et l'orientation d'un contrôleur WebVR dans l'espace en trois dimensions.
Exemples
window.addEventListener("gamepadconnected", function(event) {
console.log("Contrôleur connecté à %d: %s. %d boutons, %d axes.",
event.gamepad.index, event.gamepad.id,
event.gamepad.buttons.length, event.gamepad.axes.length);
});
Spécifications
Spécification | Statut | Commentaire |
---|---|---|
Gamepad La définition de 'Gamepad' dans cette spécification. |
Version de travail | Première définition |
Unknown La définition de 'displayId' dans cette spécification. |
Statut inconnu |
Définit la propriété |
Gamepad Extensions La définition de 'Gamepad extensions' dans cette spécification. |
Brouillon de l'éditeur | Définit les extensions expérimentales |
Compatibilités des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter https://github.com/mdn/browser-compat-data et à nous envoyer une pull request.