> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Résolution des erreurs de connexion et de sandbox > Diagnostiquez les erreurs de connexion et de sandbox XBOX Live sur PC à l'aide de XblPCSandbox, d'une liste de vérification préalable, d'une référence des codes d'erreur et de vérifications de la configuration dans Partner Center. Cet article vous aide à diagnostiquer et à corriger les erreurs courantes liées à la connexion et au sandbox pour votre jeu dans un sandbox de développement sur PC. ## Dans cet article * [Liste de vérification préalable](#liste-de-vérification-préalable) * [Organigramme de diagnostic](#organigramme-de-diagnostic) * [Erreurs de compte et de sandbox](#erreurs-de-compte-et-de-sandbox) * [Erreurs de configuration](#erreurs-de-configuration) * [Résolution des problèmes propres au jeu](#résolution-des-problèmes-propres-au-jeu) * [Autres solutions de dépannage](#autres-solutions-de-dépannage) * [Référence rapide des codes d'erreur](#référence-rapide-des-codes-derreur) *** ## Liste de vérification préalable Avant d'examiner des erreurs spécifiques, parcourez cette liste de vérification. La plupart des problèmes de connexion sont dus à une mauvaise configuration de l'un de ces éléments. Vérifiez **tous** les points suivants avant de passer à l'organigramme de diagnostic et aux sections sur les erreurs ci-dessous. > [!NOTE] > > Il est essentiel que l'outil XblPCSandbox.exe soit déjà installé. > Pour plus de détails sur son obtention, consultez [Vue d'ensemble des sandboxes](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) ### Vérifications de l'environnement Ces éléments conditionnent votre capacité à vous connecter aux services XBOX, y compris à l'application XBOX. Vérifiez-les en premier. *** ### ✅ 1. Vérifier que l'ID du sandbox ne contient pas de faute de frappe Assurez-vous que l'ID du sandbox a été saisi correctement. **Comment vérifier :** ```cmd theme={null} XblPCSandbox /get ``` Comparez le résultat avec le sandbox affiché dans la page **Gameplay settings** de Partner Center. Pour ce faire, utilisez [https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)], en remplaçant le paramètre \[productId] par votre *Product Id*. **Comment corriger :** ```cmd theme={null} XblPCSandbox ``` Consultez [Vue d'ensemble des sandboxes](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) pour obtenir des instructions détaillées sur le changement de sandbox. *** ### ✅ 2. Votre sandbox est correct Votre PC doit se trouver dans le même sandbox de développement que celui dans lequel la configuration des services XBOX de votre jeu a été publiée. **Comment vérifier :** ```cmd theme={null} XblPCSandbox /get ``` Comparez le résultat avec le sandbox affiché dans la page **Gameplay settings** de Partner Center. Pour ce faire, utilisez [https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId](https://partner.microsoft.com/en-us/xboxconfig?appid=\[productId)], en remplaçant le paramètre \[productId] par votre *Product Id*. **Comment corriger :** ```cmd theme={null} XblPCSandbox ``` Consultez [Vue d'ensemble des sandboxes](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) pour obtenir des instructions détaillées sur le changement de sandbox. *** ### ✅ 3. Votre compte de test est valide Les comptes de test peuvent devenir non valides pour plusieurs raisons. Vérifiez tous les points suivants : #### L'accès du compte au sandbox n'a pas expiré L'accès des comptes de test aux sandboxes a une date d'expiration. Les comptes dont l'accès au sandbox a expiré ne peuvent pas se connecter au sandbox. **Comment vérifier :** 1. Accédez à [Partner Center](https://partner.microsoft.com/dashboard). 2. Sélectionnez **Apps and Games** 3. Sélectionnez **XBOX Test accounts** (ou accédez à la [gestion des comptes de test](https://partner.microsoft.com/dashboard/xbox/testaccounts)). 4. Recherchez votre compte de test et consultez les colonnes **Access Expires** et **Status**. **Comment corriger :** Si le compte a expiré, créez un nouveau compte de test ou prolongez la date d'expiration du compte existant. #### Le compte a accès à votre sandbox Lorsque vous créez un compte de test, vous devez lui accorder l'accès à des sandboxes spécifiques. **Comment vérifier :** 1. Dans Partner Center, accédez à **XBOX services** > **Test accounts**. 2. Sélectionnez votre compte de test. 3. Vérifiez que votre sandbox de développement figure dans la liste des sandboxes accessibles au compte. **Comment corriger :** Modifiez le compte de test et ajoutez votre sandbox de développement à sa liste d'accès. #### Les informations d'identification sont correctes Assurez-vous d'utiliser l'adresse e-mail et le mot de passe corrects pour le compte de test. Les adresses e-mail des comptes de test se terminent généralement par `@xboxtest.com`. *** ### ✅ 4. Les composants de jeu XBOX sont à jour Les services XBOX s'appuient sur l'application XBOX et sur le composant Gaming Services de votre PC. Une version obsolète de l'un ou l'autre peut provoquer des échecs de connexion inattendus. **Comment vérifier :** 1. Suivez les informations fournies pour l'[outil de réparation des jeux](https://support.xbox.com/en-MD/help/games-apps/troubleshooting/gaming-services-repair-tool) *** ### ✅ 5. Redémarrer votre PC Il arrive qu'un service d'arrière-plan nécessaire à la connexion (comme XBOX Live Auth Manager ou Gaming Services) se retrouve dans un état incorrect. Un redémarrage du PC peut résoudre des problèmes transitoires que les étapes ci-dessus ne détectent pas. Avant de redémarrer, il est important de signaler un bogue via le Hub de commentaires afin qu'il puisse être suivi et corrigé dans une version ultérieure. Pour ce faire, utilisez la commande suivante : ```cmd theme={null} XblPCSandbox /feedback ``` Ou, si vous passez directement par le Hub de commentaires, utilisez **Category: Gaming and XBOX** et **Area: Developer Tools** **Quand effectuer cette opération :** Si vous avez vérifié toutes les vérifications de l'environnement ci-dessus et que la connexion échoue toujours, redémarrez votre PC et réessayez avant de passer aux vérifications du projet. *** ### Vérifications du projet Ces éléments concernent spécifiquement la connexion depuis votre jeu. Si vous pouvez vous connecter à l'application XBOX mais pas depuis votre jeu, commencez ici. *** ### ✅ 6. Vos ID correspondent à Partner Center Les ID de votre `MicrosoftGame.config` doivent correspondre exactement aux valeurs de Partner Center. Une seule valeur non concordante empêche la connexion. **Comment vérifier :** Ouvrez votre `MicrosoftGame.config` et comparez ces valeurs à celles de Partner Center : | Champ de MicrosoftGame.config | Emplacement dans 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 (valeur **hexadécimale**, et non décimale) | | `MSAAppId` | **XBOX services** > **XBOX Settings** > MSA App ID (peut être un GUID ou une valeur hexadécimale) | Vérifiez également le **SCID** (Service Configuration ID). Le SCID ne figure pas dans votre `MicrosoftGame.config` : il est transmis en tant que paramètre à la méthode [XblInitialize](https://docs.xbox.com/fr/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md). Vous le trouverez sous **XBOX services** > **XBOX Settings** dans Partner Center. > [!TIP] > > Utilisez l'**assistant d'association au Store** de l'[éditeur MicrosoftGame.config](https://docs.xbox.com/fr/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) pour associer automatiquement votre jeu et réduire les risques de fautes de frappe. *** ### ✅ 7. La configuration des services XBOX est publiée dans votre sandbox Même après avoir enregistré des modifications dans Partner Center, celles-ci ne sont **pas** actives tant que vous ne les avez pas publiées dans votre sandbox de développement. **Comment vérifier :** 1. Accédez à [Partner Center](https://partner.microsoft.com/dashboard). 2. Sélectionnez votre produit. 3. Accédez à **XBOX services** > **Gameplay settings**. 4. Sélectionnez l'onglet de votre sandbox de développement. 5. Vérifiez l'état de publication. **Comment corriger :** Si les modifications n'ont pas été publiées, sélectionnez **Publish** pour les envoyer vers votre sandbox de développement. Attendez environ **30 minutes** que les modifications se propagent avant de tester à nouveau. > [!WARNING] > > Cliquer sur **Save** dans la page XBOX Settings ne publie **pas** les modifications. Vous devez explicitement les publier depuis la page **Gameplay settings**. *** ### ✅ 8. La plateforme PC est activée Si vous développez sur PC, la plateforme **Windows 10 PC** (et versions ultérieures) doit être activée pour votre titre. Sans cela, la connexion échoue avec l'erreur `0x87dd0005 (AM_E_XAST_UNEXPECTED)`. **Comment vérifier :** 1. Accédez à [Partner Center](https://partner.microsoft.com/dashboard). 2. Sélectionnez votre produit. 3. Accédez à **XBOX services** > **XBOX Settings**. 4. Vérifiez que la case **Windows 10 PC** est **cochée**. Faites de même pour les dernières versions de Windows. **Comment corriger :** 1. Cochez la case **Windows 10 PC**. 2. Sélectionnez **Save**. 3. Accédez à **Gameplay settings** et **publiez** vos paramètres dans votre sandbox de développement. 4. Attendez environ **30 minutes** avant de tester. *** ## Organigramme de diagnostic Si la liste de vérification préalable n'a pas résolu votre problème, utilisez ce processus pas à pas pour circonscrire la cause première. Commencez à l'étape 1 et suivez les branches. ``` ┌─────────────────────────────────────────────────────────┐ │ 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 │ └───────────────────────────────┘ ``` *** ## Erreurs de compte et de sandbox Si vous n'avez **pas** pu vous connecter à l'application XBOX (étape 1 de l'[organigramme de diagnostic](#organigramme-de-diagnostic)), le problème provient du changement de sandbox, du compte de test ou de l'application XBOX elle-même. ### L'utilisateur ne fait pas partie de ce sandbox (0x8015DC12) Le compte de test n'a pas accès au sandbox, ou la configuration du jeu ne correspond pas au sandbox. **Causes courantes et solutions :** | Cause | Solution | | - | - | | Les ID de `MicrosoftGame.config` ne correspondent pas à Partner Center | Consultez l'[élément 1 de la liste de vérification](#-1-vérifier-que-lid-du-sandbox-ne-contient-pas-de-faute-de-frappe) et l'[élément 2 de la liste de vérification](#-2-votre-sandbox-est-correct) | | Le compte de test n'a pas accès au sandbox | Modifiez le compte de test dans Partner Center et ajoutez votre sandbox | | L'accès du compte de test au sandbox a expiré | Vérifiez la date d'expiration dans Partner Center ; créez un nouveau compte ou prolongez-le | | Utilisation d'un sandbox isolé au lieu d'un sandbox partagé | Vérifiez le type de sandbox dans Partner Center ; passez à un sandbox partagé, sauf si vous avez une raison particulière d'utiliser un sandbox isolé. Consultez [Sandboxes isolés et sandboxes partagés](#sandboxes-isolés-et-sandboxes-partagés). | ### ID de sandbox incorrect Les erreurs courantes sont les suivantes : * Caractères manquants ou en trop : `XDKS1` au lieu de `XDKS.1` * Mauvais sandbox : basculement vers un sandbox différent de celui dans lequel la configuration de votre jeu a été publiée **Comment corriger :** 1. Exécutez `XblPCSandbox /get` et comparez le résultat avec Partner Center. 2. Réexécutez `XblPCSandbox ` avec la valeur exacte indiquée dans Partner Center. ### Mauvais sandbox pour le compte de test (erreur Garrison) Si un message d'erreur indique que votre compte devrait fonctionner dans un autre sandbox, ou si le service d'identité XBOX renvoie une erreur inattendue lors de la connexion, vous êtes probablement connecté au mauvais sandbox pour ce compte de test. **Comment corriger :** 1. Exécutez `XblPCSandbox /get` pour vérifier le sandbox défini sur votre PC. 2. Dans Partner Center, accédez à **XBOX services** > **Test accounts** et vérifiez que votre compte de test a accès à ce sandbox. 3. Si le sandbox ne correspond pas, basculez vers le bon : `XblPCSandbox ` ### Erreur de licence de l'application XBOX (0x803F8001) L'application XBOX peut ne pas se lancer si vous ne l'avez jamais ouverte en RETAIL. **Comment corriger :** 1. Basculez vers RETAIL : `XblPCSandbox /retail` (ou `XblPCSandbox RETAIL`) 2. Ouvrez l'application XBOX et laissez-la se lancer complètement. 3. Revenez à votre sandbox de développement : `XblPCSandbox ` ### Impossible de trouver l'application XBOX L'application XBOX est disponible dans le Microsoft Store, mais **uniquement lorsque vous êtes dans le sandbox RETAIL**. Si vous ne la trouvez pas : 1. Basculez vers RETAIL : `XblPCSandbox /retail` (ou `XblPCSandbox RETAIL`) 2. Recherchez « XBOX » dans le Microsoft Store et installez l'application. 3. Revenez à votre sandbox. *** ## Erreurs de configuration Si vous **pouvez** vous connecter à l'application XBOX mais **ne pouvez pas** vous connecter dans votre jeu ou dans un projet d'exemple (étape 2 de l'[organigramme de diagnostic](#organigramme-de-diagnostic)), le problème provient de la configuration des services XBOX de votre jeu. ### Plateforme PC non activée (0x87dd0005, AM\_E\_XAST\_UNEXPECTED) Cette erreur signifie que la plateforme Windows 10 PC n'a pas été ajoutée dans Partner Center. Vérifiez également les versions ultérieures. **Comment corriger :** 1. Dans Partner Center, accédez à votre produit > **XBOX services** > **XBOX Settings**. 2. Cochez la case **Windows 10 PC**. 3. Sélectionnez **Save**. 4. Accédez à **Gameplay settings** et **publiez** vos paramètres dans votre sandbox de développement. 5. Attendez **30 minutes** et réessayez de vous connecter. > [!WARNING] > > Cliquer sur **Save** dans la page XBOX Settings ne publie **pas** les modifications. Vous devez explicitement les publier depuis la page **Gameplay settings** pour que la connexion fonctionne. ### Configuration des services XBOX non publiée Les modifications enregistrées dans Partner Center ne sont pas actives tant qu'elles n'ont pas été publiées dans votre sandbox de développement. **Comment corriger :** 1. Accédez à **XBOX services** > **Gameplay settings** dans Partner Center. 2. Sélectionnez l'onglet de votre sandbox de développement. 3. Sélectionnez **Publish**. 4. Attendez environ **30 minutes** que les modifications se propagent. ### ID incorrects dans MicrosoftGame.config Une cause fréquente d'erreurs de connexion est la présence d'une ou plusieurs valeurs non concordantes dans `MicrosoftGame.config`. **Comment corriger :** Utilisez l'**assistant d'association au Store** de l'[éditeur MicrosoftGame.config](https://docs.xbox.com/fr/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md) pour associer votre jeu et remplir automatiquement les valeurs correctes. Vous pouvez aussi vérifier manuellement chaque valeur par rapport à Partner Center à l'aide de l'[élément 6 de la liste de vérification](#-6-vos-id-correspondent-à-partner-center). ### SCID incorrect dans XblInitialize Le SCID ne figure **pas** dans `MicrosoftGame.config` : il est transmis en tant que paramètre à [XblInitialize](https://docs.xbox.com/fr/reference/live/xsapi-c/xbox_live_global_c/functions/xblinitialize.md). Assurez-vous de transmettre le SCID correct indiqué dans Partner Center (**XBOX services** > **XBOX Settings**). ### Sandboxes isolés et sandboxes partagés Sauf si vous avez une raison particulière d'utiliser un sandbox isolé, utilisez un sandbox **partagé**. Vous pouvez vérifier le type de votre sandbox dans Partner Center. Les sandboxes isolés comportent des restrictions supplémentaires qui peuvent entraîner des échecs de connexion. *** ## Résolution des problèmes propres au jeu Si la connexion à l'application XBOX fonctionne **et** qu'un projet d'exemple fonctionne avec les ID de votre jeu, mais que votre jeu ne parvient toujours pas à se connecter (étape 3 de l'[organigramme de diagnostic](#organigramme-de-diagnostic)), le problème est propre au code ou à la configuration de votre jeu. ### Comparer les fichiers MicrosoftGame.config Comparez le `MicrosoftGame.config` de votre jeu à celui de l'exemple fonctionnel. Recherchez des champs en trop ou manquants, des différences de mise en forme ou des valeurs incorrectes. ### Comparer le code de connexion Comparez l'implémentation de la connexion de votre jeu avec le code de l'exemple. Recherchez des différences dans la façon dont `XUserAddAsync` est appelé (options, rappels, gestion des erreurs). ### Aucun utilisateur par défaut (0x89245106, E\_GAMEUSER\_NO\_DEFAULT\_USER) Cette erreur signifie qu'aucun utilisateur par défaut n'est actuellement connecté. **Cause :** vous avez appelé `XUserAddAsync` avec l'option `AddDefaultUserSilently`, mais aucun utilisateur n'est actuellement connecté. **Comment corriger :** Pour plus d'informations, consultez [`XUserAddAsync`](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddasync) et [AdvancedUserModel](https://docs.xbox.com/fr/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel.md). *** ## Autres solutions de dépannage ### Les services XBOX subissent une panne Si vous avez épuisé toutes les autres options, vérifiez si les services XBOX subissent une panne : * [Page d'état XBOX](https://support.xbox.com/xbox-live-status) > [!IMPORTANT] > > **Limitation connue (GDK 26.04) :** `XblPCSandbox` ne parvient pas à changer > de sandbox lorsqu'il est exécuté via une session SSH. Exécutez plutôt `XblPCSandbox` > depuis une session locale. *** ## Référence rapide des codes d'erreur | Code d'erreur | Nom | Cause probable | Solution | | - | - | - | - | | `0x8015DC12` | Utilisateur absent du sandbox | ID non concordants, absence d'accès au sandbox, accès du compte de test au sandbox expiré ou sandbox isolé | Consultez la [liste de vérification](#liste-de-vérification-préalable) ; vérifiez les ID, l'accès du compte et le type de sandbox | | `0x87dd0005` | `AM_E_XAST_UNEXPECTED` | Plateforme PC non activée dans Partner Center | Activez **Windows 10 (et versions ultérieures) PC** dans XBOX Settings, **publiez** dans le sandbox, puis attendez 30 min | | `0x89245106` | `E_GAMEUSER_NO_DEFAULT_USER` | Aucun utilisateur par défaut connecté ; appel de `XUserAddAsync(AddDefaultUserSilently)` | Consultez [`XUserAddAsync`](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddasync) et [AdvancedUserModel](https://docs.xbox.com/fr/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-advancedusermodel.md) pour savoir comment résoudre ce problème. | | `0x803F8001` | Erreur de licence | L'application XBOX n'a jamais été lancée en RETAIL | Basculez vers RETAIL, lancez l'application XBOX, puis revenez au sandbox de développement | | `0x80004005` | Échec de connexion générique | Mauvaise configuration du sandbox ou du compte ; peut également indiquer un problème côté service | Parcourez la [liste de vérification préalable](#liste-de-vérification-préalable) ; vérifiez l'ID du sandbox, l'accès du compte de test et l'expiration du compte. Si le problème persiste, essayez de redémarrer votre PC et de changer à nouveau de sandbox. | > [!NOTE] > > Si vous voyez un code d'erreur qui ne figure pas dans cette liste, signalez le problème via le Hub de commentaires. > > Utilisez xblPcSandbox /feedback pour signaler le bogue > > Ou, si vous passez directement par le Hub de commentaires, utilisez **Category: Gaming and XBOX** et **Area: Developer Tools** *** ## Voir aussi * [Vue d'ensemble des sandboxes](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) * [Vue d'ensemble conceptuelle des sandboxes avancés](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md) * [Comptes de test](https://docs.xbox.com/fr/services/xbox-services/develop/test-accounts/live-test-accounts.md) * [Vue d'ensemble de la configuration des services XBOX](https://docs.xbox.com/fr/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md) * [Vue d'ensemble de MicrosoftGame.config](https://docs.xbox.com/fr/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md) * [Référence de XblPCSandbox.exe](https://docs.xbox.com/fr/tools/tools-services/live-pc-sandbox-switcher.md) ## Related topics - [Vue d'ensemble des sandboxes des services Xbox](https://docs.xbox.com/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md) - [Résolution des problèmes de connexion aux services XBOX](https://docs.xbox.com/fr/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md) - [Sandbox](https://docs.xbox.com/fr/publishing/game-publishing/concepts/sandboxes.md) - [Résolution des problèmes](https://docs.xbox.com/fr/services/xbox-services/develop/troubleshooting/index.md) - [Changer correctement de sandbox pour les opérations du Store](https://docs.xbox.com/fr/publishing/xstore-commerce/xstore-switching-sandbox.md)