Skip to main content

XGameStreamingShowTouchControlLayout

Solicita que todos os dispositivos cliente de streaming conectados mostrem um layout de toque especificado.

Sintaxe

Parâmetros

layout   _In_opt_z_
Tipo: char*
Nome do layout de controles por toque a ser exibido ou nullptr para exibir o layout padrão do controle XBOX. 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 serviço 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. O Content Test Application pode fornecer um diagnóstico nesses casos.

Valor retornado

Tipo: void

Comentários

Esta API solicita que todos os clientes de game streaming atuais exibam 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 estiver fazendo streaming para um dispositivo que não tenha 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 XGameStreamingShowTouchControlLayout 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 nenhum dispositivo cliente estiver conectado quando XGameStreamingShowTouchControlLayout for chamada, quando um cliente se conectar, ele receberá o layout de controles por toque solicitado mais recentemente. Se o jogo quiser mostrar o layout de controles por toque em um dispositivo cliente de streaming conectado específico, considere usar XGameStreamingShowTouchControlLayoutOnClient.

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

XGameStreamingHideTouchControls
XGameStreamingShowTouchControlLayoutOnClient
XGameStreaming
Last modified on October 6, 2026