Skip to main content

XGameStreamingShowTouchControlLayoutOnClient

Mostra o conjunto solicitado de controles por toque em um único cliente.

Sintaxe

Parâmetros

client   _In_
Tipo: XGameStreamingClientId
O dispositivo cliente de streaming no qual mostrar os controles por toque. layout   _In_opt_z_
Tipo: char*
Nome do layout de controles por toque a ser exibido ou nullptr para exibir o layout padrão. A ID do layout de controles por toque que deve ser exibido no dispositivo cliente de streaming. As IDs de layout são específicas do título e correspondem às IDs dos layouts fornecidos ao XBOX Game Streaming como parte do Touch Adaptation Kit. Espera-se que essa cadeia de caracteres esteja codificada em UTF-8. Se nullptr for fornecido, o conjunto padrão de controles por toque será mostrado. Qualquer cadeia de caracteres que não corresponda a uma ID de layout de controles por toque do título não alterará o estado dos controles por toque no dispositivo cliente, que permanecerá inalterado. O Content Test Application pode fornecer um diagnóstico nesses casos.

Valor retornado

Tipo: void

Comentários

Esta API solicita que o cliente de game streaming especificado exiba um layout de controles por toque específico no dispositivo cliente do jogador. Se o jogador não estiver fazendo streaming do jogo, ou se o cliente de streaming não tiver toque habilitado, esta função não fará nada. Se o jogador estiver usando um controle físico em vez de controles por toque, esta função não forçará a exibição dos controles por toque no dispositivo dele. Em vez disso, o cliente usará o último layout solicitado na próxima vez que o jogador começar a usar controles por toque. Você pode pensar nesta função como uma dica para o dispositivo cliente, que informa qual layout de controles por toque é o mais apropriado para o estado atual do jogo se o jogador estiver usando controles por toque. O dispositivo cliente então gerenciará o melhor momento para colocar esses controles na tela do jogador. Cada chamada para XGameStreamingShowTouchControlLayoutOnClient resulta no envio de uma mensagem pela rede, portanto, ela não deve ser chamada a cada quadro. Em vez disso, chame esta API somente quando o jogo precisar fazer a transição entre diferentes layouts de controles por toque. Se o jogo quiser mostrar o layout de controles por toque em todos os dispositivos cliente de streaming conectados, considere usar XGameStreamingShowTouchControlLayout.

Exemplos

Requisitos

Cabeçalho: xgamestreaming.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

XGameStreamingHideTouchControlsOnClient
XGameStreamingShowTouchControlLayout
XGameStreaming
Last modified on October 6, 2026