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

# XGameStreamingHideTouchControlsOnClient

> XGameStreamingHideTouchControlsOnClient

# XGameStreamingHideTouchControlsOnClient

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

## 구문

```cpp theme={null}
void XGameStreamingHideTouchControlsOnClient(  
         XGameStreamingClientId client  
)  
```

### 매개 변수

*client*   \_In\_\
형식: XGameStreamingClientId

터치 컨트롤을 숨길 스트리밍 클라이언트 장치입니다.

### 반환 값

형식: void

## 설명

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

지정한 터치 컨트롤 레이아웃을 표시하려면 [XGameStreamingShowTouchControlLayoutOnClient](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient)를 호출하세요.

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

**모든** 연결된 스트리밍 클라이언트 장치에서 터치 컨트롤 레이아웃을 숨겨야 하는 경우에는 대신 [XGameStreamingHideTouchControls](/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols)를 사용하는 것을 고려하세요.

## 예제

```C++ theme={null}
void OnShowMenu(XGameStreamingClientId client)
{
    // This game has native touch support for the menu system, so hide touch overlay controls
    XGameStreamingHideTouchControlsOnClient(client);
}

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

## 요구 사항

**헤더:** xgamestreaming.h

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

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

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


## Related topics

- [XGameStreamingHideTouchControls](/ko/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols.md)
- [XGameStreamingShowTouchControlLayoutOnClient](/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient.md)
- [XGameStreaming](/ko/reference/system/xgamestreaming/xgamestreaming_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameStreamingShowTouchControlLayout](/ko/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)
