Skip to main content
Windows.Xbox.Input é a API de entrada para o desenvolvimento com o XBOX One Software Development Kit anterior ao GDK. Conceitualmente, o GameInput enxerga os dispositivos e as leituras de entrada de uma maneira diferente. Este tópico descreve algumas das principais diferenças entre Windows.Xbox.Input e GameInput.

Centrado na entrada vs. centrado no dispositivo

A principal diferença entre Windows.Xbox.Input e GameInput é que o primeiro exige que você comece reunindo os dispositivos e o estado de entrada como uma propriedade de um dispositivo. Por outro lado, o GameInput começa com um fluxo filtrável de leituras de entrada que têm dispositivos associados.

Procurando o pressionamento do botão A

Quando um jogo é iniciado pela primeira vez, muitas vezes o usuário precisa pressionar A para indicar que está pronto para continuar. Aqui, um exemplo compara como fazer isso em Windows.Xbox.Input e em GameInput. Este exemplo procura apenas um gamepad. Observe que os exemplos foram simplificados para fins de demonstração.

Windows.Xbox.Input

O exemplo de código a seguir começa enumerando todos os gamepads conectados ao sistema e armazenando-os no vetor gamepads. Em seguida, ele itera por gamepads em um loop, examina a leitura de entrada atual de cada um e verifica em cada leitura se A foi pressionado.
Este código se refere a uma API anterior. Essas chamadas não existem no GameInput.
Esse modelo poderia ser aprimorado. O jogo precisa armazenar cópias dos diferentes dispositivos conectados ao sistema. Você precisa entender as especificidades de cada dispositivo. Além disso, ao armazenar uma cópia local de todos os gamepads, o código captura um estado em um momento específico, em vez de obter as leituras mais atualizadas.

GameInput

No exemplo de código a seguir, o código procura a leitura de gamepad mais recente de qualquer dispositivo. Ao chamar GetCurrentReading com um filtro GameInputKind definido como GamePad, o código solicita que m_gameInput retorne somente leituras de gamepad. Em seguida, o código consulta o estado da leitura e verifica se A foi pressionado. Talvez você queira acompanhar com qual gamepad está se comunicando. Para obter um exemplo mais completo, confira Leituras do GameInput.
O GameInput não exige que você itere pelos dispositivos e verifique cada leitura. Em vez disso, você pode verificar o estado de entrada mais recente com uma única chamada de método. Você pode escolher o quanto deseja saber sobre cada dispositivo físico.

Documentação de referência da API

Confira também

Visão geral do GameInput Referência da API de entrada Microsoft Game Development Kit
Last modified on October 6, 2026