Teste de Comando

Um teste de comando lê os sinais que o controlador envia ao navegador através da Gamepad API do W3C e mostra-os em tempo real: cada premir 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 comando funciona antes de um jogo, diagnosticar um botão facial colado, detetar drift do stick num comando antigo ou verificar se ambos os motores de vibração disparam. A página realça cada entrada num layout ao estilo Xbox no ecrã, apresenta os valores brutos dos eixos e gatilhos e mantém um breve registo de eventos. Como a Gamepad API só expõe um controlador depois de premir um botão nele, a página pede-lhe que prima qualquer tecla primeiro - é uma regra de segurança do navegador, não um defeito do comando. Tudo corre localmente no navegador; nenhum dado de entrada sai do seu dispositivo.

O navegador expõe comandos através da Gamepad API do W3C. Um controlador é representado por um objeto Gamepad obtido de navigator.getGamepads(), que devolve até quatro slots. Cada comando transporta 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, pelo que a página corre um ciclo requestAnimationFrame e lê um snapshot novo a cada frame. Para evitar re-renderizações inúteis com o comando em repouso, só atualiza o estado quando gamepad.timestamp muda - esse timestamp avança a cada novo relatório de entrada. A ligação e desligação chegam como eventos gamepadconnected e gamepaddisconnected da window. Por segurança, um objeto gamepad mantém-se null até o utilizador premir um botão nele, pelo que a página não consegue ler silenciosamente um comando recém-ligado. 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, pelo que a página faz deteção de funcionalidades e desativa os botões caso contrário.

• navigator.getGamepads() devolve até quatro slots; um comando só fica não null depois de premir 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 deteção de funcionalidades, nem todos os navegadores suportam.
• Eventos gamepadconnected / gamepaddisconnected sinalizam ligação e desligação; o .index do comando identifica o slot.