Teste de controle

Conectar um controle

Use este teste para conferir um controle antes de uma partida, de uma live ou de um conserto. Ele lê a Gamepad API localmente no navegador e mostra os valores dos botões, os eixos, o movimento filtrado pela zona morta e o suporte disponível a vibração. Controles com mapeamento padrão recebem nomes conhecidos; em layouts brutos, os comandos permanecem numerados para que a ferramenta não tente adivinhar a disposição física. Os identificadores do dispositivo, os valores dos botões e as leituras dos eixos ficam no navegador.

Como testar um controle

  1. 1

    Conecte e acorde o gamepad

    Ligue um controle por USB ou pareie por Bluetooth. Aperte qualquer botão uma vez se o navegador esperar uma ação do usuário antes de listar o dispositivo.

  2. 2

    Acione todos os comandos

    Aperte cada botão e mova os analógicos. Acompanhe as barras de valor de entrada, os valores brutos dos eixos e as posições filtradas se atualizando em tempo real. Os nomes dos gatilhos só aparecem quando o navegador informa um mapeamento padrão.

  3. 3

    Teste os analógicos centralizados e a vibração

    Deixe os dois analógicos parados durante a breve amostragem na posição central, ajuste a zona morta da tela se for útil e rode a verificação de vibração quando o navegador expuser um atuador háptico.

O que a Gamepad API informa

Os navegadores modernos expõem os controles compatíveis pela Gamepad API. Cada gamepad detectado pode fornecer um id, um nome de mapeamento, uma lista ordenada de botões e uma lista ordenada de eixos. Um botão pode devolver um valor de entrada analógico de 0,00 a 1,00 em vez de apenas pressionado ou solto. Os eixos normalmente informam movimentos de -1,00 a 1,00, sendo 0,00 a posição central. Apenas o mapeamento standard garante a ordem conhecida de botões, gatilhos e analógicos; por isso, os layouts brutos permanecem numerados.

Zona morta e drift

A zona morta é uma pequena faixa em torno do centro do analógico que a tela trata como zero. O padrão aqui é 0,12, então os valores de -0,12 até 0,12, inclusive, são filtrados. Esse ajuste muda apenas a tela do testador: não calibra o controle nem altera um jogo. Nos gamepads com mapeamento padrão, o teste de centralização coleta amostras dos quatro eixos dos analógicos em repouso. Ele aponta uma leitura persistente fora do limite escolhido e descarta a amostra se os analógicos se moverem durante o teste. É um indício para o diagnóstico, não um diagnóstico definitivo do hardware.

Sintoma O que observar Solução comum
A câmera se mexe sozinha Uma amostra estável com os analógicos centralizados fica fora da zona morta Repita sem tocar neles e depois ajuste o jogo ou leve o analógico para reparo
O gatilho não vai até o fim O valor de entrada de um gatilho com mapeamento padrão para abaixo de 100% Recalibre, limpe o controle ou teste em outra porta USB
Botão com duplo input O botão numerado muda de estado duas vezes com um só toque Verifique o interruptor, o cabo ou a conexão sem fio
O teste de vibração falha A vibração não tem suporte ou o navegador bloqueia Tente outro navegador ou confirme se o controle tem hápticos

Exemplo prático

Suponha que várias amostras com os analógicos centralizados fiquem perto de +0,04 no eixo X e -0,03 no eixo Y. Com a zona morta padrão de 0,12, os dois valores filtrados viram 0,00 e o resultado permanece dentro do limite. Se as amostras estáveis se concentrarem perto de +0,21, a ferramenta informa que esse eixo em repouso está fora da zona morta. Repita sem tocar no analógico antes de mudar a zona morta no jogo, recalibrar ou verificar o hardware em outro computador.

Erros comuns

  • Alguns navegadores só mostram o gamepad depois que um botão é pressionado com a página já aberta.
  • Latência do Bluetooth, bateria fraca ou um cabo ruim podem fazer os comandos parecerem intermitentes.
  • A ordem dos botões e dos eixos pode variar fora do mapeamento padrão; por isso, os comandos brutos permanecem numerados de propósito.
  • Um teste de vibração no navegador só prova o suporte do navegador. Um jogo pode usar a própria camada de hápticos de outra forma.

Perguntas frequentes

Os identificadores do dispositivo, os estados dos botões e as leituras dos eixos ficam no navegador e não são enviados ao servidor. No modo em etapas, somente a zona morta e a posição do controle selecionado seguem na URL como ajustes de visualização.

Muitos navegadores esperam o usuário interagir com o controle. Aperte qualquer botão depois de abrir a página, confira se a aba está em foco e atualize a lista se precisar.

Comece com o padrão de 0,12 como limite de visualização. Valores menores revelam leituras em repouso mais discretas; valores maiores escondem mais movimento nesta tela. O controle deslizante não altera o controle nem o jogo: configure a zona morta real dentro do próprio jogo.

O suporte a hápticos depende do controle, do navegador, do sistema operacional e do tipo de conexão. Se o botão estiver desativado, o gamepad continua servindo para testar os comandos, mas não expõe um atuador de vibração para a página.

Ferramentas relacionadas