Skip to main content
À des fins de test, les jeux peuvent souhaiter automatiser l’ajout d’utilisateurs. Avec le Microsoft Game Development Kit (GDK), les utilisateurs ne sont ajoutés que lorsque le jeu appelle 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 à plusieurs reprises avec cet indicateur ne change pas le résultat. Vous continuez simplement à obtenir de nouveaux handles 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) permet d’activer une option sans interface qui vous permet d’ajouter des utilisateurs sans afficher d’interface utilisateur nécessitant une intervention de l’utilisateur. Les étapes suivantes décrivent 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) 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) avec l’option HeadlessXuser, comme suit.
  1. Lancez le jeu.
  2. Dans le jeu, chaque appel à XUserAddAsync qui n’a pas l’indicateur AddDefaultUserSilently renvoie le premier utilisateur qui s’est connecté à la console et auquel le jeu n’a associé aucun objet XUserHandle en cours.
  3. Si le jeu continue d’appeler XUserAddAsync, il finit par épuiser le nombre d’utilisateurs connectés à la console. Lorsque cela se produit, XUserAddAsync renvoie E_ABORT. Il s’agit exactement de la même erreur que XUserAddAsync aurait renvoyée si l’utilisateur avait annulé la connexion à la console (ou quitté l’interface utilisateur d’une autre manière).
  4. À des fins de test, les jeux peuvent souhaiter connaître le nombre de comptes de test connectés à la console. Pour cela, les jeux peuvent appeler CreateProcess et lancer l’outil en ligne de commande wduser avec l’option list.
Last modified on October 6, 2026