Antes de empezar
- Una cuenta de Partner Center configurada para desarrollar juegos para XBOX, con un juego. Los playtests no necesitan una solicitud de acceso independiente.
- Clasificaciones por edades del juego. Completa una vez el cuestionario de la International Age Rating Coalition (IARC) en la página Age ratings del juego en Partner Center. Sin ellas, no se puede publicar un playtest.
- Permiso para administrar los paquetes del juego en Partner Center. Sin él, los comandos
packageyplaytestfallan con 403package_permission_denied. Pídeselo a un administrador de tu cuenta de Partner Center, o pasa--seller-idsi el juego pertenece a otro vendedor. - Inicia sesión con
xbox auth loginy elige un vendedor, como en Introducción.
9N0000000000. Busca el Store ID de tu juego con
xbox game list --output table.
1. Cargar un paquete
La CLI no carga paquetes. Carga la compilación conmakepkg del Kit de desarrollo de juegos (GDK) de XBOX de octubre de 2026
o posterior. Para un juego de PC cuya compilación está en la carpeta layout:
STATE es Processed y PLAYTEST es true. Anota su PACKAGE ID.
La tabla no muestra los resultados de la validación, así que comprueba en JSON que sus validationItems no contengan ningún
elemento con gravedad Error:
STATE es ProcessFailed, PLAYTEST sigue siendo false o hay un elemento Error, revisa los
requisitos del paquete en Requisitos previos de un playtest.
2. Crear una audiencia
Una audiencia decide quién puede instalar el playtest. Partner Center la denomina grupo de clientes. En el área de trabajo Apps and games de Partner Center, selecciona Customer groups y, a continuación, Create new group. Elige Known user group, agrega a tus evaluadores y guárdalo. O bien, enumera las direcciones de correo electrónico de tus evaluadores entesters.txt, una por línea, y crea la audiencia con el
comando experimental audience create:
id de la audiencia para cuando la agregues al playtest.
3. Crear el playtest
Si creaste la audiencia conaudience create, usa el id que mostró. Si creaste el
grupo en Partner Center, busca su ID:
xbox audience list agota el tiempo de espera, un problema conocido,
omite --audience-id al crear el playtest. Después, en Partner Center, abre el
playtest desde la página Playtest del juego en Services, elige el grupo del paso 2 y guárdalo
sin publicarlo.
Crea el playtest:
--pc-package-idtoma el id. de paquete del paso 1. Usa--console-package-idpara un paquete de consola.--audience-idtoma el id. de la audiencia. Repítelo para agregar más audiencias.- Los evaluadores pueden instalar el playtest desde
--starthasta--end. Una fecha sin hora significa medianoche UTC.
playtestId dentro de details.
Si el comando sale con 3, no pudo determinar si se creó el playtest. Vuelve a intentarlo con el
comando que muestra, que no creará un segundo playtest.
4. Publicarlo
Publica el playtest con el id. del paso 3:Live, o Scheduled si aún no ha llegado su fecha de inicio,
y sale con 0. Otros códigos de salida significan que el playtest todavía no está publicado:
Consulta Publicar un playtest.
5. Compartirlo
Una vez que el playtest está activo, los evaluadores de su audiencia pueden encontrarlo en su biblioteca:- En una consola, en Biblioteca completa, con el filtro Playtest.
- En un PC, en la Biblioteca de la aplicación XBOX, con el filtro Acceso.
msxbox://playtest/. La CLI todavía no puede
mostrar este vínculo. Solo funciona para las personas de la audiencia del playtest y, en un PC, abre el
playtest en la aplicación XBOX. Consulta
Compartir un playtest con los evaluadores.
Scripts e integración continua
Puedes cargar paquetes desde canalizaciones de integración continua (CI) con una entidad de servicio. Consulta Cargar paquetes. Los comandosxbox package y
xbox playtest todavía no aceptan una entidad de servicio, por lo que necesitan un usuario que haya iniciado sesión. Consulta
Autenticación para automatización (entidad de servicio).
En un script que se ejecuta mientras has iniciado sesión, pasa --confirm a playtest create y
playtest publish, porque sin un terminal no pueden preguntarte y no realizan ningún cambio. Lee el
JSON que muestran y comprueba sus códigos de salida. Para esperar más de 5 minutos a que termine una publicación, pasa
--timeout.