Gamepad

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨mars 2017⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

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,
  );
});