> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GameInput en consolas XBOX > Describe qué versiones de la API de GameInput están disponibles en las consolas XBOX para cada versión del GDK y cómo usar versiones más recientes con NuGet y la carga local (sideloading). En las consolas XBOX, el entorno de ejecución de GameInput forma parte del Microsoft Game Development Kit (GDK). Se incluye en el archivo del Game OS (`GameOs.xvd`) del GDK que se empaqueta con su título. Las versiones de la API de GameInput que su juego puede usar en tiempo de ejecución dependen de la versión del GDK, del encabezado y la biblioteca de GameInput con los que compila y de si implementa un entorno de ejecución de GameInput con su juego. Hay dos formas de usar una versión más reciente de la API de GameInput en XBOX: * **Actualizar el GDK.** Cada versión del GDK incluye un entorno de ejecución de GameInput que admite un conjunto específico de versiones de la API. * **Cargar localmente el entorno de ejecución de GameInput.** Implemente el entorno de ejecución de GameInput del paquete NuGet [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput) con su juego para usar una versión de la API más reciente que la que admite su GDK. En ambos casos, debe compilar con los encabezados y la biblioteca del paquete NuGet para usar la API v1 o posterior. ## Versiones de la API compatibles En la siguiente tabla se muestran las versiones de la API disponibles para cada versión del GDK. | Versión del GDK | Encabezado y biblioteca del GDK | Encabezado y biblioteca de NuGet | Encabezado y biblioteca de NuGet, y entorno de ejecución cargado localmente | | - | - | - | - | | Anterior al GDK de octubre de 2025 (2510) | v0 | No compatible | No compatible | | GDK de octubre de 2025 (2510) y versiones posteriores, antes del GDK de octubre de 2026 | v0 | De v0 a v3 | De v0 a v4 | | GDK de octubre de 2026 (2610) y posteriores | v0 | De v0 a v4 | De v0 a v4 | Los encabezados y la biblioteca del GDK solo proporcionan la API v0, independientemente de la versión del GDK. El paquete NuGet no es compatible con las versiones del GDK anteriores al GDK de octubre de 2025. ## Uso de la API v1 o posterior Para usar la API v1 o posterior, agregue el paquete NuGet [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput) a su proyecto, y compile y vincule con sus encabezados y `GameInput.lib` en lugar de los del GDK. La versión principal del paquete NuGet coincide con la versión más alta de la API que definen sus encabezados. Por ejemplo, el paquete 4.x incluye la API v4. Para obtener más información, consulte [GameInput para PC y consola con NuGet](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-nuget.md). No es necesario instalar nada más en la consola. Si solo vincula con `GameInput.lib` del paquete NuGet, su juego usa el entorno de ejecución de GameInput incluido con el GDK, y las versiones de la API que admite el entorno de ejecución están limitadas por la versión del GDK, como se muestra en la tabla [Versiones de la API compatibles](#supported-api-versions). ## Uso de la API v4 con un GDK anterior Para usar la API v4 con una versión del GDK comprendida entre el GDK de octubre de 2025 y el GDK de octubre de 2026 (sin incluir este último), cargue localmente el entorno de ejecución de GameInput: 1. Agregue la versión 4.0 o posterior del paquete NuGet [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput) a su proyecto, y compile y vincule con sus encabezados y `GameInput.lib`. 2. Implemente `GameInputRedist.dll` del directorio `native\bin\xbox\` del paquete en el mismo directorio que el ejecutable de su juego. Vincular con `GameInput.lib` del paquete NuGet no es suficiente por sí solo. Sin el entorno de ejecución cargado localmente, su juego usa el entorno de ejecución del GDK, que no admite la API v4 antes del GDK de octubre de 2026. En ese caso, las solicitudes de la API v4 producen un error con `E_NOINTERFACE`, y las versiones de la API de v0 a v3 siguen funcionando. > [!WARNING] > > El paquete NuGet contiene copias independientes de `GameInputRedist.dll` para PC y XBOX. Implemente con su juego de XBOX solo la copia de `native\bin\xbox\`. Para obtener más información, consulte [Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md). ## Cómo se elige el entorno de ejecución La carga local del entorno de ejecución de GameInput se admite tanto en consolas XBOX como en PC. En XBOX, cuando su juego crea GameInput por primera vez, `GameInput.lib` del paquete NuGet compara el entorno de ejecución de GameInput del Game OS empaquetado con su título con el entorno de ejecución cargado localmente, si se ha implementado uno, y usa el entorno de ejecución con la versión más alta. Como resultado: * Un entorno de ejecución cargado localmente que sea más reciente que el entorno de ejecución del GDK pone a disposición de su juego versiones de la API y correcciones más recientes. * Cuando su juego pasa a una versión del GDK que incluye un entorno de ejecución más reciente que el cargado localmente, su juego usa el entorno de ejecución del GDK. Puede seguir implementando el entorno de ejecución cargado localmente, o quitarlo cuando ya no sea más reciente que el entorno de ejecución del GDK. Las limitaciones de la carga local específicas de PC, como las relativas a la entrada en segundo plano y al foco de entrada, no se aplican en las consolas XBOX. Para obtener más información sobre la carga local en ambas plataformas, consulte [Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md). ## Comprobar qué versión de la API está disponible Si su juego solicita una versión de la API que el entorno de ejecución no admite, GameInput produce un error con `E_NOINTERFACE`. Esto se aplica tanto a [GameInputCreate](https://docs.xbox.com/es/reference/input/gameinput/functions/gameinputcreate.md) como a `QueryInterface`. Si su juego puede ejecutarse sin la versión más reciente de la API, compruebe este error y recurra a las características de una versión anterior. ```cpp theme={null} #include GameInput::v4::IGameInput* gameInput = nullptr; HRESULT hr = GameInput::v4::GameInputCreate(&gameInput); if (hr == E_NOINTERFACE) { // The GameInput runtime doesn't support API v4. Deploy the sideloaded // runtime with your game, or use an earlier API version. } ``` Para usar más de una versión de la API en su juego, como código v0 junto con código v4, consulte [Uso de varias versiones de la API de GameInput en una aplicación](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-version-interop.md). ## Consulte también [GameInput para PC y consola con NuGet](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-nuget.md)\ [Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md)\ [Control de versiones de la API de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-versioning.md)\ [Uso de varias versiones de la API de GameInput en una aplicación](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-version-interop.md)\ [GameInputInitialize](https://docs.xbox.com/es/reference/input/gameinput/functions/gameinputinitialize.md) ## Related topics - [Preguntas más frecuentes sobre GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-faq.md) - [GameInput para PC y consola con NuGet](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-nuget.md) - [Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md) - [Control de versiones de la API de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-versioning.md) - [Uso de varias versiones de la API de GameInput en una aplicación](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-version-interop.md)