Como funciona
Mostra em tempo real tudo o que o controle informa ao navegador: cada botão com seu valor analógico e um contador de acionamentos, os gatilhos como barras que se enchem, os dois sticks com sua posição exata e um registro do percurso. Serve para controles de Xbox, PlayStation e Nintendo, e para qualquer gamepad, volante ou manche USB ou Bluetooth que o sistema reconheça.
As duas falhas mais comuns em um controle usado são o drift, quando o stick solto não volta ao centro, e os botões que deixam de responder ou falham com repetição. Com o stick em repouso, a distância até o centro deve ficar perto de zero; o teste de circularidade, concluído girando o stick rente à borda, mede também se o percurso chega de forma uniforme a todas as direções.
Exemplos
axes[0] = 0.0784 · axes[1] = -0.1137r = 0.138Um stick que, sem ser tocado, fica a essa distância do centro tem drift: em um jogo com zona morta pequena, a câmera ou o personagem se mexe sozinho.XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE = 78497849 / 32767 ≈ 0.24É a zona morta que a Microsoft sugere para o stick esquerdo no XInput. Um drift menor que esse valor passa despercebido nos jogos que a usam, mas não naqueles que a reduzem para ganhar precisão.buttons[7].value = 0.42RT · R2 · ZR → 42 %Os gatilhos de Xbox e PlayStation são analógicos e informam o quanto estão pressionados. Os ZL e ZR do Pro Controller da Nintendo são digitais: só passam de 0 a 1.Casos de uso
- Verificar se um stick tem drift antes de acionar a garantia, trocar o módulo ou comprar um controle usado.
- Conferir um por um os botões de um controle consertado ou recém-limpo, usando o contador para detectar acionamentos duplos.
- Confirmar que um controle Bluetooth foi pareado corretamente e que o sistema o reconhece antes de abrir um jogo.
- Ver quais números de botão e de eixo um volante, um arcade stick ou um manche de voo informa, para configurá-los em um emulador.
- Testar se os motores de vibração funcionam.
Perguntas frequentes
Por que meu controle não aparece?
Por privacidade, o navegador não mostra nenhum controle até que você pressione um botão com a página aberta e em primeiro plano. Se mesmo assim não aparecer, verifique se o sistema o enxerga: no Windows, execute joy.cpl para abrir os dispositivos de jogo. Programas como Steam, DS4Windows ou reWASD podem ocultar o controle original e apresentar um virtual no lugar.
Como sei se o stick tem drift?
Solte o stick e observe o valor r, que é a distância até o centro. Um stick saudável fica em poucos centésimos; se passar de 0,1 sem ser tocado, ou o ponto se mexer sozinho, há drift. Leve-o até a borda e solte-o várias vezes: se ele voltar a lugares diferentes, a mola ou o potenciômetro estão gastos.
O que o erro de circularidade mede?
Ao girar o stick rente à borda, a ferramenta guarda o ponto mais distante que ele alcançou em cada uma das 36 direções e calcula o quanto, em média, ele se afasta de um círculo perfeito. Um valor alto indica que, em algumas direções, o stick não chega ao máximo ou o ultrapassa. Alguns controles ampliam as diagonais de propósito, então convém comparar dois controles do mesmo modelo antes de tirar conclusões.
O que significa o mapeamento ser não padrão?
O navegador conhece o layout dos controles mais comuns e os apresenta todos com a mesma ordem de botões, o que permite desenhá-los. Quando não reconhece um modelo, entrega os botões e eixos na ordem em que o dispositivo os informa; eles continuam funcionando, mas sem nomes. Com outro navegador ou outra conexão, USB em vez de Bluetooth, o mesmo controle às vezes é reconhecido.
Por que os botões de vibração não aparecem?
Eles só aparecem quando o navegador oferece vibração para aquele controle. Chrome e Edge a oferecem para a maioria dos controles de Xbox e PlayStation; outros navegadores, algumas conexões Bluetooth e muitos controles genéricos não a expõem, mesmo que o controle tenha motores.
Posso medir a latência ou a taxa de polling do controle?
Não com precisão. O navegador não avisa a cada mudança do controle: a página o consulta uma vez por quadro da tela, então nunca vê mais mudanças por segundo do que a taxa de atualização do monitor. Para medir o polling real, são necessárias ferramentas que leiam o dispositivo diretamente.