Saltar al contenido principal
Un playtest permite que un grupo seleccionado de jugadores instale una compilación de tu juego en consolas XBOX y PC, antes o después del lanzamiento, sin certificación ni ficha en Microsoft Store. Esta página te guía desde la carga de una compilación hasta compartir el playtest con los evaluadores. Información general de Playtest explica cómo funcionan los playtests. La mayoría de los comandos de esta página son experimentales, por lo que sus opciones y su salida pueden cambiar. Consulta Comandos experimentales.

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 package y playtest fallan con 403 package_permission_denied. Pídeselo a un administrador de tu cuenta de Partner Center, o pasa --seller-id si el juego pertenece a otro vendedor.
  • Inicia sesión con xbox auth login y elige un vendedor, como en Introducción.
Un playtest se ejecuta en el sandbox RETAIL. Si la compilación usa el inicio de sesión de XBOX u otros servicios XBOX, sigue primero Uso de servicios XBOX en un playtest. Los ejemplos usan el Store ID 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 con makepkg 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:
La referencia de makepkg abarca los demás formatos de paquete. Después, Partner Center procesa el paquete, lo que puede tardar un rato. Para comprobar su estado:
El paquete está listo cuando 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:
Si 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 en testers.txt, una por línea, y crea la audiencia con el comando experimental audience create:
Anota el id de la audiencia para cuando la agregues al playtest.

3. Crear el playtest

Si creaste la audiencia con audience create, usa el id que mostró. Si creaste el grupo en Partner Center, busca su ID:
Si 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-id toma el id. de paquete del paso 1. Usa --console-package-id para un paquete de consola.
  • --audience-id toma el id. de la audiencia. Repítelo para agregar más audiencias.
  • Los evaluadores pueden instalar el playtest desde --start hasta --end. Una fecha sin hora significa medianoche UTC.
El comando pregunta antes de crear el playtest y, después, lo muestra como JSON. Anota el id. del playtest, que es 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:
El comando espera hasta que el playtest está 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.
Los evaluadores recién agregados deben cerrar sesión y volver a iniciarla primero. También puedes enviar un vínculo a los evaluadores. En la página Playtest del juego en Partner Center, selecciona Share en el playtest y copia el vínculo, que empieza por 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 comandos xbox 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.
Última modificación el 19 de noviembre de 2026