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

# XGameUI (API 콘텐츠)

> XGameUI

# XGameUI

XboxGameUI API를 사용하면 타이틀에서 XBOX One 콘솔에 미리 정의된 사용자 인터페이스 표시를 불러올 수 있습니다. 이러한 미리 정의된 UI에는 사용자 선택기, 프로필 카드, 게임 초대 등의 인터페이스가 포함됩니다.

## 함수

| 함수 | 설명 |
| - | - |
| [XGameUiSetNotificationPositionHint](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetnotificationpositionhint.md) | 현재 타이틀에 표시할 토스트 알림의 기본 위치를 설정합니다. |
| [XGameUiShowAchievementsAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowachievementsasync.md) | 지정된 타이틀에 대해 요청 플레이어의 실적을 표시하는 UI를 표시합니다. |
| [XGameUiShowAchievementsResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowachievementsresult.md) | [XGameUiShowAchievementsAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowachievementsasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowErrorDialogAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowerrordialogasync.md) | 지정된 오류 코드에 대해 서비스에서 정의한 오류 문자열이 포함된 오류 대화 상자 UI를 표시합니다. |
| [XGameUiShowErrorDialogResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowerrordialogresult.md) | [XGameUiShowErrorDialogAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowerrordialogasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowMessageDialogAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmessagedialogasync.md) | 사용자 지정 가능한 메시지 대화 상자에 대한 UI를 표시합니다. |
| [XGameUiShowMessageDialogResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmessagedialogresult.md) | [XGameUiShowMessageDialogAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmessagedialogasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowMultiplayerActivityGameInviteAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync.md) | TBD |
| [XGameUiShowMultiplayerActivityGameInviteResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteresult.md) | TBD |
| [XGameUiShowPlayerPickerAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerasync.md) | 게임을 플레이 중인 사람이 표시된 사람 목록에서 플레이어를 선택할 수 있는 선택기 UI를 표시합니다. |
| [XGameUiShowPlayerPickerResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerresult.md) | [XGameUiShowPlayerPickerAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowPlayerPickerResultCount](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount.md) | [XGameUiShowPlayerPickerAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickerasync.md) 호출의 결과 개수를 가져옵니다. |
| [XGameUiShowPlayerProfileCardAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerprofilecardasync.md) | 지정된 플레이어의 프로필 카드 UI를 표시합니다. |
| [XGameUiShowPlayerProfileCardResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerprofilecardresult.md) | [XGameUiShowPlayerProfileCardAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerprofilecardasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowSendGameInviteAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteasync.md) | 선택된 플레이어의 친구 목록 및 추천 친구 목록에서 채워진 선택기 UI를 표시합니다. |
| [XGameUiShowSendGameInviteResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteresult.md) | [XGameUIShowSendGameInviteAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowStateShareAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowstateshareasync.md) | 다른 플레이어와 상태를 공유하기 위한 UI를 표시합니다 |
| [XGameUiShowStateShareResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowstateshareresult.md) | [XGameUIShowStateShareAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowstateshareasync.md) 호출의 결과를 가져옵니다 |
| [XGameUiShowTextEntryAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowtextentryasync.md) | 사용자가 정보를 입력할 수 있는 텍스트 입력 UI를 표시합니다. |
| [XGameUiShowTextEntryResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowtextentryresult.md) | [XGameUiShowTextEntryAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowtextentryasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowTextEntryResultSize](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowtextentryresultsize.md) | [XGameUiShowTextEntryAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowtextentryasync.md) 호출의 반환 버퍼 크기를 가져옵니다. |
| [XGameUiShowWebAuthenticationAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowwebauthenticationasync.md) | 사용자가 실행 중인 타이틀에 자격 증명을 직접 제공하지 않고도 외부 웹 사이트 및 서비스에 대한 액세스를 위임할 수 있는 웹 UI를 표시합니다. |
| [XGameUiShowWebAuthenticationResult](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowwebauthenticationresult.md) | [XGameUiShowWebAuthenticationAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowwebauthenticationasync.md) 호출의 결과를 가져옵니다. |
| [XGameUiShowWebAuthenticationResultSize](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowwebauthenticationresultsize.md) | 인증 요청의 결과를 포함하는 데 필요한 버퍼의 크기를 검색합니다. |
| [XGameUiShowWebAuthenticationWithOptionsAsync](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowwebauthenticationwithoptionsasync.md) | 사용자가 실행 중인 타이틀에 자격 증명을 직접 제공하지 않고도 외부 웹 사이트 및 서비스에 대한 액세스를 위임할 수 있는, 전체 화면으로 표시할 수 있는 옵션이 있는 웹 UI를 표시합니다. |
| [XGameUiTextEntryClose](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentryclose.md) | 가상 키보드를 닫고 해당 리소스를 해제합니다. |
| [XGameUiTextEntryGetExtents](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentrygetextents.md) | 가상 키보드의 화면 범위를 가져옵니다. |
| [XGameUiTextEntryGetState](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentrygetstate.md) | 열린 가상 키보드의 현재 상태를 가져옵니다. |
| [XGameUiTextEntryOpen](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentryopen.md) | 타이틀이 텍스트 렌더링을 담당하는 가상 키보드를 엽니다. |
| [XGameUiTextEntryUpdatePositionHint](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentryupdatepositionhint.md) | 가상 키보드의 기본 위치 지정을 업데이트합니다. |
| [XGameUiTextEntryUpdateVisibility](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentryupdatevisibility.md) | 전체 가상 키보드를 표시할지, 후보 목록만 표시할지를 업데이트합니다. |
| [XGameUISetUICallbacks](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetuicallbacks.md) | 개발자가 정의한 UI 콜백을 설정합니다. |
| [XGameUISetMessageDialogUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetmessagedialoguiresponse.md) | XGameUiShowMessageDialogResult에서 반환할 결과 XGameUiMessageDialogButton 값을 설정합니다. |
| [XGameUISetPlayerPickerUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetplayerpickeruiresponse.md) | XGameUiShowPlayerPickerResultCount 및 XGameUiShowPlayerPickerResult에서 반환할 결과를 설정합니다. |
| [XGameUISetTextEntryUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisettextentryuiresponse.md) | XGameUiShowTextEntryAsync에서 반환할 결과 텍스트 길이와 텍스트를 설정합니다. |
| [XGameUISetPlayerProfileCardUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetplayerprofilecarduiresponse.md) | XGameUiShowPlayerProfileCardAsync 호출을 완료합니다. |
| [XGameUISetSendGameInviteUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse.md) | XGameUiShowSendGameInviteAsync 호출을 완료합니다. |
| [XGameUISetAchievementsUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetachievementsuiresponse.md) | XGameUiShowAchievementsAsync 호출을 완료합니다. |
| [XGameUISetMultiplayerActivityGameInviteUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuisetmultiplayeractivitygameinviteuiresponse.md) | XGameUiShowMultiplayerActivityGameInviteAsync 호출을 완료합니다. |
| [XGameUISetErrorDialogUIResponse](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuiseterrordialoguiresponse.md) | XGameUiShowErrorDialogAsync 호출을 완료합니다. |
| [XGameUIShowPlayerProfileCardUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerprofilecarduicallback.md) | XGameUiShowPlayerProfileCardAsync 콜백의 시그니처입니다. |
| [XGameUIShowPlayerPickerUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowplayerpickeruicallback.md) | XGameUiShowPlayerPickerAsync 콜백의 시그니처입니다. |
| [XGameUIShowSendGameInviteUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback.md) | XGameUiShowSendGameInviteAsync 콜백의 시그니처입니다. |
| [XGameUIShowAchievementsUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowachievementsuicallback.md) | XGameUiShowAchievementsAsync 콜백의 시그니처입니다. |
| [XGameUIShowMultiplayerActivityGameInviteUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteuicallback.md) | XGameUiShowMultiplayerActivityGameInviteAsync 콜백의 시그니처입니다. |
| [XGameUIShowMessageDialogUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowmessagedialoguicallback.md) | XGameUiShowMessageDialogAsync 콜백의 시그니처입니다. |
| [XGameUIShowErrorDialogUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowerrordialoguicallback.md) | XGameUiShowErrorDialogAsync 콜백의 시그니처입니다. |
| [XGameUIShowTextEntryUICallback](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuishowtextentryuicallback.md) | XGameUiShowTextEntryAsync 콜백의 시그니처입니다. |

## 구조체

| 구조체 | 설명 |
| - | - |
| [XGameUiWebAuthenticationResultData](https://docs.xbox.com/ko/reference/system/xgameui/structs/xgameuiwebauthenticationresultdata.md) | 웹 인증 요청의 응답을 포함합니다. |
| [XGameUiTextEntryExtents](https://docs.xbox.com/ko/reference/system/xgameui/structs/xgameuitextentryextents.md) | 가상 키보드의 상대적 위치를 설명합니다. |
| [XGameUiTextEntryOptions](https://docs.xbox.com/ko/reference/system/xgameui/structs/xgameuitextentryoptions.md) | XGameUiTextEntryOpen에서 사용하는 가상 키보드의 초기 옵션 집합입니다. |
| [XGameUICallbackHandle](https://docs.xbox.com/ko/reference/system/xgameui/structs/xgameuicallbackhandle.md) | XGameUi 콜백 호출과 연결된 핸들입니다. Set\*Response API 호출에서 사용됩니다. |
| [XGameUIPlayerPickerInfo](https://docs.xbox.com/ko/reference/system/xgameui/structs/xgameuiplayerpickerinfo.md) | 개발자의 사용자 지정 플레이어 선택기 UI에서 사용할 사용자 정보를 캡슐화하는 구조체입니다. |
| [XGameUIUICallbacks](https://docs.xbox.com/ko/reference/system/xgameui/structs/xgameuiuicallbacks.md) | 개발자가 정의한 UI 콜백에 대한 포인터를 포함하는 구조체입니다. |

## 열거형

| 열거형 | 설명 |
| - | - |
| [XGameUiMessageDialogButton](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuimessagedialogbutton.md) | 사용자 지정 가능한 메시지 대화 상자의 버튼을 열거합니다. |
| [XGameUiNotificationPositionHint](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuinotificationpositionhint.md) | 현재 타이틀에 표시할 토스트 알림의 기본 위치를 설명합니다. |
| [XGameUiTextEntryChangeTypeFlags](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuitextentrychangetypeflags.md) | XGameUiTextEntryGetState에 대한 마지막 호출 이후 변경된 사항을 나타내는 플래그입니다. |
| [XGameUiTextEntryInputScope](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuitextentryinputscope.md) | 텍스트 입력에서 예상되는 정보 유형을 열거합니다. |
| [XGameUiTextEntryPositionHint](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuitextentrypositionhint.md) | 가상 키보드를 배치할 가장 좋은 위치에 대한 힌트입니다. |
| [XGameUiTextEntryVisibilityFlags](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuitextentryvisibilityflags.md) | 가상 키보드의 표시 상태를 나타내는 플래그입니다. |
| [XGameUiWebAuthenticationOptions](https://docs.xbox.com/ko/reference/system/xgameui/enums/xgameuiwebauthenticationoptions.md) | 웹 인증 플로우를 표시하기 위한 옵션을 열거합니다. |

## 오류 코드

다음 오류 코드는 XGameUI API에서 반환될 수 있습니다. 전체 목록은 [오류 코드](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하세요.

| 코드 | 값 | 설명 |
| - | - | - |
| E\_GAMEUI\_TEXTENTRY\_NOT\_SHOWN | — | XGameUiTextEntryHandle이 유효하지 않습니다. 먼저 [XGameUiTextEntryOpen](https://docs.xbox.com/ko/reference/system/xgameui/functions/xgameuitextentryopen.md)을 호출해야 할 가능성이 큽니다. |

## 개념 문서

* [비동기 프로그래밍 설계 목표 및 개선 사항](https://docs.xbox.com/ko/build/core-features/common/async/async-whitepaper.md)
* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Microsoft Game Development Kit란?](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/introduction)
* [Unity 프로젝트에서 GDK API용 C# 래퍼 사용](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/get-started-with-unity-pc/features/gdk-unity-api-wrappers)

## 함께 보기

[시스템 API 참조](https://docs.xbox.com/ko/reference/system/gc-reference-system-toc.md)


## Related topics

- [XGame (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgame/xgame_members.md)
- [API 참조(콘텐츠)](https://docs.xbox.com/ko/reference/gc-reference-toc.md)
- [XGameSave (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgamesave/xgamesave_members.md)
- [XGameActivation (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgameactivation/xgameactivation_members.md)
- [XGameEvent (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/xgameevent/xgameevent_members.md)