Prueba de Mando

Una prueba de mando lee las señales que tu controlador envía al navegador a través de la Gamepad API del W3C y las muestra en tiempo real: cada pulsación de botón, la posición de los sticks analógicos, el recorrido de los gatillos, la dirección de la cruceta y los motores de vibración. Es la forma más rápida de comprobar si un mando funciona antes de una partida, diagnosticar un botón de cara pegajoso, detectar el drift del stick en un mando con horas de uso o verificar que ambos motores de vibración responden. La página resalta cada entrada sobre un esquema en pantalla estilo Xbox, muestra los valores brutos de los ejes y de los gatillos, y mantiene un breve registro de eventos. Como la Gamepad API solo expone un controlador después de pulsar un botón en él, la página te pedirá primero que pulses cualquiera: es una regla de seguridad del navegador, no un fallo de tu mando. Todo se ejecuta localmente en tu navegador; ningún dato de entrada sale de tu dispositivo.

El navegador expone los mandos a través de la Gamepad API del W3C. Un controlador se representa mediante un objeto Gamepad obtenido de navigator.getGamepads(), que devuelve hasta cuatro ranuras. Cada gamepad lleva una cadena id (fabricante y producto), un campo mapping ('standard' para dispositivos con disposición Xbox, vacío en caso contrario), un array buttons y un array axes. Bajo la asignación estándar, buttons tiene 17 entradas: cuatro botones de cara (A/B/X/Y), dos bumper (LB/RB), dos gatillos analógicos (LT/RT), Select/Start, dos pulsaciones de stick (L3/R3), cuatro direcciones de la cruceta y el botón Home/Guide. Cada botón expone .pressed (booleano) y .value (de 0 a 1; los gatillos son analógicos, los digitales valen 0 o 1). El array axes guarda cuatro valores en el rango -1 a 1: X/Y del stick izquierdo y luego X/Y del stick derecho. La API funciona por sondeo, no por eventos, así que la página ejecuta un bucle requestAnimationFrame y lee una nueva instantánea en cada frame. Para evitar re-renderizados inútiles con el mando en reposo, solo actualiza el estado cuando cambia gamepad.timestamp: esa marca de tiempo avanza con cada nuevo reporte de entrada. La conexión y la desconexión llegan como eventos gamepadconnected y gamepaddisconnected en el objeto window. Por seguridad, un objeto gamepad permanece null hasta que el usuario pulsa un botón en él, así que la página no puede leer un mando recién conectado de forma silenciosa. La vibración es opcional: si existe gamepad.vibrationActuator, llamar a playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) acciona los dos motores; Safari y algunas compilaciones de Chromium no la implementan, por eso la página hace detección de características y desactiva los botones en caso contrario.

• navigator.getGamepads() devuelve hasta cuatro ranuras; una ranura solo es distinta de null después de pulsar un botón del mando.
• Asignación estándar: buttons[0-3] botones de cara, [4-5] bumper, [6-7] gatillos analógicos, [8-9] Select/Start, [10-11] L3/R3, [12-15] cruceta, [16] Home.
• axes[0-1] es el stick izquierdo (X, Y); axes[2-3] el stick derecho, cada uno en el rango -1 a 1.
• Modelo de sondeo: un bucle requestAnimationFrame lee instantáneas; gamepad.timestamp controla las actualizaciones para que los frames en reposo no hagan nada.
• Vibración mediante gamepad.vibrationActuator.playEffect('dual-rumble', ...): requiere detección de características y no es compatible con todos los navegadores.
• Los eventos gamepadconnected / gamepaddisconnected señalan la conexión y la desconexión; el campo .index del mando identifica su ranura.