XUser
Material de referencia para las API de XUser.Funciones
| Función | Descripción |
|---|---|
| XUserAddAsync | Agrega de forma asincrónica un usuario a una sesión de juego. |
| XUserAddByIdWithUiAsync | Agrega de forma asincrónica un usuario a una sesión de juego basándose en un XUID de una invitación de juego. Esta función solo debe usarse en respuesta a una invitación de juego. |
| XUserAddByIdWithUiResult | Recupera un identificador del usuario que crea XUserAddByIdWithUiAsync. Esta función solo debe usarse en respuesta a una invitación de juego. |
| XUserAddResult | Recupera un identificador de un usuario que crea XUserAddAsync. |
| XUserChangeEventCallback | Una devolución de llamada que una aplicación define para un evento de cambio de usuario. |
| XUserCheckPrivilege | Determina si un usuario tiene un privilegio específico. |
| XUserCloseHandle | Cierra un identificador de usuario específico. |
| XUserCloseSignOutDeferralHandle | Cierra un identificador específico de aplazamiento de cierre de sesión de usuario. |
| XUserCompare | Compara dos identificadores de usuario para comprobar la igualdad. |
| XUserDefaultAudioEndpointUtf16ChangedCallback | Una devolución de llamada que una aplicación define e invoca cuando cambia el punto de conexión de audio predeterminado para un usuario. |
| XUserDeviceAssociationChangedCallback | Una devolución de llamada que se invoca cuando cambia la asociación usuario-dispositivo. |
| XUserDuplicateHandle | Duplica un identificador de usuario. |
| XUserFindControllerForUserWithUiAsync | Muestra un cuadro de diálogo que pedirá al usuario que encienda e identifique el mando que quiere usar. |
| XUserFindControllerForUserWithUiResult | Recupera el identificador de dispositivo local de la aplicación (APP_LOCAL_DEVICE_ID) que un usuario ha elegido usar. |
| XUserFindForDevice | Recupera el identificador de usuario para un identificador de dispositivo específico. |
| XUserFindUserById | Recupera el identificador de usuario de XBox (XUID) para un usuario local. |
| XUserFindUserByLocalId | Recupera un identificador del usuario para un identificador de usuario local específico. |
| XUserGetAgeGroup | Devuelve el grupo de edad de un usuario. |
| XUserGetDefaultAudioEndpointUtf16 | Recupera el punto de conexión de audio predeterminado para un usuario específico. |
| XUserGetGamerPictureAsync | Recupera de forma asincrónica la imagen de jugador para un usuario específico. |
| XUserGetGamerPictureResult | Recupera el resultado de una llamada a XUserGetGamerPictureAsync. |
| XUserGetGamerPictureResultSize | Devuelve el tamaño del búfer que XUserGetGamerPictureResult requiere para recuperar la imagen de jugador que ]XUserGetGamerPictureAsync](/es/reference/system/xuser/functions/xusergetgamerpictureasync) devuelve. |
| XUserGetGamertag | Recupera el gamertag para un usuario específico. |
| XUserGetId | Obtiene el identificador de usuario para un usuario específico. |
| XUserGetIsGuest | Devuelve un valor booleano que indica si un usuario es un invitado. |
| XUserGetLocalId | Recupera un identificador de sesión de juego único para un usuario. |
| XUserGetMaxUsers | Recupera el número máximo de usuarios que permite una sesión de juego en la plataforma actual. |
| XUserGetMsaTokenSilentlyAsync | Esta función está ahora en desuso. |
| XUserGetMsaTokenSilentlyResult | Esta función está ahora en desuso. |
| XUserGetMsaTokenSilentlyResultSize | Esta función está ahora en desuso. |
| XUserGetSignOutDeferral | Recupera un identificador del aplazamiento de cierre de sesión. |
| XUserGetState | Recupera el estado de un usuario. |
| XUserGetTokenAndSignatureAsync | Recupera de forma asincrónica xtokens y firmas para solicitudes web. |
| XUserGetTokenAndSignatureResult | Obtiene el resultado de una llamada a XUserGetTokenAndSignatureAsync. |
| XUserGetTokenAndSignatureResultSize | Obtiene el tamaño del búfer para contener los resultados de una llamada a XUserGetTokenAndSignatureAsync. |
| XUserGetTokenAndSignatureUtf16Async | Recupera de forma asincrónica xtokens y firmas Unicode para solicitudes web. |
| XUserGetTokenAndSignatureUtf16Result | Obtiene el resultado de una llamada a XUserGetTokenAndSignatureUtf16Async. |
| XUserGetTokenAndSignatureUtf16ResultSize | Obtiene el tamaño del búfer para contener los resultados de una llamada a XUserGetTokenAndSignatureUtf16Async. |
| XUserIsStoreUser | Comprueba si la MSA de XUser es la misma que la MSA con la que se ha iniciado sesión en Microsoft Store. |
| XUserRegisterForChangeEvent | Registra una devolución de llamada para un evento de cambio de usuario. |
| XUserRegisterForDefaultAudioEndpointUtf16Changed | Registra una devolución de llamada que la aplicación define e invoca cuando cambia el punto de conexión de audio predeterminado. |
| XUserRegisterForDeviceAssociationChanged | Registra una devolución de llamada para los eventos de cambio de asociación de dispositivos de usuario. |
| XUserResolveIssueWithUiAsync | Muestra una interfaz de usuario del sistema para resolver problemas de token con una URL no Unicode. |
| XUserResolveIssueWithUiResult | Recupera el resultado de una llamada a XUserResolveIssueWithUiAsync. |
| XUserResolveIssueWithUiUtf16Async | Muestra una interfaz de usuario del sistema para resolver problemas de token con una URL Unicode específica. |
| XUserResolveIssueWithUiUtf16Result | Recupera el resultado de una llamada a XUserResolveIssueWithUiUtf16Async. |
| XUserResolvePrivilegeWithUiAsync | Muestra una interfaz de usuario de resolución para los privilegios de usuario requeridos. |
| XUserResolvePrivilegeWithUiResult | Recupera el resultado de una llamada a XUserResolvePrivilegeWithUiAsync. |
| XUserUnregisterForChangeEvent | Anula el registro de una devolución de llamada de cambio de usuario registrada previamente. |
| XUserUnregisterForDefaultAudioEndpointUtf16Changed | Anula el registro de una devolución de llamada de cambio de punto de conexión de audio predeterminado registrada previamente. |
| XUserUnregisterForDeviceAssociationChanged | Anula el registro de una devolución de llamada de cambio de asociación de dispositivos de usuario registrada previamente. |
| xUserPlatformRemoteConnectSetEventHandlers | Establece los controladores de eventos de conexión remota |
| XUserPlatformRemoteConnectCancelPrompt | Señal a XUser de que el usuario ha descartado el mensaje de conexión remota. |
| XUserPlatformRemoteConnectShowPromptEventHandler | Controlador de eventos para mostrar el mensaje de autenticación de conexión remota. |
| XUserPlatformRemoteConnectClosePromptEventHandler | Controlador de eventos para cerrar el mensaje de autenticación remota. |
| XUserPlatformSpopPromptEventHandler | Controlador de eventos para mostrar el mensaje de la operación SPOP |
| XUserPlatformSpopPromptSetEventHandlers | Establece el controlador de eventos del mensaje de SPOP. |
| XUserPlatformSpopPromptClearEventHandler | Borra el controlador de eventos del mensaje de SPOP en XUser. |
| XUserPlatformSpopPromptComplete | Señal a XUser de que el usuario ha terminado de interactuar con el mensaje de SPOP. |
Estructuras
| Estructura | Descripción |
|---|---|
| APP_LOCAL_DEVICE_ID | Especifica el identificador raíz de un dispositivo de entrada local. |
| XUserDeviceAssociationChange | Especifica las asociaciones de dispositivo antigua y nueva cuando cambia una asociación de dispositivo. |
| XUserGetTokenAndSignatureData | Especifica los xtokens y las firmas que recuperamos para las solicitudes web. |
| XUserGetTokenAndSignatureHttpHeader | Especifica el encabezado HTTP para una solicitud web. |
| XUserGetTokenAndSignatureUtf16Data | Contiene xtokens y firmas Unicode para solicitudes web. |
| XUserGetTokenAndSignatureUtf16HttpHeader | Contiene un encabezado HTTP Unicode para una solicitud web. |
| XUserLocalId | Especifica un identificador de sesión de juego para un usuario. |
| XUserPlatformRemoteConnectEventHandlers | Encapsula los controladores de eventos de conexión remota |
Enumeraciones
| Enumeración | Descripción |
|---|---|
| XUserAddOptions | Especifica las opciones para agregar un usuario. |
| XUserAgeGroup | Especifica el grupo de edad de un usuario. |
| XUserChangeEvent | Especifica el tipo de evento de cambio de usuario. |
| XUserDefaultAudioEndpointKind | Especifica si el punto de conexión de audio predeterminado del usuario renderiza o captura audio. |
| XUserGamerPictureSize | Especifica el tamaño de la imagen de jugador en píxeles. |
| XUserGamertagComponent | Especifica el tipo (o componente) de gamertag que se va a capturar. |
| XUserGetMsaTokenSilentlyOptions | Opciones para XUserGetMsaTokenSilentlyOptions. |
| XUserGetTokenAndSignatureOptions | Opciones para GetUserTokenAndSignatureAsync. |
| XUserPrivilege | Especifica los privilegios de un usuario. |
| XUserPrivilegeDenyReason | Especifica el motivo por el que un usuario no pudo obtener un privilegio. |
| XUserPrivilegeOptions | Especifica las opciones de privilegios de usuario. |
| XUserState | Especifica el estado actual del usuario. |
| XUserPlatformOperationResult | Enumeración que define los resultados de una operación de cliente |
| XUserPlatformSpopOperationResult | Enumeración que define los resultados de una operación de cliente. |
Documentación conceptual
- Objetivos de diseño y mejoras de la programación asincrónica
- Información general de WinHTTP
- Solicitudes web (contenido)
- Subprocesos con dependencia temporal
- Uso de contenedores de C# para las API del GDK en su proyecto de Unity
Consulte también
Referencia de API del sistemaCódigos de error
Las API de XUser pueden devolver los siguientes códigos de error. Para obtener una lista completa, consulte Códigos de error.| Código | Valor | Descripción |
|---|---|---|
| E_GAMEUSER_MAX_USERS_ADDED | 0x89245100 | No se puede agregar este usuario porque se ha alcanzado el número máximo de usuarios. |
| E_GAMEUSER_SIGNED_OUT | 0x89245101 | No se puede realizar la operación porque el usuario ha cerrado sesión. |
| E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED | 0x89245102 | Se requiere la interfaz de usuario para resolver un problema con este usuario. |
| E_GAMEUSER_DEFERRAL_NOT_AVAILABLE | 0x89245103 | No es un momento apropiado para solicitar un aplazamiento. |
| E_GAMEUSER_USER_NOT_FOUND | 0x89245104 | No se encontró ningún usuario que coincida con el identificador. |
| E_GAMEUSER_NO_TOKEN_REQUIRED | 0x89245105 | No se requiere ningún token para esta llamada. |
| E_GAMEUSER_NO_DEFAULT_USER | 0x89245106 | No hay ningún usuario predeterminado actual. Si obtiene este error, llame a XUserAddAsync de nuevo sin AddDefaultUserSilently. |
| E_GAMEUSER_FAILED_TO_RESOLVE | 0x89245107 | No se pudo resolver el privilegio dado. |
| E_GAMEUSER_NO_TITLE_ID | 0x89245108 | Se debe configurar un TitleId de XBOX Live. |
| E_GAMEUSER_UNKNOWN_GAME_IDENTITY | 0x89245109 | No se reconoce la identidad del juego. El MSAAppId y el TitleId no coinciden con los asociados al juego. |
| E_GAMEUSER_NO_PACKAGE_IDENTITY | 0x89245110 | Se debe configurar una identidad de paquete. |
| E_GAMEUSER_FAILED_TO_GET_TOKEN | 0x89245111 | Error en la solicitud de token. |
| E_GAMEUSER_INVALID_APP_CONFIGURATION | 0x89245112 | El MSAAppId de la configuración del juego no es válido o no está configurado para la pila de autenticación. |
| E_GAMEUSER_MALFORMED_MSAAPPID | 0x89245113 | El MSAAppId de la configuración del juego no coincide con el formato esperado (cadena de 16 caracteres o GUID). |
| E_GAMEUSER_INCONSISTENT_MSAAPPID_AND_TITLEID | 0x89245114 | El MSAAppId y el TitleId de la configuración del juego no coinciden con los asociados al juego. |