Gamepad

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 :

Propriétés

Gamepad.axes (en-US) Lecture seule
Un tableau représentant les contrôles avec les axes présents sur le dispositif (par exemple : les joysticks analogiques).
Gamepad.buttons (en-US) Lecture seule
Un tableau d'objets gamepadButton (en-US) représentant les boutons présents sur le dispositif.
Gamepad.connected (en-US) Lecture seule
Un booléen indiquant si la manette est toujours connectée au système.
Gamepad.displayId (en-US) Lecture seule
Retourne VRDisplay.displayId (en-US) associé à VRDisplay (en-US) — Le VRDisplay dont la manette contrôle la scène affichée.
Gamepad.id (en-US) Lecture seule
Un DOMString contenant l'information d'identification de la manette.
Gamepad.index (en-US) Lecture seule
Un entier qui s'auto-incrémente pour être unique à chaque dispositif actuellement connecté au système.
Gamepad.mapping (en-US) Lecture seule
Une chaîne de caractères indiquant si le navigateur a remappé les contrôles du dispositif à un layout connu.
Gamepad.timestamp (en-US) 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 (en-US) 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 (en-US) Lecture seule
Un tableau contenant des objets GamepadHapticActuator (en-US) dont chacun représente un matériel disponible pour le contrôleur pour les retours haptiques.
Gamepad.pose (en-US) Lecture seule
Un objet GamepadPose (en-US) 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.displayId (en-US).

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

Voir aussi