Saltar al contenido principal
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 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. 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 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. 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:
  1. 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.
  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.
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.

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.

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 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.
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.

Consulte también

GameInput para PC y consola con NuGet
Carga 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
Última modificación el 6 de noviembre de 2026