> ## 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. # Solución de problemas de errores de inicio de sesión y sandbox > Diagnostique los errores de inicio de sesión de XBOX Live y de sandbox en PC mediante XblPCSandbox, una lista de comprobación previa, una referencia de códigos de error y comprobaciones de la configuración de Partner Center. 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](#preflight-checklist) * [Diagrama de flujo de diagnóstico](#diagnostic-flowchart) * [Errores de cuenta y sandbox](#account-and-sandbox-errors) * [Errores de configuración](#configuration-errors) * [Solución de problemas específicos del juego](#game-specific-troubleshooting) * [Solución de problemas adicional](#additional-troubleshooting) * [Referencia rápida de códigos de error](#error-code-quick-reference) *** ## 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](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) ### 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:** ```cmd theme={null} XblPCSandbox /get ``` 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](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)], reemplazando el parámetro \[productId] por su *Product Id* correspondiente. **Cómo corregirlo:** ```cmd theme={null} XblPCSandbox ``` Consulte [Información general sobre los sandboxes](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) 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:** ```cmd theme={null} XblPCSandbox /get ``` 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](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)], reemplazando el parámetro \[productId] por su *Product Id* correspondiente. **Cómo corregirlo:** ```cmd theme={null} XblPCSandbox ``` Consulte [Información general sobre los sandboxes](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) 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](https://partner.microsoft.com/dashboard). 2. Seleccione **Apps and Games** 3. Seleccione **XBOX Test accounts** (o vaya a [Administración de cuentas de prueba](https://partner.microsoft.com/dashboard/xbox/testaccounts)). 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](https://support.xbox.com/en-MD/help/games-apps/troubleshooting/gaming-services-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: ```cmd theme={null} XblPCSandbox /feedback ``` 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: | Campo de MicrosoftGame.config | Dónde encontrarlo en Partner Center | | ----------------------------- | ------------------------------------------------------------------------------------- | | `StoreId` | **Game Setup** > **Identity details** > **Show details** > Store ID | | `Identity/Name` | **Game Setup** > **Identity details** > **Show details** > Package/Identity/Name | | `Identity/Publisher` | **Game Setup** > **Identity details** > **Show details** > Package/Identity/Publisher | | `TitleId` | **XBOX services** > **XBOX Settings** > Title ID (valor **hexadecimal**, no decimal) | | `MSAAppId` | **XBOX services** > **XBOX Settings** > MSA App ID (puede ser un GUID o hexadecimal) | 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](/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize). Lo encontrará en **XBOX services** > **XBOX Settings** en Partner Center. Use el **Store Association Wizard** del [Editor de MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Editor) 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](https://partner.microsoft.com/dashboard). 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](https://partner.microsoft.com/dashboard). 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. ``` ┌─────────────────────────────────────────────────────────┐ │ Still can't sign in? │ │ Start here after completing the │ │ Preflight Checklist │ └───────────────────────┬─────────────────────────────────┘ │ ▼ ┌───────────────────────────────┐ │ STEP 1: Can you sign in to │ │ the Xbox App with your │ │ test account? │ └───────┬───────────────┬───────┘ │ │ YES ▼ NO ▼ ┌───────────────┐ ┌──────────────────────────────────────────────┐ │ Sandbox and │ │ Sandbox or account │ │ account are │ │ issue. Check: │ │ working. │ │ │ │ Go to Step 2 │ │ • Is the sandbox ID correct? │ │ │ │ • Is the account access to sandbox expired? │ └───────┬───────┘ │ • Does the account have sandbox access? │ │ │ • Are the credentials right? │ │ │ • Is the Xbox App up to date? │ │ │ • Is the Xbox App licensed? │ │ │ │ │ │ See: Account & Sandbox Errors below │ │ └──────────────────────────────────────────────┘ ▼ ┌───────────────────────────────┐ │ STEP 2: Can you sign in to │ │ a sample project with your │ │ game's IDs? │ └───────┬───────────────┬───────┘ │ │ YES ▼ NO ▼ ┌───────────────┐ ┌──────────────────────────────┐ │ Config is │ │ Configuration issue. │ │ working. │ │ Check: │ │ Go to Step 3 │ │ │ │ │ │ • Are the IDs correct in │ └───────┬───────┘ │ MicrosoftGame.config? │ │ │ • Are the gameplay settings │ │ │ published to the sandbox? │ │ │ • Is the PC Platform │ │ │ enabled? │ │ │ • Is the SCID correct in │ │ │ XblInitialize? │ │ │ │ │ │ See: Configuration │ │ │ Errors below │ │ └──────────────────────────────┘ ▼ ┌───────────────────────────────┐ │ STEP 3: Game-specific issue │ │ The sample works but your │ │ game doesn't. │ │ │ │ • Compare the MicrosoftGame │ │ .config files │ │ • Compare the sign-in code │ │ • Check the error code in │ │ reference table below │ └───────────────────────────────┘ ``` *** ## 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](#diagnostic-flowchart)), 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:** | Causa | Corrección | | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Los identificadores de `MicrosoftGame.config` no coinciden con Partner Center | Consulte el [elemento 1 de la lista de comprobación](#-1-review_the_sandbox_Id_does_not_have_any_typos) y el [elemento 2 de la lista de comprobación](#-2-your-sandbox-is-correct) | | La cuenta de prueba no tiene acceso al sandbox | Edite la cuenta de prueba en Partner Center y agregue su sandbox | | El acceso de la cuenta de prueba al sandbox ha expirado | Compruebe la fecha de expiración en Partner Center; cree una cuenta nueva o amplíela | | Uso de un sandbox aislado en lugar de compartido | Compruebe el tipo de sandbox en Partner Center; cambie a un sandbox compartido a menos que tenga una razón específica para usar uno aislado. Consulte [Sandboxes aislados frente a compartidos](#isolated-vs-shared-sandboxes). | ### 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 ` 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 ` ### 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 ` ### 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](#diagnostic-flowchart)), 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](/build/core-features/common/game-config/MicrosoftGameConfig-Editor) 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](#-1-your-ids-match-partner-center). ### SCID incorrecto en XblInitialize El SCID **no** está en `MicrosoftGame.config`: se pasa como parámetro a [XblInitialize](/reference/live/xsapi-c/xbox_live_global_c/functions/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](#diagnostic-flowchart)), 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`](/reference/system/xuser/functions/xuseraddasync) y [AdvancedUserModel](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-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: * [Página de estado de XBOX](https://support.xbox.com/xbox-live-status) > \[!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 | Código de error | Nombre | Causa probable | Corrección | | --------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `0x8015DC12` | Usuario no está en el sandbox | Identificadores que no coinciden, sin acceso al sandbox, acceso expirado de la cuenta de prueba al sandbox o sandbox aislado | Consulte la [lista de comprobación](#preflight-checklist); compruebe los identificadores, el acceso de la cuenta y el tipo de sandbox | | `0x87dd0005` | `AM_E_XAST_UNEXPECTED` | Plataforma PC no habilitada en Partner Center | Habilite **Windows 10 (and later) PC** en XBOX Settings, **publique** en el sandbox, espere 30 min | | `0x89245106` | `E_GAMEUSER_NO_DEFAULT_USER` | Ningún usuario predeterminado con la sesión iniciada; se llamó a `XUserAddAsync(AddDefaultUserSilently)` | Consulte [`XUserAddAsync`](/reference/system/xuser/functions/xuseraddasync) y [AdvancedUserModel](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel) para obtener más información sobre cómo solucionarlo. | | `0x803F8001` | Error de licencia | La aplicación XBOX no se inició previamente en RETAIL | Cambie a RETAIL, inicie la aplicación XBOX, vuelva al sandbox de desarrollo | | `0x80004005` | Error genérico de inicio de sesión | Configuración incorrecta del sandbox o de la cuenta; también puede indicar un problema del lado del servicio | Revise la [lista de comprobación previa](#preflight-checklist); compruebe el identificador del sandbox, el acceso de la cuenta de prueba y la expiración de la cuenta. Si el problema persiste, intente reiniciar su PC y volver a cambiar de sandbox. | 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 error O, si lo hace directamente desde el Centro de opiniones, **Category: Gaming and XBOX** y **Area: Developer Tools** *** ## Consulte también * [Información general sobre los sandboxes](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox) * [Información general conceptual sobre sandboxes avanzados](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes) * [Cuentas de prueba](/services/xbox-services/develop/test-accounts/live-test-accounts) * [Información general sobre la configuración de los servicios de XBOX](/services/xbox-services/fundamentals/portal-config/live-portal-config-overview) * [Información general sobre MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-Overview) * [Referencia de XblPCSandbox.exe](/tools/tools-services/live-pc-sandbox-switcher) ## Related topics - [Solución de problemas](/es/services/xbox-services/develop/troubleshooting/index.md) - [Solución de problemas de inicio de sesión en los servicios XBOX](/es/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md) - [Inicio de sesión de usuario](/es/services/xbox-services/fundamentals/identity/auth/live-authentication-nav.md) - [Solución de problemas de desarrollo con XStore](/es/publishing/xstore-commerce/xstore-troubleshooting.md) - [Solución de problemas del tráfico de los servicios XBOX en PC](/es/build/gdk-and-engines/guides/troubleshoot-xbox-services-traffic.md)