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

# XGameStreamingHideTouchControls

> XGameStreamingHideTouchControls

# XGameStreamingHideTouchControls

연결된 모든 스트리밍 클라이언트 장치에서 터치 레이아웃이 표시되고 있는 경우 이를 숨기도록 요청합니다.

## 구문

```cpp theme={null}
void XGameStreamingHideTouchControls();
```

### 반환 값

형식: void

## 설명

이 API는 연결된 모든 게임 스트리밍 클라이언트에서 표시 중인 터치 오버레이 컨트롤을 제거하도록 요청합니다. 플레이어가 게임을 스트리밍하고 있지 않거나 터치 오버레이 컨트롤이 표시되지 않는 장치로 스트리밍 중인 경우, 이 함수는 아무 작업도 수행하지 않습니다.

특정 터치 컨트롤 레이아웃을 표시하려면 [XGameStreamingShowTouchControlLayout](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)을 호출하세요.

`XGameStreamingHideTouchControls`를 호출할 때마다 네트워크를 통해 메시지가 전송되므로 매 프레임마다 호출해서는 안 됩니다. 대신 게임에서 화면에 표시된 터치 컨트롤 상태를 벗어나야 할 때에만 이 API를 호출하세요.

**특정** 연결된 스트리밍 클라이언트 장치에서만 터치 컨트롤 레이아웃을 숨겨야 하는 경우에는 대신 [XGameStreamingHideTouchControlsOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient.md)를 사용하는 것을 고려하세요.

## 예제

```cpp theme={null}
void OnShowMenu()
{
    // This game has native touch support for the menu system, so hide touch overlay controls
    XGameStreamingHideTouchControls();
}

void OnDismissMenu()
{
    // Show the touch overlay controls which were previously on the screen before we hid them
    // due to bringing up the menu.
    XGameStreamingShowTouchControlLayout(m_currentTouchLayout);
}
```

## 요구 사항

**헤더:** xgamestreaming.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XGameStreamingShowTouchControlLayout](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)\
[XGameStreamingHideTouchControlsOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient.md)\
[XGameStreaming](https://docs.xbox.com/ko/reference/system/xgamestreaming/xgamestreaming_members.md#TouchAdaptation)


## Related topics

- [XGameStreamingHideTouchControlsOnClient](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient.md)
- [XGameStreamingShowTouchControlLayout](https://docs.xbox.com/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)
- [게임 상태에 따라 터치 컨트롤 레이아웃 변경](https://docs.xbox.com/ko/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state.md)
- [XGameStreaming (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgamestreaming/xgamestreaming_members.md)
- [Unity 프로젝트에서 GDK API용 C# 래퍼 사용](https://docs.xbox.com/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)