Gamepad-Test

Ein Gamepad-Test liest die Signale, die dein Controller über die W3C Gamepad API an den Browser sendet, und zeigt sie in Echtzeit an: jeden Tastendruck, jede Analogstick-Position, jede Trigger-Tiefe, jede Steuerkreuz-Richtung und die Vibrationsmotoren. Er ist der schnellste Weg, um vor einer Partie zu prüfen, ob ein Controller funktioniert, eine klemmende Gesichtstaste zu diagnostizieren, Stick-Drift bei einem älteren Pad zu erkennen oder nachzuprüfen, ob beide Vibrationsmotoren auslösen. Die Seite hebt jeden Eingang in einem Xbox-artigen Layout hervor, zeigt die rohen Achs- und Trigger-Werte an und führt ein kurzes Ereignisprotokoll. Da die Gamepad API einen Controller erst freigibt, nachdem du eine Taste auf ihm gedrückt hast, bittet die Seite dich zuerst, eine beliebige Taste zu drücken – das ist eine Browsersicherheitsregel, kein Defekt deines Pads. Alles läuft lokal in deinem Browser; keine Eingabedaten verlassen dein Gerät.

Der Browser stellt Gamepads über die W3C Gamepad API bereit. Ein Controller wird durch ein Gamepad-Objekt repräsentiert, das von navigator.getGamepads() geliefert wird und bis zu vier Slots zurückgibt. Jedes Gamepad trägt eine id-Zeichenkette (Vendor und Product), ein mapping-Feld ('standard' für Geräte mit Xbox-Layout, sonst leer), ein buttons-Array und ein axes-Array. Unter dem Standard-Mapping hat buttons 17 Einträge: vier Gesichtstasten (A/B/X/Y), zwei Bumper (LB/RB), zwei analoge Trigger (LT/RT), Select/Start, zwei Stick-Klicks (L3/R3), vier Steuerkreuz-Richtungen und die Home/Guide-Taste. Jede Taste verfügt über .pressed (boolesch) und .value (0 bis 1 – Trigger sind analog, digitale Tasten 0 oder 1). Das axes-Array enthält vier Werte im Bereich -1 bis 1: linker Stick X/Y, dann rechter Stick X/Y. Die API ist poll-basiert, nicht ereignisbasiert, daher betreibt die Seite eine requestAnimationFrame-Schleife und liest jeden Frame einen frischen Snapshot. Um nutzlose Re-Renders im Leerlauf zu vermeiden, wird der Zustand nur aktualisiert, wenn sich gamepad.timestamp ändert – dieser Zeitstempel rückt mit jedem neuen Eingabe-Report vor. Verbinden und Trennen kommen als gamepadconnected- und gamepaddisconnected-Events am window an. Aus Sicherheitsgründen bleibt ein Gamepad-Objekt null, bis der Benutzer eine Taste darauf drückt, weshalb die Seite ein frisch eingestecktes Pad nicht lautlos auslesen kann. Vibration ist optional: Existiert gamepad.vibrationActuator, steuert ein Aufruf von playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) die beiden Motoren an; Safari und einige Chromium-Builds implementieren das nicht, weshalb die Seite ein Feature-Detection durchführt und die Schaltflächen andernfalls deaktiviert.

• navigator.getGamepads() liefert bis zu vier Slots; ein Pad ist erst nach einem Tastendruck auf ihm nicht null.
• Standard-Mapping: buttons[0-3] Gesichtstasten, [4-5] Bumper, [6-7] analoge Trigger, [8-9] Select/Start, [10-11] L3/R3, [12-15] Steuerkreuz, [16] Home.
• axes[0-1] ist der linke Stick (X, Y), axes[2-3] der rechte Stick, jeweils im Bereich -1 bis 1.
• Polling-Modell: Eine requestAnimationFrame-Schleife liest Snapshots; gamepad.timestamp steuert die Aktualisierung, sodass Leerlauf-Frames nichts tun.
• Vibration über gamepad.vibrationActuator.playEffect('dual-rumble', ...) – per Feature-Detection, nicht in jedem Browser unterstützt.
• gamepadconnected / gamepaddisconnected signalisieren Verbinden und Trennen; der .index des Pads identifiziert seinen Slot.