Teste de Controle

Um teste de controle lê os sinais que o controlador envia ao navegador por meio da Gamepad API do W3C e os mostra em tempo real: cada pressionamento de botão, posição do stick analógico, profundidade do gatilho, direção do D-pad e motor de vibração. É a forma mais rápida de confirmar se um controle funciona antes de um jogo, diagnosticar um botão facial travado, detectar drift do stick num controle antigo ou verificar se ambos os motores de vibração disparam. A página destaca cada entrada num layout ao estilo Xbox na tela, apresenta os valores brutos dos eixos e gatilhos e mantém um breve registro de eventos. Como a Gamepad API só expõe um controlador depois que você pressiona um botão nele, a página pede que você pressione qualquer botão primeiro - é uma regra de segurança do navegador, não um defeito do controle. Tudo roda localmente no navegador; nenhum dado de entrada sai do seu dispositivo.

O navegador expõe controles por meio da Gamepad API do W3C. Um controlador é representado por um objeto Gamepad obtido de navigator.getGamepads(), que retorna até quatro slots. Cada controle carrega uma string id (fabricante e produto), um campo mapping ('standard' para dispositivos com layout Xbox, vazio caso contrário), um array buttons e um array axes.

No mapeamento padrão, buttons tem 17 entradas: quatro botões faciais (A/B/X/Y), dois bumpers (LB/RB), dois gatilhos analógicos (LT/RT), Select/Start, dois cliques de stick (L3/R3), quatro direções do D-pad e o botão Home/Guide. Cada botão expõe .pressed (booleano) e .value (0 a 1 - gatilhos são analógicos, botões digitais são 0 ou 1). O array axes guarda quatro valores no intervalo -1 a 1: X/Y do stick esquerdo, depois X/Y do stick direito.

A API é baseada em polling, não em eventos, então a página roda um ciclo requestAnimationFrame e lê um snapshot novo a cada frame. Para evitar re-renderizações inúteis com o controle em repouso, o estado só é atualizado quando gamepad.timestamp muda - esse timestamp avança a cada novo relatório de entrada. A conexão e desconexão chegam como eventos gamepadconnected e gamepaddisconnected da window.

Por segurança, um objeto gamepad permanece null até o usuário pressionar um botão nele, então a página não consegue ler silenciosamente um controle recém-conectado. A vibração é opcional: se existir gamepad.vibrationActuator, chamar playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) aciona os dois motores; o Safari e algumas builds Chromium não a implementam, então a página faz detecção de recursos e desativa os botões caso contrário.

• navigator.getGamepads() retorna até quatro slots; um controle só fica não null depois de pressionar um botão nele.
• Mapeamento padrão: buttons[0-3] faciais, [4-5] bumpers, [6-7] gatilhos analógicos, [8-9] Select/Start, [10-11] L3/R3, [12-15] D-pad, [16] Home.
• axes[0-1] é o stick esquerdo (X, Y), axes[2-3] o stick direito, cada um no intervalo -1 a 1.
• Modelo de polling: um ciclo requestAnimationFrame lê snapshots; gamepad.timestamp controla as atualizações para que frames em repouso não façam nada.
• Vibração via gamepad.vibrationActuator.playEffect('dual-rumble', ...) - com detecção de recursos, nem todos os navegadores suportam.
• Eventos gamepadconnected / gamepaddisconnected sinalizam conexão e desconexão; o .index do controle identifica o slot.