> ## 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.

# Automatisation sans interface de XUser

> Automatisation sans interface de XUser

À des fins de test, les jeux peuvent vouloir automatiser l'ajout d'utilisateurs dans leur jeu. Avec le Microsoft Game Development Kit (GDK),
les utilisateurs ne sont ajoutés que lorsque le jeu appelle [XUserAddAsync](/fr-CA/reference/system/xuser/functions/xuseraddasync). En ce qui concerne
l'automatisation, cette fonction présente les deux principales limitations suivantes.

* Si vous appelez `XUserAddAsync` avec l'indicateur `AddDefaultUserSilently`, aucune interface utilisateur ne s'affiche (ce qui
  facilite l'automatisation). Toutefois, vous ne pouvez obtenir que l'utilisateur qui a lancé le jeu.
  Appeler l'API à répétition avec cet indicateur ne change pas le résultat. Vous continuerez simplement
  d'obtenir de nouveaux descripteurs pour les mêmes utilisateurs.
* Si vous appelez `XUserAddAsync` sans l'indicateur `AddDefaultUserSilently`, l'interface utilisateur
  s'affiche et attend que quelqu'un appuie sur un bouton. Cela interrompt l'automatisation.

Pour faciliter l'automatisation de l'ajout d'utilisateurs dans le code de test, le Microsoft Game Development Kit (GDK) prend en charge l'activation d'une
option sans interface qui permet d'ajouter des utilisateurs sans afficher d'interface utilisateur nécessitant une intervention de l'utilisateur. Les
étapes suivantes présentent l'approche de base.

1. Pour ajouter un utilisateur connecté à la console, vous pouvez utiliser l'outil en ligne de commande [xbuser (rubrique sous NDA)](/fr-CA/tools/tools-console/commandlinetools/xbuser)
   avec l'option `signin`. Répétez cette étape pour chaque utilisateur.
2. Pour supprimer l'interface utilisateur qui s'afficherait normalement lors de l'ajout d'un utilisateur dans le jeu, vous
   pouvez utiliser l'outil en ligne de commande [xbconfig (rubrique sous NDA)](/fr-CA/tools/tools-console/commandlinetools/xbconfig) avec l'option `HeadlessXuser`, comme suit.

```
    xbconfig HeadlessXUser=true
```

3. Lancez le jeu.
4. Dans le jeu, chaque appel à `XUserAddAsync` sans l'indicateur
   `AddDefaultUserSilently` retourne le premier utilisateur qui s'est connecté à la console et
   auquel le jeu n'a associé aucun objet `XUserHandle` en cours.
5. Si le jeu continue d'appeler `XUserAddAsync`, il finit par épuiser le nombre
   d'utilisateurs connectés à la console. Après cela, `XUserAddAsync`
   retourne `E_ABORT`. Il s'agit exactement de la même erreur que `XUserAddAsync` aurait retournée
   si l'utilisateur avait annulé la connexion à la console (ou autrement quitté
   l'interface utilisateur).
6. À des fins de test, les jeux peuvent vouloir connaître le nombre de [comptes de test](/fr-CA/services/xbox-services/develop/test-accounts/live-setup-testaccounts)
   connectés à la console. Pour faciliter cela, les jeux peuvent appeler `CreateProcess` et lancer
   l'outil en ligne de commande `wduser` avec l'option `list`.


## Related topics

- [XStore en PC: DRM, tokens de licencia y sandboxes](/es/publishing/xstore-commerce/xstore-pc.md)
- [XUser](/es/reference/system/xuser/xuser_members.md)
- [Outil de réinitialisation des données de joueur (XblPlayerDataReset.exe)](/fr/tools/tools-services/live-player-data-reset.md)
- [XStore on PC — DRM, license tokens, and sandboxes](/publishing/xstore-commerce/xstore-pc.md)
- [Automatización desatendida de XUser](/es/build/core-features/common/user/users-headless-automation.md)