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 con su juego para usar una versión de la API más reciente que la que admite su GDK.
Versiones de la API compatibles
En la siguiente tabla se muestran las versiones de la API disponibles para cada versión del GDK.
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 a su proyecto, y compile y vincule con sus encabezados yGameInput.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.
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.
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:- Agregue la versión 4.0 o posterior del paquete NuGet Microsoft.GameInput a su proyecto, y compile y vincule con sus encabezados y
GameInput.lib. - Implemente
GameInputRedist.dlldel directorionative\bin\xbox\del paquete en el mismo directorio que el ejecutable de su juego.
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.
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.
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 conE_NOINTERFACE. Esto se aplica tanto a GameInputCreate 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.
Consulte también
GameInput para PC y consola con NuGetCarga local (sideloading) de GameInput
Control de versiones de la API de GameInput
Uso de varias versiones de la API de GameInput en una aplicación
GameInputInitialize
