Skip to main content

XGameStreamingGetTouchBundleVersion

Obtiene la versión del paquete de adaptación táctil que se está utilizando actualmente en el dispositivo especificado.

Sintaxis

Parámetros

client   _In_
Tipo: XGameStreamingClientId
El cliente de streaming que se está consultando. version   _Out_opt_
Tipo: XVersion*
El número de versión del paquete que se está usando actualmente en el cliente especificado. Si no se especifica ningún número de versión en el paquete, se devolverá 0.0.0.0. versionNameSize   _In_
Tipo: size_t
El tamaño máximo en bytes del versionName que se devolverá. El tamaño que se especifica se puede obtener llamando a XGameStreamingGetTouchBundleVersionNameSize. versionName   _Out_writes_opt_z_
Tipo: char*
El nombre de versión del paquete que se está usando actualmente en el cliente especificado. Si no se especifica ningún nombre de versión en el paquete, se devolverá null.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error.

Posibles errores

Para obtener una lista de códigos de error, consulte Códigos de error.

Comentarios

Los diseños táctiles que se presentan al jugador durante el streaming de juegos usan diseños predefinidos que se cargan en Microsoft como parte de un paquete de adaptación táctil. XGameStreamingGetTouchBundleVersion permite al juego tomar decisiones en tiempo de ejecución en función del conjunto de controles táctiles que se están utilizando en un cliente determinado. Algunos ejemplos de dónde podría utilizarse:
  • Para quitar un elemento del HUD si el jugador usa la entrada táctil y el elemento está disponible a través de los controles de superposición táctil.
  • Para decidir qué sugerencias gráficas mostrar en el juego en función de los diseños táctiles que se mostrarán.
El valor de version será único por cada versión que se cargue en el servicio. Cada actualización requerirá un nuevo número de versión. El versionName se puede usar para proporcionar una versión semántica (por ejemplo, este es un conjunto de diseños que admiten DLC2) en lugar de bloquearse a un número de versión específico. Por ejemplo, si su sistema de compilación asigna automáticamente los números de versión, puede resultar difícil para el código del juego conocer el número de versión exacto de los paquetes de adaptación táctil que aparecerán en tiempo de ejecución. Para permitir que el código detecte la presencia de un paquete sin tener que conocer su versión exacta, puede optar por usar un nombre de versión en lugar de hacer comparaciones basadas en un número de versión.

Ejemplo

Requisitos

Encabezado: XGameStreaming.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XGameStreaming
XGameStreamingGetTouchBundleVersionNameSize
Última modificación el 28 de agosto de 2026