Skip to main content
Windows.Xbox.Input es la API de entrada para el desarrollo con el Software Development Kit de XBOX One anterior al GDK. Conceptualmente, GameInput ve los dispositivos y las lecturas de entrada de una manera diferente. Este tema describe algunas diferencias clave entre Windows.Xbox.Input y GameInput.

Centrado en la entrada frente a centrado en el dispositivo

La diferencia clave entre Windows.Xbox.Input y GameInput es que el primero requiere que comience recopilando dispositivos y el estado de entrada como una propiedad de un dispositivo. En cambio, GameInput comienza con una secuencia filtrable de lecturas de entrada que tienen dispositivos asociados.

Búsqueda de la pulsación del botón A

Cuando un juego se inicia por primera vez, a menudo el usuario debe presionar A para indicar que está listo para continuar. Aquí, un ejemplo compara cómo hacer esto en Windows.Xbox.Input y en GameInput. Este ejemplo solo busca un mando. Tenga en cuenta que los ejemplos están simplificados con fines de demostración.

Windows.Xbox.Input

El siguiente ejemplo de código comienza enumerando todos los mandos que están conectados al sistema y almacenándolos en el vector gamepads. A continuación, itera por gamepads en un bucle, examina cada una de sus lecturas de entrada actuales y comprueba en cada lectura el botón A.
Este código hace referencia a una API anterior. Estas llamadas no existen en GameInput.
Este modelo podría mejorarse. El juego debe almacenar copias de los distintos dispositivos que están conectados al sistema. Debe comprender los detalles de cada dispositivo. Además, al almacenar una copia local de todos los mandos, el código captura un estado en un momento dado en lugar de obtener las lecturas más actualizadas.

GameInput

En el siguiente ejemplo de código, el código busca la lectura de mando más reciente de cualquier dispositivo. Al llamar a GetCurrentReading con un filtro GameInputKind establecido en GamePad, el código pide a m_gameInput que solo devuelva lecturas de mando. A continuación, el código consulta el estado de la lectura y comprueba si se ha presionado A. Es posible que quiera realizar un seguimiento del mando con el que está interactuando. Para ver un ejemplo más completo, consulte Lecturas de GameInput.
GameInput no requiere que itere por los dispositivos y compruebe cada lectura. En su lugar, puede comprobar con una sola llamada de método el estado más reciente de la entrada. Puede elegir cuánto quiere saber acerca de cada dispositivo físico.

Documentación de referencia de la API

Consulte también

Información general de GameInput Referencia de la API de entrada Microsoft Game Development Kit
Última modificación el 28 de agosto de 2026