Gamepad

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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énements gamepadconnected et gamepadisdisconnected.
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 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 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

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

Compatibilité des navigateurs

BCD tables only load in the browser