La API de Gamepad Web proporciona un acceso de página a los objetos controladores que un navegador elige exponer. Es muy útil, pero la disponibilidad no garantiza nombres de dispositivo idénticos, orden de botones, orden de eje o soporte de características a través de plataformas.
Activación y exposición del usuario
Los navegadores pueden esperar a pulsar un botón de gamepad antes de exponer un dispositivo conectado. Esto reduce las huellas dactilares pasivas y significa que un controlador puede estar conectado físicamente mientras navigator.getGamepads() Inicialmente devuelve entradas vacías. Keymap Labs impulsa al usuario a pulsar un botón y escucha los eventos de conexión mientras continúa inspeccionando la lista actual.
Varias funciones del dispositivo del navegador requieren una conexión segura. Uso https://keymap.io, mantener el navegador actual y evitar copias o versiones incrustadas de la página al comparar los resultados.
Cartografías estándar y genéricas
Un objeto gamepad puede declarar la cartografía estándar, que da posiciones comunes para botones faciales, hombros, disparadores, palos y botones direccionales. Los dispositivos genéricos pueden proporcionar una asignación vacía y exponer los arrays crudos en un orden específico del dispositivo.
Keymap Labs siempre muestra índices de botones crudos y valores de eje. Esto mantiene la herramienta útil incluso cuando un controlador no coincide con el diagrama familiar. No renombra una entrada genérica con certeza injustificada.
Los disparadores analógicos pueden aparecer como botones con valores fraccionados, ejes separados o botones digitales dependiendo de la pila. Otras características como touchpads, gyro, estado de la batería, LEDs y hapticos no están siempre disponibles a través de la cartografía central y están fuera del alcance de diagnóstico estándar.
Comportamiento de conexión e índice
Los Gamepads reciben un índice dentro de la sesión del navegador. Desconectar y reconectar puede cambiar qué entrada es activa. El laboratorio en vivo selecciona un dispositivo disponible y responde a los cambios de conexión; utilice el selector del dispositivo cuando varios controladores están expuestos.
El modo inalámbrico puede exponer un identificador diferente o un conjunto de funciones desde el modo USB. Esa diferencia debe ser registrada durante la solución de problemas. Un identificador visual del navegador también puede ser genérico por razones de privacidad o controlador.
Matriz de validación
Una comparación de compatibilidad seria necesita dispositivos físicos a través de sistemas operativos y motores del navegador. Keymap Labs utiliza la API estándar y maneja botones o ejes perdidos defensivamente, pero una prueba en línea no puede emular a cada controlador.
Un registro de comparación útil incluye:
- Sistema operativo y versión
- Motor de navegador y versión
- Modelo de control y firmware
- Cableado, Bluetooth o receptor propietario
- ID, mapeo, ejes y conteos de botones
- Representación del desencadenante y orden del palo
- Conectar, reconectar y enfocar el comportamiento
Los resultados deben tratarse como observaciones fechadas, no como una insignia de “trabajos por todas partes”. Las actualizaciones del navegador y del sistema operativo pueden cambiar las asignaciones con el tiempo.
Interpretar un resultado vacío
Ningún controlador en la página puede significar ningún dispositivo, ninguna activación del usuario, una limitación del navegador, una aplicación competidora, una capa de controlador o un problema de conexión. El guía de detección de gamepad camina por esas capas en un orden controlado.
Si el dispositivo aparece pero una etiqueta visual es incorrecta, los cambios de índice crudo todavía confirman que una entrada llegó al navegador. Si los ejes no regresan al centro, Prueba de derivación de palo añade una muestra de tiempo, pero ese resultado sigue vinculado a la cartografía y calibración actuales.
Promesa de compatibilidad
Keymap Labs admite navegadores modernos que exponen la API de Gamepad y proporciona un estado de retroceso explícito cuando ninguno está disponible. No requiere una cuenta, extensión del navegador o controlador. No puede garantizar funciones de controlador avanzadas o etiquetas universales.
Esa promesa es intencionalmente precisa. Los usuarios reciben un diagnóstico crudo de trabajo donde la plataforma lo permite y una explicación útil donde no lo hace.