Saltar al contenido principal
Un playtest permite que un grupo seleccionado de jugadores pruebe un juego antes de su lanzamiento. Los comandos playtest leen los playtests de un juego en Partner Center, y los crean, actualizan, publican y eliminan. create, update, publish y delete preguntan antes de hacer un cambio. create, update, publish y delete son experimentales: sus opciones y su salida pueden cambiar o quitarse. Consulta Comandos experimentales.

Comandos

Argumentos y opciones

Ejemplos

Enumera playtests, obtén uno y compara dos:
Crea un playtest para una audiencia:
Cambia la fecha de finalización de un playtest:
Publica un playtest:
Elimina un playtest:

Lectura de playtests

playtest list escribe una matriz playtests. Su tabla tiene las columnas PLAYTEST ID, NAME, STATUS, TYPE, START y END. Un extracto:
playtest get escribe el playtest tal como lo devuelve el servicio. etag es la versión que se debe pasar a update --if-match, y audiences.audienceIds enumera las audiencias que pueden unirse. Su tabla tiene filas FIELD y VALUE. playtest diff escribe hasDiffData, current y compared. Cuando hasDiffData es false, no hay nada que comparar y se omite compared. Su tabla muestra solo los campos que difieren, en las columnas FIELD, CURRENT y COMPARED. Las imágenes no se comparan.

Creación de un playtest

playtest create crea un playtest privado en borrador y lo escribe como lo hace playtest get. Volver a ejecutarlo crea otro playtest; quita uno que no quieras con playtest delete. Cada creación envía una clave de idempotencia, un GUID nuevo a menos que pases --idempotency-key. Una creación que repite una clave devuelve el playtest que creó esa clave e ignora las opciones que difieran. Cuando el resultado es desconocido, por ejemplo después de un tiempo de espera agotado, el comando sale con 3 e imprime un comando que reintenta con la misma clave:
El reintento devuelve el playtest si la primera solicitud lo creó y, de lo contrario, lo crea. Cuando una opción contiene un salto de línea, solo se imprime la clave; ejecuta el mismo comando con --idempotency-key y esa clave. Si el reintento se rechaza, por ejemplo porque la fecha de finalización ya ha pasado, comprueba playtest list antes de crear el playtest con una clave nueva.

Paquetes

Un playtest puede tener un paquete de PC y un paquete de consola. Elige un paquete que esté listo para un playtest en xbox package list y pasa su id a la opción de su plataforma:
En update, una opción de paquete que omites conserva su paquete, un identificador nuevo lo reemplaza y "" lo quita:

Actualización de un playtest

Cualquier actualización devuelve un playtest publicado a borrador, igual que si lo editas en Partner Center. Vuelve a publicarlo con playtest publish para que esté disponible para los jugadores.
playtest update cambia solo las opciones que pasas y necesita al menos una. Escribe el playtest actualizado como lo hace playtest get. Se conserva el arte del juego configurado en Partner Center; el resto del arte vinculado al playtest se reemplaza por un marcador de posición. Para evitar sobrescribir el cambio de otra persona, pasa el etag de playtest get en --if-match. Las comillas dobles que lo rodean son opcionales, y se rechazan *, los etags débiles (W/) y las listas de etags:
Cuando el resultado es desconocido, el comando sale con 3. Comprueba el playtest con playtest get antes de reintentar.

Elección de audiencias

Una audiencia es un grupo de jugadores, como evaluadores, que el vendedor administra en Partner Center. Pasa un id de audience list a --audience-id, y repítelo para agregar más:
Sin --audience-id, create crea un playtest sin audiencias y update las conserva. En update, los identificadores que pasas reemplazan todas las audiencias del playtest. Para quitar todas las audiencias, pasa "" solo:
"" no se puede combinar con identificadores de audiencia, y create lo rechaza. Un playtest necesita al menos una audiencia para poder publicarse.

Publicación de un playtest

Si el juego usa servicios XBOX, prepara su configuración y su embargo antes de publicar. Consulta Usar servicios XBOX en un playtest.
La publicación ofrece el playtest a sus audiencias a partir de su fecha de inicio. El comando publica la versión que lee primero; si el playtest cambia entretanto, la publicación produce un error 412 y no cambia nada. Antes de pedirte confirmación, el comando comprueba la configuración de servicios XBOX del juego, por ejemplo si su fecha de embargo es posterior a la fecha de finalización del playtest, y enumera en stderr todo lo que se debe revisar. Estas comprobaciones solo son orientativas; --confirm publica sin preguntar. A continuación, el servicio ejecuta sus propias comprobaciones. Cuando una bloquea la publicación, no se pone nada en cola, y el comando enumera cada comprobación en stderr y sale con 1. Corrige los errores y vuelve a publicar. Un playtest bloqueado por falta de clasificaciones por edades necesita que se complete el cuestionario de clasificación por edades en Partner Center. Una vez que la publicación está en cola, el comando espera hasta que el playtest esté en estado Scheduled, Live o PublishFailed, y lo escribe como lo hace playtest get. Ctrl+C deja de esperar, pero la publicación continúa. Con --no-wait, el comando escribe publishJobId y cualquier warnings en cuanto la publicación está en cola; haz su seguimiento con playtest get.

Eliminación de un playtest

playtest delete elimina la versión del playtest que lee primero. Espera hasta que el playtest esté en estado Deleted o haya desaparecido y, a continuación, escribe la respuesta del servicio, con status. Ctrl+C deja de esperar, pero la eliminación continúa. Con --no-wait, escribe la respuesta en cuanto la eliminación está en cola. Después de un 412, es posible que la eliminación ya esté en cola, así que espera un minuto y comprueba con playtest get antes de volver a eliminar.

Fechas

--start y --end aceptan fechas y horas ISO 8601, como 2026-11-01T09:00:00-07:00 o 2026-11-01T16:00:00Z. Una fecha sin hora significa medianoche UTC, y una hora sin desplazamiento está en UTC. Cuando una actualización pasa solo una fecha, el servicio la comprueba con la otra fecha del playtest.

Errores

Los errores van a stderr y salen con 1, a menos que las tablas de códigos de salida anteriores indiquen lo contrario. create y update salen con 3 cuando su resultado es desconocido. Un error que devuelve el servicio incluye su estado HTTP, y --verbose agrega la respuesta del servicio, cuyo campo code se muestra aquí: Para otros errores, el comando muestra el mensaje del servicio. Un 429 significa que enviaste demasiadas solicitudes; espera el tiempo que indique el mensaje antes de volver a intentarlo.
Última modificación el 19 de noviembre de 2026