Skip to main content
Para las pruebas, es posible que los juegos quieran automatizar la adición de usuarios al juego. Con el Microsoft Game Development Kit (GDK), los usuarios solo se agregan cuando el juego llama a XUserAddAsync. Con respecto a la automatización, esta función tiene las dos limitaciones principales siguientes.
  • Si llama a XUserAddAsync con la marca AddDefaultUserSilently, no se muestra interfaz de usuario (lo que ayuda con la automatización). Sin embargo, solo puede obtener el usuario que inició el juego. Llamar a la API repetidamente con esta marca no cambia el resultado. Simplemente seguirá obteniendo nuevos identificadores para los mismos usuarios.
  • Si llama a XUserAddAsync sin la marca AddDefaultUserSilently, la interfaz de usuario aparece y espera a que alguien presione un botón. Esto interrumpe la automatización.
Para ayudar con la automatización de la adición de usuarios en el código de prueba, el Microsoft Game Development Kit (GDK) admite la activación de una opción desatendida en la que puede agregar usuarios sin que se muestre la interfaz de usuario que requiere la intervención del usuario. Los pasos siguientes describen el enfoque básico.
  1. Para agregar un usuario con sesión iniciada a la consola, puede usar la herramienta de línea de comandos xbuser (tema con NDA) con la opción signin. Repita este paso para cada usuario.
  2. Para suprimir la interfaz de usuario que normalmente se mostraría al agregar un usuario en el juego, puede usar la herramienta de línea de comandos xbconfig (tema con NDA) con la opción HeadlessXuser, como se muestra a continuación.
  1. Inicie el juego.
  2. Dentro del juego, cada llamada a XUserAddAsync que no tenga la marca AddDefaultUserSilently devuelve el primer usuario que inició sesión en la consola y que no tiene objetos XUserHandle pendientes asociados por el juego.
  3. Si el juego sigue llamando a XUserAddAsync, con el tiempo agota el número de usuarios que tienen sesión iniciada en la consola. Cuando esto sucede, XUserAddAsync devuelve E_ABORT. Este es exactamente el mismo error que XUserAddAsync habría devuelto si el usuario hubiera cancelado el inicio de sesión en la consola (o hubiera salido de la interfaz de usuario de otra forma).
  4. Con fines de prueba, es posible que los juegos quieran conocer el número de cuentas de prueba que tienen sesión iniciada en la consola. Para facilitarlo, los juegos pueden llamar a CreateProcess e iniciar la herramienta de línea de comandos wduser con la opción list.
Última modificación el 28 de agosto de 2026

Temas relacionados

UsuariosIdentidad de usuario y API de XUser en el GDKIdentidad de usuario y XUserURI de configuración desatendidaXUser