Detecção de Mapeamento de Botões

Sem Controle

Como usar: Pressione qualquer botão físico do seu controle. Observe qual área acende na tela e seu número de índice correspondente. Se a área iluminada não corresponde ao botão pressionado, pode haver modificação de mapeamento ou problema de driver.

Log de Eventos em Tempo Real

Aguardando entrada...

Dados Brutos dos Eixos

EIXO 00.00000

EIXO 10.00000

EIXO 20.00000

EIXO 30.00000

Standard Gamepad: O Padrão Web Unificado

Como o W3C definiu o futuro dos controles multiplataforma com 17 botões e 4 eixos?

Padrão W3C

Layout de Botões do Standard Gamepad

A API Gamepad define um layout fixo de "Standard Gamepad": 4 botões frontais (Índice 0-3, ABXY), botões de ombro (Índice 4-7, LB/RB/LT/RT), botões do sistema (Índice 8-9), etc.

Referência Rápida de Índices

0-3: A/B/X/Y (frontais)

10-11: LS/RS (clique do analógico)

4-5: LB/RB (bumpers)

12-15: D-Pad

6-7: LT/RT (gatilhos)

16+: Home/Share (estendido)

Dados dos Eixos

0/1: Analógico esquerdo X/Y　2/3: Analógico direito X/Y (faixa -1.0 a 1.0)

API Standard Gamepad

Por Que o Mapeamento do Meu Controle Está Errado?

DirectInput, XInput, drivers diferentes... Desvendando a verdade por trás da confusão de botões

A Aleatoriedade do DirectInput

O DirectInput não especifica a ordem dos botões — cada fabricante define livremente. O botão "×" do controle PS pode ser Índice 0 ou Índice 1. Isso significa que o mesmo botão físico pode ter índices diferentes com drivers diferentes.

Modificações de Mapeamento em Nível de Driver

Ferramentas como DS4Windows e BetterJoy "disfarçam" seu controle como um controle Xbox. Isso modifica o mapeamento de botões para conformar com a especificação Standard Gamepad. Isso é comportamento intencional, não um bug.

Perguntas Frequentes

Tudo sobre mapeamento de botões do controle

QPor que meu D-Pad aparece como Eixo ao invés de Botões?

Alguns controles antigos (como Xbox 360) implementam o D-Pad como eixos (Eixo 6/7) ao invés de 4 botões separados. Isso é diferença de design do hardware, e o navegador reflete fielmente o estado do hardware.

QPor que LT/RT às vezes são Botões e às vezes Eixos?

Depende do modo do driver. Em modo XInput, LT/RT são Botões 6/7 (digital). Em modo DirectInput, podem ser Eixos (analógico 0-1). A especificação Standard Gamepad requer que gatilhos sejam botões.

QPosso modificar o mapeamento de botões eu mesmo?

A API Gamepad do navegador é somente leitura — você não pode modificar mapeamentos. Soluções: ① Use ferramentas em nível de sistema (AntiMicro, JoyToKey); ② Personalização de teclas no jogo; ③ Mude drivers (DS4Windows).

QPor que meu controle tem 20+ botões?

Alguns controles avançados (flight sticks, volantes) têm muitos botões físicos. O navegador expõe todos os botões, mas o Standard Gamepad define apenas os primeiros 17. Botões extras não têm nomes padrão.

Entendendo o Mapeamento de Controles

Por que pressionar A mostra B? Use esta ferramenta de teste de entrada para revelar a lógica do driver. A melhor maneira de testar botões do controle e resolver erros de remapeamento no PC.

Protocolo Padrão XInput

A maioria dos jogos de PC e navegadores seguem o padrão de layout do controle Xbox 360. Isso significa que independente da marca do seu controle, o sistema mapeia os botões para índices padrão 0-16.

Botão 0: A (Baixo)

Botão 1: B (Direita)

Botão 2: X (Esquerda)

Botão 3: Y (Cima)

Problemas Comuns de Mapeamento

Conflito de Layout Nintendo: Controles Switch fisicamente têm "A à direita, B embaixo" mas o PC lê "A embaixo, B à direita". Se os botões parecem trocados durante o teste, é uma diferença de protocolo. Corrija via Steam Input.
Detecção de Macro/Remap: Se você usa mapeamento de botões traseiros ou macros, esta ferramenta mostra o botão lógico remapeado. Por exemplo, se você mapear um botão traseiro para A, pressioná-lo iluminará o Botão 0.

Sobre Índices da API

Índice 0-3: Botões Frontais

Índice 4-5: Bumpers (LB/RB)

Índice 6-7: Gatilhos (LT/RT)

Índice 8-9: Select/Start

Índice 10-11: Cliques do Analógico

Índice 12-15: D-Pad

Índice 16: Home

Índice 17: Share/Touch