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: voidComentá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 paraXGameStreamingShowTouchControlLayoutOnClient 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 SeriesConfira também
XGameStreamingHideTouchControlsOnClientXGameStreamingShowTouchControlLayout
XGameStreaming
