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

Las API de XboxGameUI permiten a los títulos mostrar pantallas de interfaz de usuario predefinidas en la consola XBOX One. Estas interfaces de usuario predefinidas incluyen selectores de usuario, tarjetas de perfil e invitaciones de juego, entre otras interfaces.

## Funciones

| Función                                                                                                                                      | Descripción                                                                                                                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [XGameUiSetNotificationPositionHint](/reference/system/xgameui/functions/xgameuisetnotificationpositionhint)                                 | Establece la posición preferida en la que se mostrarán las notificaciones del sistema en el título actual.                                                                                                                             |
| [XGameUiShowAchievementsAsync](/reference/system/xgameui/functions/xgameuishowachievementsasync)                                             | Muestra la interfaz de usuario que presenta los logros del jugador solicitante para el título especificado.                                                                                                                            |
| [XGameUiShowAchievementsResult](/reference/system/xgameui/functions/xgameuishowachievementsresult)                                           | Obtiene el resultado de una llamada a [XGameUiShowAchievementsAsync](/reference/system/xgameui/functions/xgameuishowachievementsasync).                                                                                                |
| [XGameUiShowErrorDialogAsync](/reference/system/xgameui/functions/xgameuishowerrordialogasync)                                               | Muestra la interfaz de usuario de un cuadro de diálogo de error con una cadena de error definida por el servicio para el código de error especificado.                                                                                 |
| [XGameUiShowErrorDialogResult](/reference/system/xgameui/functions/xgameuishowerrordialogresult)                                             | Obtiene el resultado de una llamada a [XGameUiShowErrorDialogAsync](/reference/system/xgameui/functions/xgameuishowerrordialogasync).                                                                                                  |
| [XGameUiShowMessageDialogAsync](/reference/system/xgameui/functions/xgameuishowmessagedialogasync)                                           | Muestra la interfaz de usuario de un cuadro de diálogo de mensaje personalizable.                                                                                                                                                      |
| [XGameUiShowMessageDialogResult](/reference/system/xgameui/functions/xgameuishowmessagedialogresult)                                         | Obtiene el resultado de una llamada a [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)                                             | Muestra una interfaz de usuario de selección que permite a una persona que juega al juego seleccionar jugadores de una lista de personas presentada.                                                                                   |
| [XGameUiShowPlayerPickerResult](/reference/system/xgameui/functions/xgameuishowplayerpickerresult)                                           | Obtiene los resultados de una llamada a [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync).                                                                                              |
| [XGameUiShowPlayerPickerResultCount](/reference/system/xgameui/functions/xgameuishowplayerpickerresultcount)                                 | Obtiene el número de resultados de una llamada a [XGameUiShowPlayerPickerAsync](/reference/system/xgameui/functions/xgameuishowplayerpickerasync).                                                                                     |
| [XGameUiShowPlayerProfileCardAsync](/reference/system/xgameui/functions/xgameuishowplayerprofilecardasync)                                   | Muestra la interfaz de usuario de la tarjeta de perfil del jugador especificado.                                                                                                                                                       |
| [XGameUiShowPlayerProfileCardResult](/reference/system/xgameui/functions/xgameuishowplayerprofilecardresult)                                 | Obtiene el resultado de una llamada a [XGameUiShowPlayerProfileCardAsync](/reference/system/xgameui/functions/xgameuishowplayerprofilecardasync).                                                                                      |
| [XGameUiShowSendGameInviteAsync](/reference/system/xgameui/functions/xgameuishowsendgameinviteasync)                                         | Muestra una interfaz de usuario de selección rellenada a partir de la lista de amigos del jugador seleccionado y la lista de amigos sugeridos.                                                                                         |
| [XGameUiShowSendGameInviteResult](/reference/system/xgameui/functions/xgameuishowsendgameinviteresult)                                       | Obtiene el resultado de una llamada a [XGameUIShowSendGameInviteAsync](/reference/system/xgameui/functions/xgameuishowsendgameinviteasync).                                                                                            |
| [XGameUiShowStateShareAsync](/reference/system/xgameui/functions/xgameuishowstateshareasync)                                                 | Muestra la interfaz de usuario para compartir un estado con otros jugadores                                                                                                                                                            |
| [XGameUiShowStateShareResult](/reference/system/xgameui/functions/xgameuishowstateshareresult)                                               | Obtiene el resultado de una llamada a [XGameUIShowStateShareAsync](/reference/system/xgameui/functions/xgameuishowstateshareasync)                                                                                                     |
| [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync)                                                   | Muestra una interfaz de usuario de entrada de texto para que un usuario escriba información.                                                                                                                                           |
| [XGameUiShowTextEntryResult](/reference/system/xgameui/functions/xgameuishowtextentryresult)                                                 | Obtiene los resultados de una llamada a [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync).                                                                                                    |
| [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize)                                         | Obtiene el tamaño del búfer devuelto de una llamada a [XGameUiShowTextEntryAsync](/reference/system/xgameui/functions/xgameuishowtextentryasync).                                                                                      |
| [XGameUiShowWebAuthenticationAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationasync)                                   | Muestra una interfaz de usuario web que permite al usuario delegar el acceso a sitios web y servicios externos sin proporcionar directamente sus credenciales al título en ejecución.                                                  |
| [XGameUiShowWebAuthenticationResult](/reference/system/xgameui/functions/xgameuishowwebauthenticationresult)                                 | Obtiene los resultados de una llamada a [XGameUiShowWebAuthenticationAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationasync).                                                                                    |
| [XGameUiShowWebAuthenticationResultSize](/reference/system/xgameui/functions/xgameuishowwebauthenticationresultsize)                         | Recupera el tamaño del búfer necesario para contener los resultados de una solicitud de autenticación.                                                                                                                                 |
| [XGameUiShowWebAuthenticationWithOptionsAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationwithoptionsasync)             | Muestra una interfaz de usuario web, con la opción de mostrarla a pantalla completa, que permite al usuario delegar el acceso a sitios web y servicios externos sin proporcionar directamente sus credenciales al título en ejecución. |
| [XGameUiTextEntryClose](/reference/system/xgameui/functions/xgameuitextentryclose)                                                           | Cierra el teclado virtual y libera los recursos correspondientes.                                                                                                                                                                      |
| [XGameUiTextEntryGetExtents](/reference/system/xgameui/functions/xgameuitextentrygetextents)                                                 | Obtiene la extensión en pantalla del teclado virtual.                                                                                                                                                                                  |
| [XGameUiTextEntryGetState](/reference/system/xgameui/functions/xgameuitextentrygetstate)                                                     | Obtiene el estado actual del teclado virtual abierto.                                                                                                                                                                                  |
| [XGameUiTextEntryOpen](/reference/system/xgameui/functions/xgameuitextentryopen)                                                             | Abre un teclado virtual en el que el título es responsable de representar el texto.                                                                                                                                                    |
| [XGameUiTextEntryUpdatePositionHint](/reference/system/xgameui/functions/xgameuitextentryupdatepositionhint)                                 | Actualiza la posición preferida del teclado virtual.                                                                                                                                                                                   |
| [XGameUiTextEntryUpdateVisibility](/reference/system/xgameui/functions/xgameuitextentryupdatevisibility)                                     | Actualiza si se muestra el teclado virtual completo o solo la lista de candidatos.                                                                                                                                                     |
| [XGameUISetUICallbacks](/reference/system/xgameui/functions/xgameuisetuicallbacks)                                                           | Establece las devoluciones de llamada de interfaz de usuario definidas por el desarrollador.                                                                                                                                           |
| [XGameUISetMessageDialogUIResponse](/reference/system/xgameui/functions/xgameuisetmessagedialoguiresponse)                                   | Establece el valor de resultado XGameUiMessageDialogButton que devolverá XGameUiShowMessageDialogResult.                                                                                                                               |
| [XGameUISetPlayerPickerUIResponse](/reference/system/xgameui/functions/xgameuisetplayerpickeruiresponse)                                     | Establece los resultados que devolverán XGameUiShowPlayerPickerResultCount y XGameUiShowPlayerPickerResult.                                                                                                                            |
| [XGameUISetTextEntryUIResponse](/reference/system/xgameui/functions/xgameuisettextentryuiresponse)                                           | Establece la longitud del texto y el texto resultantes que devolverá XGameUiShowTextEntryAsync.                                                                                                                                        |
| [XGameUISetPlayerProfileCardUIResponse](/reference/system/xgameui/functions/xgameuisetplayerprofilecarduiresponse)                           | Completa la llamada a XGameUiShowPlayerProfileCardAsync.                                                                                                                                                                               |
| [XGameUISetSendGameInviteUIResponse](/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse)                                 | Completa la llamada a XGameUiShowSendGameInviteAsync.                                                                                                                                                                                  |
| [XGameUISetAchievementsUIResponse](/reference/system/xgameui/functions/xgameuisetachievementsuiresponse)                                     | Completa la llamada a XGameUiShowAchievementsAsync.                                                                                                                                                                                    |
| [XGameUISetMultiplayerActivityGameInviteUIResponse](/reference/system/xgameui/functions/xgameuisetmultiplayeractivitygameinviteuiresponse)   | Completa la llamada a XGameUiShowMultiplayerActivityGameInviteAsync.                                                                                                                                                                   |
| [XGameUISetErrorDialogUIResponse](/reference/system/xgameui/functions/xgameuiseterrordialoguiresponse)                                       | Completa la llamada a XGameUiShowErrorDialogAsync.                                                                                                                                                                                     |
| [XGameUIShowPlayerProfileCardUICallback](/reference/system/xgameui/functions/xgameuishowplayerprofilecarduicallback)                         | Firma de una devolución de llamada de XGameUiShowPlayerProfileCardAsync.                                                                                                                                                               |
| [XGameUIShowPlayerPickerUICallback](/reference/system/xgameui/functions/xgameuishowplayerpickeruicallback)                                   | Firma de una devolución de llamada de XGameUiShowPlayerPickerAsync.                                                                                                                                                                    |
| [XGameUIShowSendGameInviteUICallback](/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback)                               | Firma de una devolución de llamada de XGameUiShowSendGameInviteAsync.                                                                                                                                                                  |
| [XGameUIShowAchievementsUICallback](/reference/system/xgameui/functions/xgameuishowachievementsuicallback)                                   | Firma de una devolución de llamada de XGameUiShowAchievementsAsync.                                                                                                                                                                    |
| [XGameUIShowMultiplayerActivityGameInviteUICallback](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteuicallback) | Firma de una devolución de llamada de XGameUiShowMultiplayerActivityGameInviteAsync.                                                                                                                                                   |
| [XGameUIShowMessageDialogUICallback](/reference/system/xgameui/functions/xgameuishowmessagedialoguicallback)                                 | Firma de una devolución de llamada de XGameUiShowMessageDialogAsync.                                                                                                                                                                   |
| [XGameUIShowErrorDialogUICallback](/reference/system/xgameui/functions/xgameuishowerrordialoguicallback)                                     | Firma de una devolución de llamada de XGameUiShowErrorDialogAsync.                                                                                                                                                                     |
| [XGameUIShowTextEntryUICallback](/reference/system/xgameui/functions/xgameuishowtextentryuicallback)                                         | Firma de una devolución de llamada de XGameUiShowTextEntryAsync.                                                                                                                                                                       |

## Estructuras

| Estructura                                                                                                 | Descripción                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| [XGameUiWebAuthenticationResultData](/reference/system/xgameui/structs/xgameuiwebauthenticationresultdata) | Contiene la respuesta de una solicitud de autenticación web.                                                                                    |
| [XGameUiTextEntryExtents](/reference/system/xgameui/structs/xgameuitextentryextents)                       | Describe la posición relativa del teclado virtual.                                                                                              |
| [XGameUiTextEntryOptions](/reference/system/xgameui/structs/xgameuitextentryoptions)                       | Conjunto inicial de opciones para el teclado virtual usado por XGameUiTextEntryOpen.                                                            |
| [XGameUICallbackHandle](/reference/system/xgameui/structs/xgameuicallbackhandle)                           | Identificador asociado a una invocación de devolución de llamada de XGameUi. Se usa en llamadas a las API Set\*Response.                        |
| [XGameUIPlayerPickerInfo](/reference/system/xgameui/structs/xgameuiplayerpickerinfo)                       | Estructura que encapsula la información del usuario que usará la interfaz de usuario de selección de jugadores personalizada del desarrollador. |
| [XGameUIUICallbacks](/reference/system/xgameui/structs/xgameuiuicallbacks)                                 | Estructura que contiene punteros a devoluciones de llamada de interfaz de usuario definidas por el desarrollador.                               |

## Enumeraciones

| Enumeración                                                                                        | Descripción                                                                                               |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| [XGameUiMessageDialogButton](/reference/system/xgameui/enums/xgameuimessagedialogbutton)           | Enumera los botones de un cuadro de diálogo de mensaje personalizable.                                    |
| [XGameUiNotificationPositionHint](/reference/system/xgameui/enums/xgameuinotificationpositionhint) | Describe la posición preferida en la que se mostrarán las notificaciones del sistema en el título actual. |
| [XGameUiTextEntryChangeTypeFlags](/reference/system/xgameui/enums/xgameuitextentrychangetypeflags) | Marcas que indican lo que ha cambiado desde la última llamada a XGameUiTextEntryGetState.                 |
| [XGameUiTextEntryInputScope](/reference/system/xgameui/enums/xgameuitextentryinputscope)           | Enumera los tipos de información esperados en la entrada de texto.                                        |
| [XGameUiTextEntryPositionHint](/reference/system/xgameui/enums/xgameuitextentrypositionhint)       | Sugerencia sobre dónde colocar mejor el teclado virtual.                                                  |
| [XGameUiTextEntryVisibilityFlags](/reference/system/xgameui/enums/xgameuitextentryvisibilityflags) | Marcas que indican el estado de visibilidad del teclado virtual.                                          |
| [XGameUiWebAuthenticationOptions](/reference/system/xgameui/enums/xgameuiwebauthenticationoptions) | Enumera las opciones para presentar el flujo de autenticación web.                                        |

## Códigos de error

Las API de XGameUI pueden devolver los siguientes códigos de error. Para obtener una lista completa, consulte [Códigos de error](/reference/errorcodes).

| Código                           | Valor | Descripción                                                                                                                                                                  |
| -------------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| E\_GAMEUI\_TEXTENTRY\_NOT\_SHOWN | —     | El XGameUiTextEntryHandle no es válido, probablemente porque es necesario llamar primero a [XGameUiTextEntryOpen](/reference/system/xgameui/functions/xgameuitextentryopen). |

## Documentación conceptual

* [Objetivos de diseño y mejoras de la programación asincrónica](/build/core-features/common/async/async-whitepaper)
* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [¿Qué es el Microsoft Game Development Kit?](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/introduction)
* [Uso de contenedores de C# para las API del GDK en su proyecto de Unity](/build/gdk-and-engines/unity/unity-api-wrappers)

## Consulte también

[Referencia de API del sistema](/reference/system/gc-reference-system-toc)


## Related topics

- [XGameUiShowSendGameInviteResult](/es/reference/system/xgameui/functions/xgameuishowsendgameinviteresult.md)
- [XGameUiShowSendGameInviteAsync](/es/reference/system/xgameui/functions/xgameuishowsendgameinviteasync.md)
- [XGameUiSetSendGameInviteUiResponse](/es/reference/system/xgameui/functions/xgameuisetsendgameinviteuiresponse.md)
- [XGameUiUiCallbacks](/es/reference/system/xgameui/structs/xgameuiuicallbacks.md)
- [XGameUiShowSendGameInviteUiCallback](/es/reference/system/xgameui/functions/xgameuishowsendgameinviteuicallback.md)
