> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tu primer playtest

> Carga una compilación de un juego de XBOX y, a continuación, crea, publica y comparte un playtest de ella con la XBOX CLI y Partner Center.

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](https://learn.microsoft.com/gaming/game-publishing/concepts/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](https://docs.xbox.com/es/tools/xbox-cli/cli-command-lifecycle.md).

## 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](https://docs.xbox.com/es/tools/xbox-cli/getting-started.md).

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](https://docs.xbox.com/es/tools/xbox-cli/xbox-services-in-a-playtest.md).

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`:

```text theme={null}
makepkg upload /d layout /msixvc2 /pc /storeid 9N0000000000 /branch Main
```

La [referencia de makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/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:

```bash theme={null}
xbox package list --store-id 9N0000000000 --output table
```

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`:

```bash theme={null}
xbox package list --store-id 9N0000000000
```

Si `STATE` es `ProcessFailed`, `PLAYTEST` sigue siendo `false` o hay un elemento `Error`, revisa los
requisitos del paquete en [Requisitos previos de un playtest](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#prerequisites-for-a-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`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience#creating-an-audience):

```bash theme={null}
xbox audience create --name "Nod Arena testers" --members-file testers.txt
```

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`:

```bash theme={null}
xbox audience list --output table
```

Si `xbox audience list` agota el tiempo de espera, un [problema conocido](https://docs.xbox.com/es/tools/xbox-cli/known-issues.md#xbox-audience-list-can-time-out),
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:

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena playtest" --start 2026-12-01 --end 2026-12-15 --pc-package-id 11111111-2222-3333-4444-555555555555 --audience-id 1152921504606846976
```

* `--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:

```bash theme={null}
xbox playtest publish 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

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:

| Código de salida | Significado |
| - | - |
| 1 | Las comprobaciones de Partner Center fallaron, por ejemplo, porque el playtest no tiene paquete, audiencia ni clasificaciones por edades. No se publica nada. Corrige las comprobaciones que enumera el comando y vuelve a publicar. |
| 2 | La publicación falló. |
| 3 | El resultado es desconocido. Comprueba el playtest con `xbox playtest get` antes de volver a publicar. |
| 4 | El playtest sigue publicándose después de 5 minutos. Compruébalo más tarde con `xbox playtest get`. |

Consulta [Publicar un playtest](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest.md#publishing-a-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](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#share-a-playtest-with-testers).

## Scripts e integración continua

Puedes cargar paquetes desde canalizaciones de integración continua (CI) con una entidad de servicio. Consulta
[Cargar paquetes](https://docs.xbox.com/es/tools/xbox-cli/commands/package.md#uploading-packages). 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)](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

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`.


## Related topics

- [Uso de Playtest](https://docs.xbox.com/es/publishing/game-publishing/concepts/playtest-preview.md)
- [XBOX CLI](https://docs.xbox.com/es/tools/xbox-cli/index.md)
- [Introducción](https://docs.xbox.com/es/tools/xbox-cli/getting-started.md)
- [Incorporación de partners de XBOX para acceso y publicación](https://docs.xbox.com/es/home/onboarding.md)
- [Playtest](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest.md)
