> ## 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.

# XGameStreamingShowTouchControlLayout

> XGameStreamingShowTouchControlLayout

# XGameStreamingShowTouchControlLayout

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

## Sintaxe

```cpp theme={null}
void XGameStreamingShowTouchControlLayout(
         const char* layout  
)  
```

## 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](/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. 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](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient).

## Exemplos

```C++ theme={null}
void OnGameStateChanged(GameState newState)
{
    // Toggle to the set of touch overlay controls which best match the new state of the game
    switch (newState)
    {
    case GameState::FirstPersonAction:
        XGameStreamingShowTouchControlLayout("FirstPersonAction");
        break;
    case GameState::Driving:
        XGameStreamingShowTouchControlLayout("Driving");
        break;
    case GameState::CutScene:
        // Don't show any touch overlay controls while the cut scene is rendering
        XGameStreamingHideTouchControls();
        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

[XGameStreamingHideTouchControls](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols)\
[XGameStreamingShowTouchControlLayoutOnClient](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient)\
[XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members#TouchAdaptation)


## Related topics

- [XGameStreamingShowTouchControlLayout](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)
- [XGameStreamingShowTouchControlLayoutOnClient](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient.md)
- [Changing Touch Control Layouts Based On Game State](/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state.md)
- [XGameStreamingShowTouchControlsWithStateUpdate](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdate.md)
- [XGameStreamingHideTouchControls](/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols.md)