Skip to main content
À 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. 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) 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 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.
  3. 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).
  4. À des fins de test, les jeux peuvent vouloir connaître le nombre de comptes de test 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.
Last modified on October 6, 2026