XGameStreamingShowTouchControlLayoutOnClient
Muestra el conjunto solicitado de controles táctiles en un único cliente.Sintaxis
Parámetros
client _In_Tipo: XGameStreamingClientId El dispositivo cliente de streaming en el que se mostrarán los controles táctiles. layout _In_opt_z_
Tipo: char* Nombre del diseño de controles táctiles que se va a mostrar, o nullptr para mostrar el diseño predeterminado. El identificador del diseño de controles táctiles que se debe mostrar en el dispositivo cliente de streaming. Los identificadores de diseño son específicos de cada título y se corresponden con los identificadores de los diseños que se proporcionan a XBOX Game Streaming como parte del Touch Adaptation Kit. Se espera que esta cadena esté codificada en UTF-8. Si se proporciona
nullptr, se mostrará el conjunto predeterminado de controles táctiles.
Cualquier cadena que no se corresponda con un identificador de diseño de controles táctiles del título no cambiará el estado de los controles táctiles en el dispositivo cliente, que permanecerá sin cambios. La Content Test Application puede proporcionar un diagnóstico en estos casos.
Valor devuelto
Tipo: voidComentarios
Esta API solicita que el cliente de streaming de juegos especificado muestre un diseño de controles táctiles específico en el dispositivo cliente del jugador. Si el jugador no está transmitiendo el juego, o si el cliente de streaming no tiene la funcionalidad táctil habilitada, esta función no hace nada. Si el jugador está usando un mando físico en lugar de controles táctiles, esta función no forzará la aparición de los controles táctiles en su dispositivo. En su lugar, el cliente usará el último diseño solicitado la próxima vez que el jugador empiece a usar controles táctiles. Puede considerar esta función como una sugerencia para el dispositivo cliente, que le indica qué diseño de controles táctiles es el más adecuado para el estado actual del juego si el jugador está usando controles táctiles. El dispositivo cliente administrará entonces cuándo es mejor mostrar esos controles en la pantalla del jugador. Cada llamada aXGameStreamingShowTouchControlLayoutOnClient da como resultado el envío de un mensaje a través de la red, por lo que no se debe llamar en cada fotograma. En su lugar, llame a esta API solo cuando el juego necesite pasar de un diseño de controles táctiles a otro.
Si el juego quiere mostrar el diseño de controles táctiles en todos los dispositivos cliente de streaming conectados, considere la posibilidad de usar XGameStreamingShowTouchControlLayout en su lugar.
Ejemplos
Requisitos
Encabezado: xgamestreaming.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
XGameStreamingHideTouchControlsOnClientXGameStreamingShowTouchControlLayout
XGameStreaming
