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.
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 SeriesConsulte también
XGameStreamingXGameStreamingGetTouchBundleVersionNameSize
