Entendendo o XInput
Tudo o que você precisa saber sobre a API Microsoft XInput e o utilitário xinput do X.Org para controlar dispositivos de entrada.
Download XInput
Select the appropriate version for your operating system
O que é XInput?
O termo "xinput" refere-se a duas tecnologias diferentes que são comumente confundidas:
API Microsoft XInput
Uma Interface de Programação de Aplicativos (API) desenvolvida pela Microsoft para Windows que padroniza a comunicação entre jogos e controles compatíveis com Xbox.
Utilitário xinput do X.Org
Um utilitário de linha de comando para sistemas operacionais do tipo Unix (Linux, BSD) que permite aos usuários configurar vários dispositivos de entrada, como mouses, teclados e touchpads.
Comparação Rápida
| Recurso | API Microsoft XInput | Utilitário xinput do X.Org |
|---|---|---|
| SO Principal | Windows | Tipo Unix (Linux, BSD) com X11/XWayland |
| Função Principal | API para entrada de controle de jogo | Utilitário para configurar dispositivos de entrada X11 |
| Uso Típico | Jogos com controles estilo Xbox | Configurando mouses, teclados, touchpads |
| Instalação | Integrado ao SO/Drivers | Via gerenciador de pacotes (apt, dnf, etc.) |
| Interface | Nenhuma (API); Testado via joy.cpl | Interface de Linha de Comando (CLI) |
API Microsoft XInput
Uma interface padronizada para controles de jogo no Windows.
Recursos Principais
- Layout de controle padronizado baseado nos controles do Xbox
- API simplificada para desenvolvedores em comparação com o DirectInput
- Suporte a vibração/rumble integrado
- Suporte adequado para gatilhos analógicos
- Suporte para headset/dispositivo de áudio
- Suporte para até quatro controles simultaneamente
Versões do XInput
Existem diferentes versões, com recursos e compatibilidade de SO variados:
XInput 1.4
Windows 8, 10 e 11
Versão mais atual com conjunto completo de recursos
XInput 9.1.0
Windows Vista e mais recente
Conjunto de recursos reduzido, mantido para compatibilidade com versões anteriores
XInput 1.3
Versão legada do SDK do DirectX
Não mais prontamente disponível da Microsoft
Configurando o Microsoft XInput
A funcionalidade do XInput é integrada ao Windows e acessada através dos drivers do controle. Veja como garantir que funcione corretamente:
Passos para Garantir que o XInput Funcione Corretamente
Atualize o Windows
Mantenha seu SO Windows atualizado para garantir que você tenha o suporte XInput mais recente
Instale os Drivers Corretos
Para controles oficiais do Xbox, o Windows Update geralmente cuida disso automaticamente. Para outros controles, pode ser necessário baixar drivers específicos.
Conecte seu Controle
Conecte seu controle via USB ou um adaptador sem fio/Bluetooth
Verifique o Gerenciador de Dispositivos
Verifique se o Windows reconhece seu controle corretamente, sem erros
Verificando o Funcionamento do XInput
Verifique o Gerenciador de Dispositivos
Procure em "Dispositivos de Interface Humana", "Periféricos do Xbox" ou "Controladores de som, vídeo e jogos"
Use as Configurações de Controle de Jogo
Pressione Win+R, digite joy.cpl e pressione Enter para abrir o painel de Controles de Jogo
Teste em Jogos
Inicie um jogo que suporte XInput para testar se seu controle funciona corretamente
Utilitário xinput do X.Org
Uma ferramenta de linha de comando para gerenciar dispositivos de entrada em sistemas do tipo Unix com o X Window System.
Propósito Principal
O utilitário xinput permite que você:
- Liste todos os dispositivos de entrada reconhecidos pelo servidor X
- Consulte informações detalhadas sobre dispositivos específicos
- Configure as configurações do dispositivo dinamicamente (mapeamento de botões, sensibilidade, etc.)
- Ative ou desative dispositivos completamente
Instalando o Utilitário xinput do X.Org
A instalação do xinput geralmente é feita através do gerenciador de pacotes da sua distribuição:
Pré-requisitos
- Um sistema do tipo Unix em execução (Linux, BSD)
- X Window System (X11 ou XWayland)
- Privilégios administrativos (root ou sudo)
Comandos de Instalação
Debian, Ubuntu, Linux Mint
sudo apt update && sudo apt install xinputFedora, RHEL 8+, CentOS 8+
sudo dnf install xinputRHEL 7, CentOS 7
sudo yum install xinputArch Linux, Manjaro
sudo pacman -Syu xorg-xinputComandos Essenciais do xinput
xinput list
Exibe todos os dispositivos de entrada reconhecidos pelo servidor X
$ xinput listxinput list-props "Nome do Dispositivo"
Mostra as propriedades associadas a um dispositivo específico
$ xinput list-props "DELL Touchpad"xinput set-prop "Nome do Dispositivo" "Nome da Propriedade" <valor>
Modifica o comportamento do dispositivo definindo propriedades
$ xinput set-prop "DELL Touchpad" "libinput Tapping Enabled" 1xinput enable/disable "Nome do Dispositivo"
Ativa ou desativa um dispositivo
$ xinput disable "DELL Touchpad"Verificando a Instalação
Abra um terminal
Acesse a interface de linha de comando do seu sistema
Verifique a versão
Execute "xinput --version" para confirmar a instalação
Liste os dispositivos
Execute "xinput list" para ver se ele consegue detectar seus dispositivos de entrada
Considerações de Compatibilidade
Versões do Servidor X
As capacidades dependem da versão da Extensão de Entrada do X suportada pelo seu servidor
Wayland
o xinput tem funcionalidade limitada no Wayland, afetando apenas os aplicativos executados através do XWayland
Problemas Comuns e Soluções
Microsoft XInput Não Funciona
- Atualize os drivers do controle via Gerenciador de Dispositivos
- Verifique as portas USB ou as conexões do adaptador sem fio
- Tente portas USB diferentes
- Verifique se há atualizações do Windows
- Teste com outro jogo ou aplicativo
Comando xinput do X.Org Não Encontrado
- Verifique a instalação com seu gerenciador de pacotes
- Faça logout e login novamente para atualizar o PATH
- Verifique se você está executando o Wayland em vez do X11
- Tente usar o caminho completo para o binário do xinput
Configurações do xinput Resetadas Após a Reinicialização
- Adicione seus comandos xinput aos scripts de inicialização
- Crie um arquivo .desktop em ~/.config/autostart/
- Use as configurações de aplicativos de inicialização do seu ambiente de desktop
Perguntas Frequentes
O Microsoft XInput e o xinput do X.Org são relacionados?
Não, eles são tecnologias totalmente diferentes que por acaso compartilham um nome semelhante. O Microsoft XInput é para controles de jogo no Windows, enquanto o xinput do X.Org é para configurar dispositivos de entrada em sistemas do tipo Unix.
Posso usar controles do Xbox no Linux?
Sim, a maioria das distribuições Linux modernas suporta controles do Xbox. Embora o utilitário xinput do X.Org possa ajudar a configurar alguns aspectos, para jogos você normalmente dependerá do suporte do kernel para controles de jogo através dos subsistemas joystick e evdev.
Preciso instalar o XInput no Windows?
Não, a funcionalidade do XInput é integrada ao Windows. Você só precisa garantir que seu controle tenha os drivers corretos instalados, o que muitas vezes acontece automaticamente.
Como eu corrijo meu controle que не está sendo detectado?
No Windows, verifique o Gerenciador de Dispositivos para problemas de driver. No Linux, use 'lsusb' para verificar se o dispositivo está conectado e, em seguida, configure-o com as ferramentas apropriadas para o seu ambiente.
Os comandos do xinput podem ser tornados permanentes no Linux?
Sim, adicione seus comandos xinput aos scripts de inicialização ou crie uma regra udev para uma configuração mais permanente.