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 GamepadExtensions 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

js
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

Specification
Gamepad
# gamepad-interface
Gamepad Extensions
# partial-gamepad-interface

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi