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

# 창 표시 모드와 title-callable UI 다이얼로그

> title-callable UI(TCUI) 다이얼로그가 올바르게 렌더링되고 포커스 손실 시 Gaming Runtime이 최소화를 방지하도록 PC 게임 창 표시 모드를 구성하세요.

이 항목은 PC에서 창 표시 모드를 다루고 title-callable UI(TCUI) 다이얼로그를 성공적으로 표시하는 데 필요한 특별한 고려 사항을 다룹니다.

TCUI를 표시할 수 있는 API를 호출하기 전에 게임 창이 표시되어 있는지 확인하는 것이 권장됩니다. 또한 게임 창은 Full Screen Exclusive가 아니라 Full Screen Windowed/Borderless 또는 Windowed/Non-Maximized 모드를 사용해야 합니다.

게임은 커스텀 앱/게임 해상도가 아닌 네이티브 디스플레이 해상도로 실행되어야 합니다. 일부 기술(예: DirectX 9)은 TCUI 다이얼로그가 표시될 때 해상도 변경을 원활히 처리하지 못합니다.

이 외에도 일부 미들웨어 엔진과 래퍼, DirectX 9는 표시된 TCUI 다이얼로그로 인해 포그라운드 포커스를 잃을 때 전체 화면 게임 창을 자동으로 최소화합니다. 사용자에게 바람직하지 않은 이 동작을 피하기 위해 TCUI 다이얼로그가 표시될 때 창 최소화가 명시적으로 거부됩니다. 자세한 내용은 이 항목 뒷부분의 게임 창 최소화 방지 섹션을 참조하세요.

DirectX가 아닌 그래픽 기술을 사용하는 게임 타이틀의 경우 권장 모범 사례가 다음과 같이 다릅니다.

게임 타이틀이 OpenGL 또는 Vulkan을 사용한다면 TCUI 다이얼로그가 게임 위에 렌더링되도록 하기 위해 데스크톱 소유의 창 테두리를 보여주는 “windowed” 모드가 필요합니다. 이는 비디오 카드 드라이버 구현에 따라 전체 화면 모드로 실행되는 게임이 Desktop Window Manager의 개입 없이 렌더링될 가능성이 있기 때문입니다. 이는 TCUI 다이얼로그가 게임 창 위에 표시되는 것을 막습니다.

다른 그래픽 기술의 경우 담당 XBOX 지원 담당자에게 문의하세요.

## 게임 창 최소화 방지

일부 미들웨어 엔진과 레이어링 시스템(예: Unity와 Simple DirectMedia Layer(SDL))은 표시된 TCUI 다이얼로그로 인해 포그라운드 포커스를 잃을 때 게임의 전체 화면 창을 자동으로 최소화합니다.

이 동작을 방지하기 위해 Gaming Runtime은 [CBTProc](https://learn.microsoft.com/previous-versions/windows/desktop/legacy/ms644977\(v=vs.85\))을 사용해 게임 창을 최소화하려는 모든 요청을 거부합니다. Gaming Runtime은 오버레이가 전체 화면 DirectX 게임 창 위에 렌더링될 수 있고 TCUI 다이얼로그가 보일 때만 이 패턴을 적용합니다.

또한 Gaming Runtime은 TCUI 다이얼로그를 표시하기 전에 스타일 변경 창 메시지를 가로채고 수정해 게임 창이 테두리나 제목 표시줄을 렌더링하지 않도록 합니다. [WS\_OVERLAPPEDWINDOW](https://learn.microsoft.com/windows/win32/winmsg/window-styles) 그룹의 어떤 스타일도 이전 스타일에 존재하지 않았다면 스타일 변경 시 적용되지 않습니다. 이 수정은 TCUI 다이얼로그의 수명 동안에만 구현됩니다.

## DirectX 9와 TCUI 다이얼로그 관련 고려 사항

DirectX 9 게임은 게임 창 최소화 방지(이 항목 앞부분)에서 설명한 것처럼 최소화되지 않지만, TCUI 다이얼로그가 표시될 때 여전히 포그라운드 포커스를 잃습니다. 게임은 전체 화면으로 실행 중일 때 사용자가 게임 창을 최소화하는 경우와 정확히 같은 방식으로 이 포커스 손실을 원활히 처리할 준비가 되어 있어야 합니다.

## Unity와 TCUI 다이얼로그 관련 고려 사항

TCUI 다이얼로그를 표시할 것으로 예상하는 게임에는 “Application.runInBackground”를 true로 설정하는 것이 권장됩니다.


## Related topics

- [PC 핸드헬드 개요](/ko/build/gdk-and-engines/handheld/overview.md)
- [IGameInputReading::GetControllerAxisState](/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)
- [게임에 트라이얼 구현](/ko/publishing/xstore-commerce/xstore-trials.md)
- [PC의 XStore — DRM, 라이선스 토큰, 샌드박스](/ko/publishing/xstore-commerce/xstore-pc.md)
- [Kongregate와 Unity를 사용하여 PlayFab 인증 설정하기](/ko/services/playfab/identity/player-identity/platform-specific-authentication/kongregate-unity.md)