En este artículo
- Lista de comprobación previa
- Diagrama de flujo de diagnóstico
- Errores de cuenta y sandbox
- Errores de configuración
- Solución de problemas específicos del juego
- Solución de problemas adicional
- Referencia rápida de códigos de error
Lista de comprobación previa
Antes de investigar errores específicos, revise esta lista de comprobación. La mayoría de los problemas de inicio de sesión se deben a que uno de estos elementos está mal configurado. Compruebe todos los elementos siguientes antes de pasar al diagrama de flujo de diagnóstico y a las secciones de errores que aparecen a continuación.Es fundamental tener ya instalada la herramienta XblPCSandbox.exe.
Para obtener más detalles sobre cómo obtenerla, consulte Información general sobre los sandboxes
Comprobaciones del entorno
Estos elementos afectan a su capacidad para iniciar sesión en los servicios de XBOX en general, incluida la aplicación XBOX. Compruébelos primero.✅ 1. Revise que el identificador del sandbox no tiene errores tipográficos
Asegúrese de que el identificador del sandbox se ha escrito correctamente. Cómo comprobarlo:✅ 2. Su sandbox es correcto
Su PC debe estar en el mismo sandbox de desarrollo en el que se ha publicado la configuración de los servicios de XBOX de su juego. Cómo comprobarlo:✅ 3. Su cuenta de prueba es válida
Las cuentas de prueba pueden dejar de ser válidas por varias razones. Compruebe todo lo siguiente:El acceso de la cuenta al sandbox no ha expirado
El acceso de las cuentas de prueba a los sandboxes tiene una fecha de expiración. Las cuentas con acceso expirado al sandbox no pueden iniciar sesión en el sandbox. Cómo comprobarlo:- Vaya a Partner Center.
- Seleccione Apps and Games
- Seleccione XBOX Test accounts (o vaya a Administración de cuentas de prueba).
- Busque su cuenta de prueba y compruebe las columnas Access Expires y Status.
La cuenta tiene acceso a su sandbox
Al crear una cuenta de prueba, debe concederle acceso a sandboxes específicos. Cómo comprobarlo:- En Partner Center, vaya a XBOX services > Test accounts.
- Seleccione su cuenta de prueba.
- Compruebe que su sandbox de desarrollo aparece en la lista de acceso a sandboxes de la cuenta.
Las credenciales son correctas
Asegúrese de que está usando la dirección de correo electrónico y la contraseña correctas para la cuenta de prueba. Las direcciones de correo electrónico de las cuentas de prueba suelen terminar en@xboxtest.com.
✅ 4. Los componentes de juegos de XBOX están actualizados
Los servicios de XBOX dependen de la aplicación XBOX y del componente Gaming Services de su PC. Una versión obsoleta de cualquiera de ellos puede provocar errores de inicio de sesión inesperados. Cómo comprobarlo:- Siga la información proporcionada para la herramienta Game Repair Tool
✅ 5. Reinicie su PC
A veces, un servicio en segundo plano necesario para el inicio de sesión (como XBOX Live Auth Manager o Gaming Services) entra en un estado incorrecto. Un reinicio del PC puede resolver problemas transitorios que los pasos anteriores no detectarán. Antes de hacerlo, es importante enviar un error a través del Centro de opiniones para que se pueda realizar el seguimiento y abordarlo en una versión futura. Puede hacerlo con el siguiente comando:Comprobaciones del proyecto
Estos elementos afectan al inicio de sesión desde su juego en concreto. Si puede iniciar sesión en la aplicación XBOX pero no desde su juego, empiece aquí.✅ 6. Sus identificadores coinciden con Partner Center
Los identificadores de suMicrosoftGame.config deben coincidir exactamente con los valores de Partner Center. Un solo valor que no coincida impedirá el inicio de sesión.
Cómo comprobarlo:
Abra su MicrosoftGame.config y compare estos valores con Partner Center:
Además, compruebe el SCID (identificador de configuración de servicio). El SCID no está en su
MicrosoftGame.config: se pasa como parámetro al método XblInitialize. Lo encontrará en XBOX services > XBOX Settings en Partner Center.
✅ 7. La configuración de los servicios de XBOX está publicada en su sandbox
Incluso después de guardar los cambios en Partner Center, estos no están activos hasta que los publique en su sandbox de desarrollo. Cómo comprobarlo:- Vaya a Partner Center.
- Seleccione su producto.
- Vaya a XBOX services > Gameplay settings.
- Seleccione la pestaña de su sandbox de desarrollo.
- Compruebe el estado de publicación.
✅ 8. La plataforma PC está habilitada
Si está desarrollando en PC, la plataforma Windows 10 PC (y posteriores) debe estar habilitada para su título. Sin esto, el inicio de sesión fallará con el error0x87dd0005 (AM_E_XAST_UNEXPECTED).
Cómo comprobarlo:
- Vaya a Partner Center.
- Seleccione su producto.
- Vaya a XBOX services > XBOX Settings.
- Compruebe que la casilla Windows 10 PC está marcada. Hágalo también para las versiones más recientes de Windows.
- Marque la casilla Windows 10 PC.
- Seleccione Save.
- Vaya a Gameplay settings y publique su configuración en su sandbox de desarrollo.
- Espere aproximadamente 30 minutos antes de probar.
Diagrama de flujo de diagnóstico
Si la lista de comprobación previa no resolvió su problema, use este proceso paso a paso para acotar la causa raíz. Empiece en el paso 1 y siga las ramas.Errores de cuenta y sandbox
Si no pudo iniciar sesión en la aplicación XBOX (paso 1 del diagrama de flujo de diagnóstico), el problema está en el cambio de sandbox, la cuenta de prueba o la propia aplicación XBOX.El usuario no está en este sandbox (0x8015DC12)
La cuenta de prueba no tiene acceso al sandbox, o la configuración del juego no coincide con el sandbox. Causas comunes y correcciones:Identificador de sandbox incorrecto
Los errores comunes incluyen:- Caracteres que faltan o sobran:
XDKS1en lugar deXDKS.1 - Sandbox equivocado: cambiar a un sandbox diferente de aquel en el que se publicó la configuración de su juego
- Ejecute
XblPCSandbox /gety compare la salida con Partner Center. - Vuelva a ejecutar
XblPCSandbox <correct sandbox ID>con el valor exacto de Partner Center.
Sandbox incorrecto para la cuenta de prueba (error de Garrison)
Si ve un mensaje de error que sugiere que su cuenta debería funcionar en un sandbox diferente, o el servicio de identidad de XBOX devuelve un error inesperado durante el inicio de sesión, probablemente haya iniciado sesión en el sandbox equivocado para esa cuenta de prueba. Cómo corregirlo:- Ejecute
XblPCSandbox /getpara confirmar en qué sandbox está configurado su PC. - En Partner Center, vaya a XBOX services > Test accounts y compruebe que su cuenta de prueba tiene acceso a ese sandbox.
- Si el sandbox no coincide, cambie al correcto:
XblPCSandbox <correct sandbox ID>
Error de licencia de la aplicación XBOX (0x803F8001)
Es posible que la aplicación XBOX no se inicie si no la ha abierto previamente en RETAIL. Cómo corregirlo:- Cambie a RETAIL:
XblPCSandbox /retail(oXblPCSandbox RETAIL) - Abra la aplicación XBOX y deje que se inicie por completo.
- Vuelva a su sandbox de desarrollo:
XblPCSandbox <your sandbox ID>
No se encuentra la aplicación XBOX
La aplicación XBOX está disponible en Microsoft Store, pero solo cuando está en el sandbox RETAIL. Si no la encuentra:- Cambie a RETAIL:
XblPCSandbox /retail(oXblPCSandbox RETAIL) - Busque “XBOX” en Microsoft Store e instálela.
- Vuelva a su sandbox.
Errores de configuración
Si puede iniciar sesión en la aplicación XBOX pero no puede iniciar sesión dentro de su juego o de un proyecto de ejemplo (paso 2 del diagrama de flujo de diagnóstico), el problema está en la configuración de los servicios de XBOX de su juego.Plataforma PC no habilitada (0x87dd0005, AM_E_XAST_UNEXPECTED)
Este error significa que la plataforma Windows 10 PC no se agregó en Partner Center. Compruébelo también para las versiones posteriores. Cómo corregirlo:- En Partner Center, vaya a su producto > XBOX services > XBOX Settings.
- Marque la casilla Windows 10 PC.
- Seleccione Save.
- Vaya a Gameplay settings y publique su configuración en su sandbox de desarrollo.
- Espere 30 minutos e intente iniciar sesión de nuevo.
Configuración de los servicios de XBOX no publicada
Los cambios guardados en Partner Center no están activos hasta que se publican en su sandbox de desarrollo. Cómo corregirlo:- Vaya a XBOX services > Gameplay settings en Partner Center.
- Seleccione la pestaña de su sandbox de desarrollo.
- Seleccione Publish.
- Espere aproximadamente 30 minutos a que los cambios se propaguen.
Identificadores incorrectos en MicrosoftGame.config
Una causa común de los errores de inicio de sesión es uno o varios valores que no coinciden enMicrosoftGame.config.
Cómo corregirlo:
Use el Store Association Wizard del Editor de MicrosoftGame.config para vincular su juego y rellenar automáticamente los valores correctos. O compruebe manualmente cada valor con Partner Center mediante el elemento 1 de la lista de comprobación.
SCID incorrecto en XblInitialize
El SCID no está enMicrosoftGame.config: se pasa como parámetro a XblInitialize. Asegúrese de pasar el SCID correcto de Partner Center (XBOX services > XBOX Settings).
Sandboxes aislados frente a compartidos
A menos que tenga una razón específica para usar un sandbox aislado, use un sandbox compartido. Puede comprobar el tipo de su sandbox en Partner Center. Los sandboxes aislados tienen restricciones adicionales que pueden provocar errores de inicio de sesión.Solución de problemas específicos del juego
Si el inicio de sesión en la aplicación XBOX funciona y un proyecto de ejemplo funciona con los identificadores de su juego, pero su juego sigue sin poder iniciar sesión (paso 3 del diagrama de flujo de diagnóstico), el problema es específico del código o la configuración de su juego.Compare los archivos MicrosoftGame.config
Compare elMicrosoftGame.config de su juego con el del ejemplo que funciona. Busque campos adicionales o que falten, diferencias de formato o valores incorrectos.
Compare el código de inicio de sesión
Compare la implementación del inicio de sesión de su juego con el código del ejemplo. Busque diferencias en cómo se llama aXUserAddAsync (opciones, devoluciones de llamada, control de errores).
No hay usuario predeterminado (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)
Este error significa que no hay ningún usuario predeterminado actual con la sesión iniciada. Causa: Llamó aXUserAddAsync con la opción AddDefaultUserSilently, pero actualmente no hay ningún usuario con la sesión iniciada.
Cómo corregirlo:
Consulte XUserAddAsync y AdvancedUserModel para obtener más información.
Solución de problemas adicional
Los servicios de XBOX están experimentando una interrupción
Si ha agotado todas las demás opciones, compruebe si los servicios de XBOX tienen una interrupción:[!IMPORTANT] Limitación conocida (GDK 26.04):XblPCSandboxno puede cambiar de sandbox cuando se ejecuta en una sesión SSH. EjecuteXblPCSandboxdesde una sesión local en su lugar.
Referencia rápida de códigos de error
Si ve un código de error que no aparece aquí, envíe el problema a través del Centro de opiniones.Use xblPcSandbox /feedback para enviar el errorO, si lo hace directamente desde el Centro de opiniones, Category: Gaming and XBOX y Area: Developer Tools
