> ## 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. # XGameUI > XGameUI # XGameUI XboxGameUI API를 사용하면 타이틀에서 XBOX One 콘솔에 미리 정의된 사용자 인터페이스 표시를 불러올 수 있습니다. 이러한 미리 정의된 UI에는 사용자 선택기, 프로필 카드, 게임 초대 등의 인터페이스가 포함됩니다. ## 함수 | 함수 | 설명 | | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | [XGameUiSetNotificationPositionHint](/reference/system/xgameui/functions/xgameuisetnotificationpositionhint) | 현재 타이틀에 표시할 토스트 알림의 기본 위치를 설정합니다. | | [XGameUiShowAchievementsAsync](/reference/system/xgameui/functions/xgameuishowachievementsasync) | 지정된 타이틀에 대해 요청 플레이어의 실적을 표시하는 UI를 표시합니다. | | [XGameUiShowAchievementsResult](/reference/system/xgameui/functions/xgameuishowachievementsresult) | [XGameUiShowAchievementsAsync](/reference/system/xgameui/functions/xgameuishowachievementsasync) 호출의 결과를 가져옵니다. | | [XGameUiShowErrorDialogAsync](/reference/system/xgameui/functions/xgameuishowerrordialogasync) | 지정된 오류 코드에 대해 서비스에서 정의한 오류 문자열이 포함된 오류 대화 상자 UI를 표시합니다. | | [XGameUiShowErrorDialogResult](/reference/system/xgameui/functions/xgameuishowerrordialogresult) | [XGameUiShowErrorDialogAsync](/reference/system/xgameui/functions/xgameuishowerrordialogasync) 호출의 결과를 가져옵니다. | | [XGameUiShowMessageDialogAsync](/reference/system/xgameui/functions/xgameuishowmessagedialogasync) | 사용자 지정 가능한 메시지 대화 상자에 대한 UI를 표시합니다. | | [XGameUiShowMessageDialogResult](/reference/system/xgameui/functions/xgameuishowmessagedialogresult) | [XGameUiShowMessageDialogAsync](/reference/system/xgameui/functions/xgameuishowmessagedialogasync) 호출의 결과를 가져옵니다. | | [XGameUiShowMultiplayerActivityGameInviteAsync](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync) | TBD | | [XGameUiShowMultiplayerActivityGameInviteResult](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteresult) | TBD | | [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync) | 게임을 플레이 중인 사람이 표시된 사람 목록에서 플레이어를 선택할 수 있는 선택기 UI를 표시합니다. | | [XGameUiShowPlayerPickerResult](/reference/system/xgameui/functions/xgameuishowplayerpickerresult) | [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync) 호출의 결과를 가져옵니다. | | [XGameUiShowPlayerPickerResultCount](/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount) | [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync) 호출의 결과 개수를 가져옵니다. | | [XGameUiShowPlayerProfileCardAsync](/reference/system/xgameui/functions/xgameuishowplayerprofilecardasync) | 지정된 플레이어의 프로필 카드 UI를 표시합니다. | | [XGameUiShowPlayerProfileCardResult](/reference/system/xgameui/functions/xgameuishowplayerprofilecardresult) | [XGameUiShowPlayerProfileCardAsync](/reference/system/xgameui/functions/xgameuishowplayerprofilecardasync) 호출의 결과를 가져옵니다. | | [XGameUiShowSendGameInviteAsync](/reference/system/xgameui/functions/xgameuishowsendgameinviteasync) | 선택된 플레이어의 친구 목록 및 추천 친구 목록에서 채워진 선택기 UI를 표시합니다. | | [XGameUiShowSendGameInviteResult](/reference/system/xgameui/functions/xgameuishowsendgameinviteresult) | [XGameUIShowSendGameInviteAsync](/reference/system/xgameui/functions/xgameuishowsendgameinviteasync) 호출의 결과를 가져옵니다. | | [XGameUiShowStateShareAsync](/reference/system/xgameui/functions/xgameuishowstateshareasync) | 다른 플레이어와 상태를 공유하기 위한 UI를 표시합니다 | | [XGameUiShowStateShareResult](/reference/system/xgameui/functions/xgameuishowstateshareresult) | [XGameUIShowStateShareAsync](/reference/system/xgameui/functions/xgameuishowstateshareasync) 호출의 결과를 가져옵니다 | | [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync) | 사용자가 정보를 입력할 수 있는 텍스트 입력 UI를 표시합니다. | | [XGameUiShowTextEntryResult](/reference/system/xgameui/functions/xgameuishowtextentryresult) | [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync) 호출의 결과를 가져옵니다. | | [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize) | [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync) 호출의 반환 버퍼 크기를 가져옵니다. | | [XGameUiShowWebAuthenticationAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationasync) | 사용자가 실행 중인 타이틀에 자격 증명을 직접 제공하지 않고도 외부 웹 사이트 및 서비스에 대한 액세스를 위임할 수 있는 웹 UI를 표시합니다. | | [XGameUiShowWebAuthenticationResult](/reference/system/xgameui/functions/xgameuishowwebauthenticationresult) | [XGameUiShowWebAuthenticationAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationasync) 호출의 결과를 가져옵니다. | | [XGameUiShowWebAuthenticationResultSize](/reference/system/xgameui/functions/xgameuishowwebauthenticationresultsize) | 인증 요청의 결과를 포함하는 데 필요한 버퍼의 크기를 검색합니다. | | [XGameUiShowWebAuthenticationWithOptionsAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationwithoptionsasync) | 사용자가 실행 중인 타이틀에 자격 증명을 직접 제공하지 않고도 외부 웹 사이트 및 서비스에 대한 액세스를 위임할 수 있는, 전체 화면으로 표시할 수 있는 옵션이 있는 웹 UI를 표시합니다. | | [XGameUiTextEntryClose](/reference/system/xgameui/functions/xgameuitextentryclose) | 가상 키보드를 닫고 해당 리소스를 해제합니다. | | [XGameUiTextEntryGetExtents](/reference/system/xgameui/functions/xgameuitextentrygetextents) | 가상 키보드의 화면 범위를 가져옵니다. | | [XGameUiTextEntryGetState](/reference/system/xgameui/functions/xgameuitextentrygetstate) | 열린 가상 키보드의 현재 상태를 가져옵니다. | | [XGameUiTextEntryOpen](/reference/system/xgameui/functions/xgameuitextentryopen) | 타이틀이 텍스트 렌더링을 담당하는 가상 키보드를 엽니다. | | [XGameUiTextEntryUpdatePositionHint](/reference/system/xgameui/functions/xgameuitextentryupdatepositionhint) | 가상 키보드의 기본 위치 지정을 업데이트합니다. | | [XGameUiTextEntryUpdateVisibility](/reference/system/xgameui/functions/xgameuitextentryupdatevisibility) | 전체 가상 키보드를 표시할지, 후보 목록만 표시할지를 업데이트합니다. | | [XGameUISetUICallbacks](/reference/system/xgameui/functions/xgameuisetuicallbacks) | 개발자가 정의한 UI 콜백을 설정합니다. | | [XGameUISetMessageDialogUIResponse](/reference/system/xgameui/functions/xgameuisetmessagedialoguiresponse) | XGameUiShowMessageDialogResult에서 반환할 결과 XGameUiMessageDialogButton 값을 설정합니다. | | [XGameUISetPlayerPickerUIResponse](/reference/system/xgameui/functions/xgameuisetplayerpickeruiresponse) | XGameUiShowPlayerPickerResultCount 및 XGameUiShowPlayerPickerResult에서 반환할 결과를 설정합니다. | | [XGameUISetTextEntryUIResponse](/reference/system/xgameui/functions/xgameuisettextentryuiresponse) | XGameUiShowTextEntryAsync에서 반환할 결과 텍스트 길이와 텍스트를 설정합니다. | | [XGameUISetPlayerProfileCardUIResponse](/reference/system/xgameui/functions/xgameuisetplayerprofilecarduiresponse) | XGameUiShowPlayerProfileCardAsync 호출을 완료합니다. | | [XGameUISetSendGameInviteUIResponse](/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse) | XGameUiShowSendGameInviteAsync 호출을 완료합니다. | | [XGameUISetAchievementsUIResponse](/reference/system/xgameui/functions/xgameuisetachievementsuiresponse) | XGameUiShowAchievementsAsync 호출을 완료합니다. | | [XGameUISetMultiplayerActivityGameInviteUIResponse](/reference/system/xgameui/functions/xgameuisetmultiplayeractivitygameinviteuiresponse) | XGameUiShowMultiplayerActivityGameInviteAsync 호출을 완료합니다. | | [XGameUISetErrorDialogUIResponse](/reference/system/xgameui/functions/xgameuiseterrordialoguiresponse) | XGameUiShowErrorDialogAsync 호출을 완료합니다. | | [XGameUIShowPlayerProfileCardUICallback](/reference/system/xgameui/functions/xgameuishowplayerprofilecarduicallback) | XGameUiShowPlayerProfileCardAsync 콜백의 시그니처입니다. | | [XGameUIShowPlayerPickerUICallback](/reference/system/xgameui/functions/xgameuishowplayerpickeruicallback) | XGameUiShowPlayerPickerAsync 콜백의 시그니처입니다. | | [XGameUIShowSendGameInviteUICallback](/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback) | XGameUiShowSendGameInviteAsync 콜백의 시그니처입니다. | | [XGameUIShowAchievementsUICallback](/reference/system/xgameui/functions/xgameuishowachievementsuicallback) | XGameUiShowAchievementsAsync 콜백의 시그니처입니다. | | [XGameUIShowMultiplayerActivityGameInviteUICallback](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteuicallback) | XGameUiShowMultiplayerActivityGameInviteAsync 콜백의 시그니처입니다. | | [XGameUIShowMessageDialogUICallback](/reference/system/xgameui/functions/xgameuishowmessagedialoguicallback) | XGameUiShowMessageDialogAsync 콜백의 시그니처입니다. | | [XGameUIShowErrorDialogUICallback](/reference/system/xgameui/functions/xgameuishowerrordialoguicallback) | XGameUiShowErrorDialogAsync 콜백의 시그니처입니다. | | [XGameUIShowTextEntryUICallback](/reference/system/xgameui/functions/xgameuishowtextentryuicallback) | XGameUiShowTextEntryAsync 콜백의 시그니처입니다. | ## 구조체 | 구조체 | 설명 | | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | | [XGameUiWebAuthenticationResultData](/reference/system/xgameui/structs/xgameuiwebauthenticationresultdata) | 웹 인증 요청의 응답을 포함합니다. | | [XGameUiTextEntryExtents](/reference/system/xgameui/structs/xgameuitextentryextents) | 가상 키보드의 상대적 위치를 설명합니다. | | [XGameUiTextEntryOptions](/reference/system/xgameui/structs/xgameuitextentryoptions) | XGameUiTextEntryOpen에서 사용하는 가상 키보드의 초기 옵션 집합입니다. | | [XGameUICallbackHandle](/reference/system/xgameui/structs/xgameuicallbackhandle) | XGameUi 콜백 호출과 연결된 핸들입니다. Set\*Response API 호출에서 사용됩니다. | | [XGameUIPlayerPickerInfo](/reference/system/xgameui/structs/xgameuiplayerpickerinfo) | 개발자의 사용자 지정 플레이어 선택기 UI에서 사용할 사용자 정보를 캡슐화하는 구조체입니다. | | [XGameUIUICallbacks](/reference/system/xgameui/structs/xgameuiuicallbacks) | 개발자가 정의한 UI 콜백에 대한 포인터를 포함하는 구조체입니다. | ## 열거형 | 열거형 | 설명 | | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | [XGameUiMessageDialogButton](/reference/system/xgameui/enums/xgameuimessagedialogbutton) | 사용자 지정 가능한 메시지 대화 상자의 버튼을 열거합니다. | | [XGameUiNotificationPositionHint](/reference/system/xgameui/enums/xgameuinotificationpositionhint) | 현재 타이틀에 표시할 토스트 알림의 기본 위치를 설명합니다. | | [XGameUiTextEntryChangeTypeFlags](/reference/system/xgameui/enums/xgameuitextentrychangetypeflags) | XGameUiTextEntryGetState에 대한 마지막 호출 이후 변경된 사항을 나타내는 플래그입니다. | | [XGameUiTextEntryInputScope](/reference/system/xgameui/enums/xgameuitextentryinputscope) | 텍스트 입력에서 예상되는 정보 유형을 열거합니다. | | [XGameUiTextEntryPositionHint](/reference/system/xgameui/enums/xgameuitextentrypositionhint) | 가상 키보드를 배치할 가장 좋은 위치에 대한 힌트입니다. | | [XGameUiTextEntryVisibilityFlags](/reference/system/xgameui/enums/xgameuitextentryvisibilityflags) | 가상 키보드의 표시 상태를 나타내는 플래그입니다. | | [XGameUiWebAuthenticationOptions](/reference/system/xgameui/enums/xgameuiwebauthenticationoptions) | 웹 인증 플로우를 표시하기 위한 옵션을 열거합니다. | ## 오류 코드 다음 오류 코드는 XGameUI API에서 반환될 수 있습니다. 전체 목록은 [오류 코드](/reference/errorcodes)를 참조하세요. | 코드 | 값 | 설명 | | -------------------------------- | - | ---------------------------------------------------------------------------------------------------------------------------------------- | | E\_GAMEUI\_TEXTENTRY\_NOT\_SHOWN | — | XGameUiTextEntryHandle이 유효하지 않습니다. 먼저 [XGameUiTextEntryOpen](/reference/system/xgameui/functions/xgameuitextentryopen)을 호출해야 할 가능성이 큽니다. | ## 개념 문서 * [비동기 프로그래밍 설계 목표 및 개선 사항](/build/core-features/common/async/async-whitepaper) * [시간에 민감한 스레드](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 참조](/reference/system/gc-reference-system-toc) ## Related topics - [XGameUiShowSendGameInviteResult](/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteresult.md) - [XGameUiShowSendGameInviteAsync](/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteasync.md) - [XGameUiSetSendGameInviteUiResponse](/ko/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse.md) - [XGameUiUiCallbacks](/ko/reference/system/xgameui/structs/xgameuiuicallbacks.md) - [XGameUiShowSendGameInviteUiCallback](/ko/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback.md)