Skip to main content
Este artículo le ayuda a diagnosticar y corregir errores comunes de inicio de sesión y relacionados con el sandbox de su juego en un sandbox de desarrollo en PC.

En este artículo


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:
Compare la salida con el sandbox que se muestra en la página Gameplay settings de Partner Center. Puede hacerlo mediante https://partner.microsoft.com/en-us/xboxconfig?appid=[productId], reemplazando el parámetro [productId] por su Product Id correspondiente. Cómo corregirlo:
Consulte Información general sobre los sandboxes para obtener instrucciones detalladas sobre cómo cambiar de sandbox.

✅ 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:
Compare la salida con el sandbox que se muestra en la página Gameplay settings de Partner Center. Puede hacerlo mediante https://partner.microsoft.com/en-us/xboxconfig?appid=[productId], reemplazando el parámetro [productId] por su Product Id correspondiente. Cómo corregirlo:
Consulte Información general sobre los sandboxes para obtener instrucciones detalladas sobre cómo cambiar de sandbox.

✅ 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:
  1. Vaya a Partner Center.
  2. Seleccione Apps and Games
  3. Seleccione XBOX Test accounts (o vaya a Administración de cuentas de prueba).
  4. Busque su cuenta de prueba y compruebe las columnas Access Expires y Status.
Cómo corregirlo: Si la cuenta ha expirado, cree una nueva cuenta de prueba o amplíe la fecha de expiración de la cuenta existente.

La cuenta tiene acceso a su sandbox

Al crear una cuenta de prueba, debe concederle acceso a sandboxes específicos. Cómo comprobarlo:
  1. En Partner Center, vaya a XBOX services > Test accounts.
  2. Seleccione su cuenta de prueba.
  3. Compruebe que su sandbox de desarrollo aparece en la lista de acceso a sandboxes de la cuenta.
Cómo corregirlo: Edite la cuenta de prueba y agregue su sandbox de desarrollo a su lista de acceso.

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:
  1. 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:
O, si lo hace directamente desde el Centro de opiniones, Category: Gaming and XBOX y Area: Developer Tools Cuándo hacerlo: Si ha verificado todas las comprobaciones del entorno anteriores y el inicio de sesión sigue fallando, reinicie su PC e inténtelo de nuevo antes de pasar a las comprobaciones del proyecto.

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 su MicrosoftGame.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.
Use el Store Association Wizard del Editor de MicrosoftGame.config para vincular su juego automáticamente y reducir la posibilidad de errores tipográficos.

✅ 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:
  1. Vaya a Partner Center.
  2. Seleccione su producto.
  3. Vaya a XBOX services > Gameplay settings.
  4. Seleccione la pestaña de su sandbox de desarrollo.
  5. Compruebe el estado de publicación.
Cómo corregirlo: Si los cambios no se han publicado, seleccione Publish para enviarlos a su sandbox de desarrollo. Espere aproximadamente 30 minutos a que los cambios se propaguen antes de volver a probar.
Hacer clic en Save en la página XBOX Settings no publica los cambios. Debe publicar explícitamente desde la página Gameplay settings.

✅ 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 error 0x87dd0005 (AM_E_XAST_UNEXPECTED). Cómo comprobarlo:
  1. Vaya a Partner Center.
  2. Seleccione su producto.
  3. Vaya a XBOX services > XBOX Settings.
  4. Compruebe que la casilla Windows 10 PC está marcada. Hágalo también para las versiones más recientes de Windows.
Cómo corregirlo:
  1. Marque la casilla Windows 10 PC.
  2. Seleccione Save.
  3. Vaya a Gameplay settings y publique su configuración en su sandbox de desarrollo.
  4. 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: XDKS1 en lugar de XDKS.1
  • Sandbox equivocado: cambiar a un sandbox diferente de aquel en el que se publicó la configuración de su juego
Cómo corregirlo:
  1. Ejecute XblPCSandbox /get y compare la salida con Partner Center.
  2. 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:
  1. Ejecute XblPCSandbox /get para confirmar en qué sandbox está configurado su PC.
  2. En Partner Center, vaya a XBOX services > Test accounts y compruebe que su cuenta de prueba tiene acceso a ese sandbox.
  3. 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:
  1. Cambie a RETAIL: XblPCSandbox /retail (o XblPCSandbox RETAIL)
  2. Abra la aplicación XBOX y deje que se inicie por completo.
  3. 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:
  1. Cambie a RETAIL: XblPCSandbox /retail (o XblPCSandbox RETAIL)
  2. Busque “XBOX” en Microsoft Store e instálela.
  3. 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:
  1. En Partner Center, vaya a su producto > XBOX services > XBOX Settings.
  2. Marque la casilla Windows 10 PC.
  3. Seleccione Save.
  4. Vaya a Gameplay settings y publique su configuración en su sandbox de desarrollo.
  5. Espere 30 minutos e intente iniciar sesión de nuevo.
Hacer clic en Save en la página XBOX Settings no publica los cambios. Debe publicar explícitamente desde la página Gameplay settings para que el inicio de sesión funcione.

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:
  1. Vaya a XBOX services > Gameplay settings en Partner Center.
  2. Seleccione la pestaña de su sandbox de desarrollo.
  3. Seleccione Publish.
  4. 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 en MicrosoftGame.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á en MicrosoftGame.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 el MicrosoftGame.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 a XUserAddAsync (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ó a XUserAddAsync 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): XblPCSandbox no puede cambiar de sandbox cuando se ejecuta en una sesión SSH. Ejecute XblPCSandbox desde 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

Consulte también

Última modificación el 1 de septiembre de 2026