> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingShowTouchControlLayoutOnClient

> XGameStreamingShowTouchControlLayoutOnClient

# XGameStreamingShowTouchControlLayoutOnClient

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

## Sintaxe

```cpp theme={null}
void XGameStreamingShowTouchControlLayoutOnClient(  
         XGameStreamingClientId client,  
         const char* layout  
)  
```

### 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](/pt-BR/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview). 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](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout).

## Exemplos

```C++ theme={null}
void OnGameStateChanged(GameState newState, XGameStreamingClientId client)
{
    // Toggle to the set of touch overlay controls which best match the new state of the game
    switch (newState)
    {
    case GameState::FirstPersonAction:
        XGameStreamingShowTouchControlLayoutOnClient(client, "FirstPersonAction");
        break;
    case GameState::Driving:
        XGameStreamingShowTouchControlLayoutOnClient(client, "Driving");
        break;
    case GameState::CutScene:
        // Don't show any touch overlay controls while the cut scene is rendering
        XGameStreamingHideTouchControlsOnClient(client);
        break;
    }
}
```

## 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](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols)\
[XGameStreamingShowTouchControlLayout](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout)\
[XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members#TouchAdaptation)


## Related topics

- [XGameStreamingShowTouchControlLayoutOnClient](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient.md)
- [XGameStreamingShowTouchControlLayout](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)