Como testar controles no Windows
Confira a conexão, o reconhecimento do controle e a leitura dos botões no navegador. O guia também explica como investigar interferências de programas de remapeamento quando o controle não aparece ou envia comandos inesperados.
O que significa Como testar controles no Windows
A configuração que funciona
O Windows tem mais controles, mais drivers e mais software em segundo plano competindo pelo seu gamepad. Obter leituras confiáveis baseadas em navegador significa eliminar a interferência antes que ela comece. Siga estas etapas em ordem.
- 01
Use Chrome ou Edge
Ambos usam o motor Chromium e compartilham a mesma implementação bem suportada da Gamepad API, incluindo teste de vibração. O Firefox funciona, mas reporta contagens de eixo de forma diferente em alguns controles (deslocando índices em uma posição) e não suporta feedback háptico. O Safari no Windows não é relevante - a Apple o descontinuou há anos.
- 02
Feche o Steam antes de testar
Esta é a maior causa isolada de 'controle detectado mas botões não fazem nada' no Windows. O Steam Input intercepta controles no nível do driver e os remapeia antes que qualquer outro aplicativo veja a entrada bruta. Feche completamente o Steam ou desative o layout de controle desktop do Steam para seu controle. Depois atualize a página do navegador.
- 03
Use um cabo USB capaz de transmitir dados
Nem todo cabo USB-C transmite dados - muitos incluídos com telefones e controles são apenas para carga. O cabo que veio na caixa do seu controle é garantidamente um cabo de dados. Cabos de terceiros devem estar marcados como USB 2.0 ou superior; qualquer cabo sem marcação ou anunciado como 'cabo de carga' dificilmente exporá o gamepad ao Windows.
- 04
Pressione um botão depois que a página carregar
Todo navegador oculta controles conectados até que o usuário interaja fisicamente com um na página visível. Esse é um recurso de privacidade que impede que sites identifiquem silenciosamente seu hardware. Se o testador disser 'nenhum controle detectado', a solução quase sempre é: clique na página e pressione qualquer botão no controle.
- 05
Prefira com fio para medição, sem fio para conveniência
Para testes de drift, latência ou taxa de polling, USB com fio oferece a leitura mais limpa - sem interferência de rádio, sem latência da pilha Bluetooth, sem efeitos do nível de bateria. Para teste funcional casual (botões registrando, sticks se movendo), sem fio está bom. Nunca use Bluetooth para o teste de latência se puder evitar.
Soluções Como testar controles no Windows
Controles relacionados a Como testar controles no Windows
Outros termos do glossário
perguntas Como testar controles no Windows
Duas causas mais comuns: o Steam Input está rodando e interceptando o controle antes que o navegador o veja, ou você ainda não pressionou um botão na página visível. Feche completamente o Steam e atualize o navegador, depois pressione fisicamente um botão no controle. Se um layout gerenciado pelo Steam é o que seus jogos esperam, esse trade-off é real - você pode precisar testar o controle com o Steam fechado e depois reiniciar o Steam para jogar.
Para teste básico de botão e eixo, Chrome e Edge são essencialmente idênticos porque compartilham o motor Chromium. O Firefox funciona, mas para medição ele introduz duas peculiaridades reais: reporta contagens de eixo de forma diferente em alguns controles XInput (deslocando o índice do eixo em um), e não suporta teste de feedback háptico. Para verificações funcionais casuais, o Firefox está bom. Para testes de diagnóstico sérios, use Chrome ou Edge.
Coloque o controle no modo de pareamento (geralmente segurando um pequeno botão de pareamento até um LED piscar rapidamente - consulte o manual do seu controle específico). Abra Configurações do Windows → Dispositivos Bluetooth → Adicionar dispositivo → Bluetooth. Aguarde o nome do controle aparecer e clique nele. Quando o Windows mostrar 'Conectado', abra o testador do navegador e pressione qualquer botão no controle para torná-lo visível à página. Se o pareamento falhar repetidamente, desconecte e reconecte o adaptador Bluetooth ou reinicie o Serviço de Suporte Bluetooth.
O Windows vê o controle no nível do sistema operacional; o navegador só o vê depois que a Gamepad API recebe um sinal. Três verificações: pressione qualquer botão no controle com a página do testador em foco, confirme que nenhum outro aplicativo (Steam, Xbox Accessories, DS4Windows) está retendo o controle exclusivamente, e confirme que você está em uma página HTTPS - a Gamepad API descarta pacotes em HTTP ou origens de arquivo local por segurança.
Para controles Xbox, o driver XInput integrado do Windows é sempre a escolha certa. Para controles PlayStation, o integrado do Windows funciona, mas o Steam Input traduz DualSense/DualShock 4 para XInput de forma mais confiável que HID puro. Controles de terceiros (8BitDo, GuliKit, Nacon) geralmente funcionam imediatamente; um configurador específico do fabricante como o 8BitDo Ultimate Software ou o app da GuliKit só é necessário para atualizações de firmware ou troca de perfis, não para teste no navegador.
Sim. O Windows não exporá um controle ao navegador se o cabo não puder transmitir dados. USB-C é enganoso porque cabos apenas para carga parecem idênticos a cabos de dados. O cabo que veio na caixa do controle é um cabo de dados. Cabos USB-C aleatórios de uma gaveta frequentemente não são. Se seu controle não aparecer no navegador, troque o cabo primeiro - essa é uma solução real, não um placebo.
Portas traseiras em um desktop ficam diretamente na placa-mãe e são quase sempre mais confiáveis que portas frontais (que passam por um conector do gabinete). Hubs USB, especialmente sem alimentação, podem introduzir problemas de fornecimento de energia que fazem dongles sem fio desconectarem intermitentemente. Se tiver problemas de conexão, conecte diretamente em uma porta traseira antes de fazer qualquer outra coisa.
Sim. A Gamepad API suporta até quatro controles simultâneos via driver XInput padrão, e a maioria dos testadores modernos pode exibir todos eles. Cada controle conectado ocupa seu próprio slot (índice 0, 1, 2, 3). Índices de slot podem ser reutilizados quando um controle desconecta, então não assuma que o 'controle 0' é sempre o mesmo dispositivo físico ao longo de uma sessão.
Leituras complementares
- Gamepad API - MDN Web Docs · MDN Web Docs
- Usando a Gamepad API - MDN Web Docs · MDN Web Docs
- Steam Input Configuration Documentation · Steamworks Documentation
- Controle Xbox Wireless - Configuração para Windows · Xbox Support