Résolution des erreurs de connexion et de sandbox

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
Organigramme de diagnostic
Erreurs de compte et de sandbox
Erreurs de configuration
Résolution des problèmes propres au jeu
Autres solutions de dépannage
Référence rapide des codes d’erreur

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.

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

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 :

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], en remplaçant le paramètre [productId] par votre Product Id. Comment corriger :

XblPCSandbox <your sandbox ID>

Consultez Vue d’ensemble des sandboxes 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 :

XblPCSandbox /get

XblPCSandbox <your sandbox ID>

Consultez Vue d’ensemble des sandboxes 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 :

Accédez à Partner Center.
Sélectionnez Apps and Games
Sélectionnez XBOX Test accounts (ou accédez à la gestion des comptes de test).
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 :

Dans Partner Center, accédez à XBOX services > Test accounts.
Sélectionnez votre compte de test.
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 :

Suivez les informations fournies pour l’outil de réparation des jeux

✅ 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 :

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. Vous le trouverez sous XBOX services > XBOX Settings dans Partner Center.

Utilisez l’assistant d’association au Store de l’éditeur MicrosoftGame.config 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 :

Accédez à Partner Center.
Sélectionnez votre produit.
Accédez à XBOX services > Gameplay settings.
Sélectionnez l’onglet de votre sandbox de développement.
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.

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 :

Accédez à Partner Center.
Sélectionnez votre produit.
Accédez à XBOX services > XBOX Settings.
Vérifiez que la case Windows 10 PC est cochée. Faites de même pour les dernières versions de Windows.

Comment corriger :

Cochez la case Windows 10 PC.
Sélectionnez Save.
Accédez à Gameplay settings et publiez vos paramètres dans votre sandbox de développement.
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), 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 et l’élément 2 de la liste de vérification
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.

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 :

Exécutez XblPCSandbox /get et comparez le résultat avec Partner Center.
Réexécutez XblPCSandbox <correct sandbox ID> 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 :

Exécutez XblPCSandbox /get pour vérifier le sandbox défini sur votre PC.
Dans Partner Center, accédez à XBOX services > Test accounts et vérifiez que votre compte de test a accès à ce sandbox.
Si le sandbox ne correspond pas, basculez vers le bon : XblPCSandbox <correct sandbox ID>

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 :

Basculez vers RETAIL : XblPCSandbox /retail (ou XblPCSandbox RETAIL)
Ouvrez l’application XBOX et laissez-la se lancer complètement.
Revenez à votre sandbox de développement : XblPCSandbox <your sandbox ID>

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 :

Basculez vers RETAIL : XblPCSandbox /retail (ou XblPCSandbox RETAIL)
Recherchez « XBOX » dans le Microsoft Store et installez l’application.
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), 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 :

Dans Partner Center, accédez à votre produit > XBOX services > XBOX Settings.
Cochez la case Windows 10 PC.
Sélectionnez Save.
Accédez à Gameplay settings et publiez vos paramètres dans votre sandbox de développement.
Attendez 30 minutes et réessayez de vous connecter.

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 :

Accédez à XBOX services > Gameplay settings dans Partner Center.
Sélectionnez l’onglet de votre sandbox de développement.
Sélectionnez Publish.
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 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.

SCID incorrect dans XblInitialize

Le SCID ne figure pas dans MicrosoftGame.config : il est transmis en tant que paramètre à XblInitialize. 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), 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 et AdvancedUserModel.

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

[!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 ; 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` et AdvancedUserModel 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 ; 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.

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 bogueOu, si vous passez directement par le Hub de commentaires, utilisez Category: Gaming and XBOX et Area: Developer Tools

Voir aussi

Dernière modification le 20 octobre 2026

⌘I

XBOX Services

PlayFab

Dans cet article

Liste de vérification préalable

Vérifications de l’environnement

✅ 1. Vérifier que l’ID du sandbox ne contient pas de faute de frappe

✅ 2. Votre sandbox est correct

✅ 3. Votre compte de test est valide

L’accès du compte au sandbox n’a pas expiré

Le compte a accès à votre sandbox

Les informations d’identification sont correctes

✅ 4. Les composants de jeu XBOX sont à jour

✅ 5. Redémarrer votre PC

Vérifications du projet

✅ 6. Vos ID correspondent à Partner Center

✅ 7. La configuration des services XBOX est publiée dans votre sandbox

✅ 8. La plateforme PC est activée

Organigramme de diagnostic

Erreurs de compte et de sandbox

L’utilisateur ne fait pas partie de ce sandbox (0x8015DC12)

ID de sandbox incorrect

Mauvais sandbox pour le compte de test (erreur Garrison)

Erreur de licence de l’application XBOX (0x803F8001)

Impossible de trouver l’application XBOX

Erreurs de configuration

Plateforme PC non activée (0x87dd0005, AM_E_XAST_UNEXPECTED)

Configuration des services XBOX non publiée

ID incorrects dans MicrosoftGame.config

SCID incorrect dans XblInitialize

Sandboxes isolés et sandboxes partagés

Résolution des problèmes propres au jeu

Comparer les fichiers MicrosoftGame.config

Comparer le code de connexion

Aucun utilisateur par défaut (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

Autres solutions de dépannage

Les services XBOX subissent une panne

Référence rapide des codes d’erreur

Voir aussi

​Dans cet article

​Liste de vérification préalable

​Vérifications de l’environnement

​✅ 1. Vérifier que l’ID du sandbox ne contient pas de faute de frappe

​✅ 2. Votre sandbox est correct

​✅ 3. Votre compte de test est valide

​L’accès du compte au sandbox n’a pas expiré

​Le compte a accès à votre sandbox

​Les informations d’identification sont correctes

​✅ 4. Les composants de jeu XBOX sont à jour

​✅ 5. Redémarrer votre PC

​Vérifications du projet

​✅ 6. Vos ID correspondent à Partner Center

​✅ 7. La configuration des services XBOX est publiée dans votre sandbox

​✅ 8. La plateforme PC est activée

​Organigramme de diagnostic

​Erreurs de compte et de sandbox

​L’utilisateur ne fait pas partie de ce sandbox (0x8015DC12)

​ID de sandbox incorrect

​Mauvais sandbox pour le compte de test (erreur Garrison)

​Erreur de licence de l’application XBOX (0x803F8001)

​Impossible de trouver l’application XBOX

​Erreurs de configuration

​Plateforme PC non activée (0x87dd0005, AM_E_XAST_UNEXPECTED)

​Configuration des services XBOX non publiée

​ID incorrects dans MicrosoftGame.config

​SCID incorrect dans XblInitialize

​Sandboxes isolés et sandboxes partagés

​Résolution des problèmes propres au jeu

​Comparer les fichiers MicrosoftGame.config

​Comparer le code de connexion

​Aucun utilisateur par défaut (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

​Autres solutions de dépannage

​Les services XBOX subissent une panne

​Référence rapide des codes d’erreur

​Voir aussi

Dans cet article

Liste de vérification préalable

Vérifications de l’environnement

✅ 1. Vérifier que l’ID du sandbox ne contient pas de faute de frappe

✅ 2. Votre sandbox est correct

✅ 3. Votre compte de test est valide

L’accès du compte au sandbox n’a pas expiré

Le compte a accès à votre sandbox

Les informations d’identification sont correctes

✅ 4. Les composants de jeu XBOX sont à jour

✅ 5. Redémarrer votre PC

Vérifications du projet

✅ 6. Vos ID correspondent à Partner Center

✅ 7. La configuration des services XBOX est publiée dans votre sandbox

✅ 8. La plateforme PC est activée

Organigramme de diagnostic

Erreurs de compte et de sandbox

L’utilisateur ne fait pas partie de ce sandbox (0x8015DC12)

ID de sandbox incorrect

Mauvais sandbox pour le compte de test (erreur Garrison)

Erreur de licence de l’application XBOX (0x803F8001)

Impossible de trouver l’application XBOX

Erreurs de configuration

Plateforme PC non activée (0x87dd0005, AM_E_XAST_UNEXPECTED)

Configuration des services XBOX non publiée

ID incorrects dans MicrosoftGame.config

SCID incorrect dans XblInitialize

Sandboxes isolés et sandboxes partagés

Résolution des problèmes propres au jeu

Comparer les fichiers MicrosoftGame.config

Comparer le code de connexion

Aucun utilisateur par défaut (0x89245106, E_GAMEUSER_NO_DEFAULT_USER)

Autres solutions de dépannage

Les services XBOX subissent une panne

Référence rapide des codes d’erreur

Voir aussi