Gamepad API Tester

Conecte um controle e veja exatamente o que o navegador recebe.

gatilho esquerdogatilho direito analógico esquerdoanalógico direito

Aperte qualquer botão no controle para o navegador enxergá-lo.

Pronto.

Todos os testes rodam dentro do seu navegador. Nada do que você digita, fala, mostra ou aperta é enviado para fora.

Como usar este teste

Esta página mostra os dados brutos que a Gamepad API entrega a uma página da web: o id do controle, o índice e o mapping, o valor de cada eixo, o estado e o valor de cada botão, se ele vibra e com que frequência a página vê dados novos. Serve para conferir um controle e como referência se você estiver criando um jogo para navegador.

Conecte um ou mais controles, clique em Iniciar e aperte um botão em cada controle para o navegador mostrá-lo. Cada controle ganha a sua própria tabela. Mexa os analógicos e aperte os botões para ver os valores mudarem. Use o botão de vibração para testar a vibração e Copiar dados para copiar um retrato em JSON.

O que os resultados significam

Um mapping standard significa que o navegador reconheceu o controle no layout padrão: os botões 0 a 3 são os botões frontais, 4 a 7 os bumpers e gatilhos, 8 e 9 os dois botões do meio, 10 e 11 os cliques dos analógicos, 12 a 15 o direcional e 16 o botão home. Um mapping vazio significa que você recebe a ordem do próprio controle, que muda conforme o modelo e o sistema. A taxa de atualização mostra com que frequência a página vê dados novos; ela não lê mais rápido do que a tela atualiza.

O que o navegador não consegue ler

A Gamepad API cobre botões, analógicos, gatilhos e vibração simples. Ela não entrega às páginas os sensores de movimento, o nível da bateria, a barra de luz, os gatilhos adaptáveis do DualSense nem a posição no touchpad, mesmo que a especificação descreva toques. Os navegadores baseados no Chromium informam o clique do touchpad do PlayStation como botão 17. Páginas que precisam de mais podem usar a WebHID, que só o Chrome e o Edge em computadores suportam.

Suporte à vibração por navegador

O efeito dual-rumble funciona no Chrome e no Edge, e no Safari do Mac a partir da versão 16.4. O Firefox e os navegadores de iPhone e iPad não suportam. O Chrome e o Edge 126 ou mais novos também suportam o trigger-rumble, para os gatilhos com vibração dos controles Xbox.

Perguntas frequentes

Por que o controle só aparece depois que eu aperto um botão?

Por privacidade, os navegadores só revelam um controle depois que você o usa na página, para que um site não liste os seus dispositivos sem você saber.

O que significa o id?

É o nome que o sistema informa, muitas vezes com os números de fabricante e produto USB, por exemplo 054c da Sony e 045e da Microsoft. O formato exato muda de navegador para navegador.

Os dados são enviados para algum lugar?

Não. Tudo é lido e mostrado no seu navegador. Copiar dados só coloca o retrato na sua própria área de transferência.

Testes relacionados