Test de Manette

Un test de manette lit les signaux que votre contrôleur envoie au navigateur via la Gamepad API du W3C et les affiche en temps réel : chaque appui de bouton, la position des sticks analogiques, la course des gâchettes, les directions de la croix directionnelle et les moteurs de vibration. C'est le moyen le plus rapide de vérifier qu'une manette fonctionne avant une partie, de diagnostiquer un bouton qui colle, de repérer le drift d'un stick usé ou de contrôler que les deux moteurs de vibration répondent. La page met en évidence chaque entrée sur un affichage de type Xbox, affiche les valeurs brutes des axes et des gâchettes, et conserve un bref journal des événements. Comme la Gamepad API n'expose un contrôleur qu'après un appui sur l'un de ses boutons, la page vous demandera d'abord d'appuyer sur une touche : c'est une règle de sécurité du navigateur, pas un défaut de votre manette. Tout s'exécute localement dans votre navigateur ; aucune donnée d'entrée ne quitte votre appareil.

Le navigateur expose les manettes via la Gamepad API du W3C. Un contrôleur est représenté par un objet Gamepad obtenu depuis navigator.getGamepads(), qui renvoie jusqu'à quatre emplacements. Chaque gamepad comporte une chaîne id (fabricant et produit), un champ mapping ('standard' pour les périphériques de type Xbox, vide sinon), un tableau buttons et un tableau axes. Avec le mappage standard, buttons compte 17 entrées : quatre boutons de face (A/B/X/Y), deux bumpers (LB/RB), deux gâchettes analogiques (LT/RT), Select/Start, deux clics de stick (L3/R3), quatre directions de la croix directionnelle et le bouton Home/Guide. Chaque bouton expose .pressed (booléen) et .value (0 à 1 - les gâchettes sont analogiques, les boutons numériques valent 0 ou 1). Le tableau axes contient quatre valeurs comprises entre -1 et 1 : X/Y du stick gauche, puis X/Y du stick droit. L'API fonctionne par scrutation et non par événements : la page exécute donc une boucle requestAnimationFrame et relit une capture fraîche à chaque image. Pour éviter les re-rendus inutiles quand la manette est inactive, l'état n'est mis à jour que lorsque gamepad.timestamp change - cet horodatage avance à chaque nouveau rapport d'entrée. Les connexions et déconnexions arrivent sous forme d'événements window gamepadconnected et gamepaddisconnected. Pour des raisons de sécurité, un objet gamepad reste null tant que l'utilisateur n'a pas appuyé sur un bouton de la manette, donc la page ne peut pas lire silencieusement une manette qui vient d'être branchée. Les vibrations sont optionnelles : si gamepad.vibrationActuator existe, l'appel à playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) pilote les deux moteurs ; Safari et certaines versions de Chromium ne l'implémentent pas, c'est pourquoi la page fait une détection de fonctionnalité et désactive les boutons sinon.

• navigator.getGamepads() renvoie jusqu'à quatre emplacements ; un emplacement n'est non null qu'après un appui sur un bouton de la manette.
• Mappage standard : buttons[0-3] face, [4-5] bumpers, [6-7] gâchettes analogiques, [8-9] Select/Start, [10-11] L3/R3, [12-15] croix directionnelle, [16] Home.
• axes[0-1] est le stick gauche (X, Y), axes[2-3] le stick droit, chacun compris entre -1 et 1.
• Modèle par scrutation : une boucle requestAnimationFrame lit les captures ; gamepad.timestamp sert de porte pour que les images inactives ne fassent rien.
• Vibrations via gamepad.vibrationActuator.playEffect('dual-rumble', ...) - détectées par fonctionnalité, non prises en charge par tous les navigateurs.
• Les événements gamepadconnected / gamepaddisconnected signalent la connexion et la déconnexion ; le .index de la manette identifie son emplacement.