Um controle conectado pode funcionar em um jogo e ainda assim permanecer invisível para uma página web. Isso não indica imediatamente uma falha. Os navegadores aplicam regras de privacidade e segurança, alguns expõem um gamepad apenas após um pressionamento deliberado de botão, e outro aplicativo pode estar retendo ou transformando o dispositivo.
Use uma ordem simples de solução de problemas que altera uma camada por vez.
Primeiro, verifique se o navegador consegue vê-lo
Antes de trocar um único cabo, pressione qualquer botão no controle com esta página aberta. Se ele aparecer abaixo, o navegador consegue vê-lo e o problema está mais adiante.
Se nada apareceu, isso ainda é informação — e a seção seguinte explica por que um controle ocioso e perfeitamente funcional é invisível por design.
Acionar a ativação do navegador
Abra o Testador de Gamepad, clique na página e pressione um botão de ação no controle. Mover apenas o stick pode não ser suficiente em todos os navegadores. A página escuta o padrão gamepadconnected evento e também verifica a lista atual de dispositivos expostos em cada frame de animação.
Se o controle aparecer, confirme a contagem de botões e eixos reportada. Um mapeamento genérico pode usar números diferentes do diagrama que espera; as alterações de índice bruto continuam úteis mesmo quando os rótulos não coincidem com o layout de um console.
Reconecte num estado conhecido
Feche jogos e aplicativos de configuração de controle, desconecte o dispositivo, aguarde um instante e reconecte-o. No Bluetooth, confirme se o sistema operacional ainda o lista como conectado. No USB, use uma porta direta e um cabo conhecido por transmitir dados, e não um cabo apenas de carga.
Retorne à página e aperte um botão novamente. Evite reconectar vários controles ao mesmo tempo, pois o navegador pode expor múltiplos índices e dificultar a identificação do dispositivo ativo.
Compare com um navegador atual
O comportamento da Gamepad API e os mapeamentos de dispositivos suportados diferem entre navegadores e sistemas operacionais. Teste um navegador baseado em Chromium ou Firefox se disponível. O resultado em um navegador é uma evidência sobre aquele ambiente, e não um veredito universal sobre o controle.
Algumas funcionalidades de dispositivos do navegador exigem uma conexão segura. Utilize https://keymap.io, mantenha o navegador atualizado e evite versões copiadas ou incorporadas da página ao comparar resultados.
Remova camadas concorrentes
O Steam Input, utilitários do fabricante, software de controles virtuais e ferramentas de acessibilidade podem remapear, combinar ou ocultar dispositivos. Documente o perfil ativo antes de desativar qualquer coisa. Feche uma camada, reconecte e repita o teste.
Se um jogo usa um controle virtual enquanto o navegador vê o controle físico, a numeração de botões ou o comportamento dos eixos podem diferir. Isso é uma diferença de mapeamento, não necessariamente uma entrada com defeito.
Verifique o que "detectado" significa
O nome de um dispositivo na página confirma que o navegador expõe um objeto de gamepad. Não prova que todos os botões estão ligados corretamente. Mova todos os eixos e pressione todos os botões. Utilize o Stick Drift Test apenas após confirmar que os eixos esperados do analógico se movem.
Alguns controles expõem gatilhos como botões analógicos; outros usam eixos. Sensores de movimento, touchpads, LEDs e vibração não são representados de forma consistente pelo mapeamento padrão do navegador. A ausência deles em um testador web não prova que esses recursos de hardware falharam.
Quando o controle não funciona em lugar nenhum
Se o sistema operacional, os jogos e vários navegadores falharem todos na detecção do dispositivo, experimente outro cabo, porta e computador antes de recorrer à assistência. Verifique as instruções de emparelhamento, firmware e reposição do fabricante para o modelo exato. Evite instalar controladores desconhecidos de sites de transferência não oficiais.
Para um relatório de suporte útil, inclua o modelo do controle, o modo com ou sem fio, o sistema operacional, a versão do navegador, se um botão foi pressionado para a ativação e quais outros aplicativos odetectam. Isso separa um problema de exposição do navegador de uma falha de conexão em todo o sistema.
