> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Preguntas más frecuentes sobre GameInput

> Respuestas a preguntas comunes sobre GameInput: versiones compatibles de XBOX y Windows, integración con motores como Unreal, Godot y Unity, y portabilidad desde XInput.

### ¿Por qué debería basar el código de entrada de mi título en GameInput?

GameInput es una plataforma de entrada actualizable. Al usarla, Windows puede abstraer mejor la variedad de dispositivos de entrada disponibles en el mercado y seguir mejorando la compatibilidad con esos dispositivos con el tiempo mediante actualizaciones de la plataforma. Al usar GameInput, su título se actualizará automáticamente para funcionar con nuevos dispositivos a través de las versiones de Windows y de hardware.

Además, GameInput proporciona acceso a características más recientes que antes no estaban disponibles en Windows, como los gatillos de impulso, y una mejor compatibilidad con características como los hápticos y los sensores. Al usar GameInput, su título puede aprovechar estas características con cambios mínimos en el código.

### ¿Qué plataformas admite GameInput?

GameInput está disponible en:

* XBOX (V.1+ a partir del GDK 2510)
* Windows 10 (versión 19H1/actualización de mayo de 2019 y posteriores)
* Windows 11

Aunque GameInput v.0 forma parte del SDK de Windows y del Microsoft Game Development Kit (GDK), compilar con versiones más recientes requiere el uso del paquete NuGet, tanto para consola como para PC. El entorno de ejecución de GameInput v.1+ está disponible en consola a partir del GDK 2510, pero el uso de este entorno de ejecución requiere compilar y vincular con el encabezado/biblioteca del paquete NuGet de GameInput más reciente. La versión más reciente de la API para PC y consola siempre está disponible en el paquete NuGet [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput).

### ¿Necesito versiones diferentes para XBOX y PC?

No, la misma API de GameInput funciona en todas las plataformas. A partir del GDK 2510, la API de GameInput más reciente está disponible tanto en XBOX como en PC, con los mismos encabezados y binarios proporcionados en el paquete NuGet [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput). El instalador de GameInput solo es necesario para PC, ya que el entorno de ejecución se incluye con el GDK en XBOX.

### ¿Funciona GameInput con motores de uso común como Unreal Engine?

Sí, aunque el nivel de integración varía según el motor. Algunos motores incluyen compatibilidad propia con GameInput como complemento del motor, mientras que otros dependen de un ejemplo o de un complemento nativo que usted mismo integra.

* **Unreal Engine**: la compatibilidad con GameInput se incluye con el motor como un conjunto de complementos, a partir de Unreal Engine 5.4. **Game Input Base** proporciona la funcionalidad principal y la interfaz, **Game Input (Windows)** la implementa para Win64 y WinGDK, y **XBOX Common Game Input** la implementa para XBOX One y XBOX Series X|S. Habilite estos complementos en su proyecto para enrutar la entrada a través de GameInput tanto en PC como en consola. Para obtener más información, consulte [Complementos del Microsoft GDK para Unreal Engine](/build/gdk-and-engines/unreal/unreal#microsoft-gdk-plug-ins-for-unreal-engine).
* **Godot**: el ejemplo de Godot para XBOX incluye una GDExtension que vincula GameInput con Godot, incluida la conexión de GameInput con los sistemas `Input` e `InputMap` de Godot. Se trata de una integración de referencia que usted compila y adapta para su proyecto, en lugar de una característica integrada del motor. Para obtener más información, consulte [Introducción a Godot](/build/gdk-and-engines/godot#whats-included).
* **Unity**: actualmente ningún paquete del Microsoft GDK expone GameInput a Unity en PC, por lo que los juegos de Unity en PC normalmente leen la entrada a través del sistema de entrada de Unity. En XBOX Series X|S y XBOX One, el paquete GXDK Input System para Unity agrega funcionalidad específica de consola al sistema de entrada de Unity. Para obtener más información, consulte [Paquetes del GDK para Unity](/build/gdk-and-engines/unity/unity#gdk-packages-for-unity).

Si su motor no proporciona una integración de GameInput, o si quiere usar características de GameInput que su motor no expone, puede llamar a GameInput directamente desde código nativo mediante el paquete NuGet [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput).

### Mi aplicación no encuentra GameInput. ¿Qué debo comprobar?

1. Compruebe que el entorno de ejecución de GameInput está instalado en la máquina de destino. Para las versiones v.1 y posteriores, esto requiere un paquete Microsoft.GameInput, que el usuario puede instalar desde el paquete MSI incluido en el paquete NuGet Microsoft.GameInput. Para instalar la versión más reciente del paquete, también puede ejecutar `winget install Microsoft.GameInput` desde un símbolo del sistema con privilegios elevados.
2. Asegúrese de que su aplicación se vincula con la biblioteca de GameInput correcta. La versión más reciente del paquete NuGet garantiza que su proyecto use el binario de GameInput adecuado en los diferentes puntos de conexión/plataformas.
3. Compruebe que su versión de Windows es compatible con GameInput (19H1 o posterior).

### ¿Qué dificultad tiene portar de XInput a GameInput?

Muchas funciones de XInput se asignan una a una a sus equivalentes de GameInput, lo que simplifica el trabajo de portar de una a otra. La principal diferencia es que GameInput usa interfaces de C++ en lugar de funciones planas de C. GameInput también proporciona funcionalidad adicional no disponible en XInput, como el acceso al gatillo de impulso presente en los mandos de XBOX One y otros dispositivos similares.

### ¿Cómo porto desde DirectInput o Raw Input?

GameInput proporciona una ruta de interfaz como parte de la estructura GameInputDeviceInfo. Este campo es el mismo que usa la API de DirectInput, lo que permite a las aplicaciones seguir usando su código de DirectInput existente para la enumeración de dispositivos y la recuperación de información mientras migran la lectura de entrada y otra funcionalidad a GameInput. Para obtener más detalles, consulte la [Guía de portabilidad de GameInput](/build/core-features/common/input/porting/input-porting).

### ¿Qué hace el servicio de GameInput?

El servicio de GameInput es responsable de arbitrar el acceso a los dispositivos de entrada del sistema y de proporcionar capas útiles de compatibilidad y abstracción para otras aplicaciones. Entre otras cosas, el servicio de GameInput:

* Controla el filtrado y la sincronización de la entrada
* Proporciona actualizaciones de la plataforma y mejoras de los controladores de dispositivo
* Media el acceso a los dispositivos de entrada entre las instancias cliente de GameInput

El instalador garantiza que el entorno de ejecución esté registrado correctamente y que el servicio esté configurado de forma adecuada para un rendimiento óptimo.

### ¿Puedo llamar a GameInput desde mi subproceso de representación?

Sí, casi todas las funciones de GameInput son seguras para contextos sensibles al tiempo, como los subprocesos de representación. La principal excepción es `GameInputCreate`, a la que debe llamar durante la inicialización de la aplicación.

<a id="seeAlsoSection" />

## Consulte también

[Introducción a GameInput](/build/core-features/common/input/overviews/input-overview)

[Control de versiones de la API de GameInput](/build/core-features/common/input/overviews/input-versioning)

[Portabilidad de XInput a GameInput](/build/core-features/common/input/porting/input-porting-xinput)


## Related topics

- [Entrada](/es/build/core-features/common/input/gc-input-toc.md)
- [Preguntas frecuentes sobre XBOX Game Publisher Insights](/es/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq.md)
- [Preguntas frecuentes sobre Economy versión 2 (V2)](/es/services/playfab/economy-monetization/economy-v2/faq.md)
- [Preguntas frecuentes sobre los vuelos del XBOX Insider Program](/es/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-xbox-flighting-faq.md)
- [Información general](/es/build/core-features/common/input/overviews/index.md)
