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

# Uso de servicios XBOX en un playtest

> Prepara la configuración de los servicios XBOX de un juego para un playtest, desde los servicios XBOX completos y los logros hasta el embargo y la publicación en RETAIL.

Un playtest se ejecuta en el sandbox RETAIL, el entorno en vivo que usan los jugadores. Cuando la compilación usa
el inicio de sesión de XBOX, los logros, la presencia u otros servicios XBOX, el juego necesita los servicios XBOX completos,
y su configuración de servicios XBOX debe publicarse en RETAIL. Los evaluadores usan entonces los mismos
servicios XBOX en vivo que los jugadores de un juego lanzado. Consulta
[Servicios XBOX y Playtest](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#xbox-services-and-playtest).

Sigue estos pasos una vez, antes de [crear el playtest](https://docs.xbox.com/es/tools/xbox-cli/first-playtest.md):

1. [Obtén los servicios XBOX completos](#1-get-full-xbox-services).
2. [Elige qué ocurre con los logros](#2-choose-what-happens-to-achievements).
3. [Establece el embargo](#3-set-the-embargo).
4. [Publica la configuración en RETAIL](#4-publish-the-configuration-to-retail).

Los ejemplos usan el id. de título de XBOX `1234ABCD` y un sandbox de desarrollo, `XDKS.1`, que contiene
la configuración con la que se probó la compilación.

## 1. Obtener los servicios XBOX completos

Un juego nuevo empieza con los servicios XBOX deshabilitados. Los servicios XBOX limitados solo funcionan en sandboxes
de desarrollo y no incluyen logros ni estadísticas. Una vez aprobado el concepto de tu juego, envía el
Store ID del juego a tu representante de XBOX y pídele que incorpore el producto. Después, selecciona
**Enable full XBOX services** en la página **Game setup** del juego en Partner Center. Consulta
[Habilitar los servicios XBOX](https://docs.xbox.com/publishing/game-publishing/concepts/xbox-services.md#enable-xbox-services).

Hasta entonces, la configuración con logros no supera la validación:

```text theme={null}
XblLimited products do not support achievements or stats2013/stats2015 configuration.
```

## 2. Elegir qué ocurre con los logros

Los logros publicados en RETAIL son permanentes. Todavía puedes cambiar sus nombres, descripciones
e ilustraciones, pero no puedes quitarlos ni cambiar sus reglas de desbloqueo ni su puntuación de jugador. Las estadísticas publicadas en
RETAIL tampoco se pueden eliminar. El sistema de logros del juego, administrado por el título o basado en eventos,
queda fijado con la primera publicación en RETAIL. Antes de esa publicación, elige una de estas opciones:

| Opción | Úsala cuando | Cómo |
| - | - | - |
| Publicar los logros definitivos | Los logros son definitivos. | Publica como de costumbre. En un juego no lanzado, el embargo del paso siguiente los oculta a otros jugadores. |
| Solicitar una invalidación de validación | El diseño de los logros debe cambiar durante el playtest. | Pide a tu representante de XBOX una invalidación de validación durante el desarrollo. Quítala antes de enviar el juego a certificación. |

Un juego para PC o consolas XBOX no puede omitir la publicación de sus logros en RETAIL. En Partner
Center, responder **No** a **Publish Achievements to Retail?** produce este error:

```text theme={null}
The specified Platform:Windows can be used only when game is configured to Publish Achievements.
```

Todos los logros publicados deben cumplir los Requisitos de XBOX para logros y puntuación de jugador. Consulta
[Logros](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#achievements).

## 3. Establecer el embargo

El embargo oculta a los jugadores los logros, la presencia y otros datos de los servicios XBOX del juego en
la aplicación XBOX y en la interfaz de usuario de la consola hasta la fecha que elijas, y bloquea las capturas de pantalla y de vídeo.
Sin él, los jugadores ajenos al playtest pueden ver la configuración del juego.

Establece un embargo solo para un juego que aún no se ha lanzado. En un juego lanzado, un nuevo embargo oculta
sus datos de servicios XBOX a sus jugadores.

En Partner Center, abre **XBOX services** > **XBOX settings**, ve a **Embargo date** y establece
una fecha y hora UTC posteriores al final del playtest y no posteriores al lanzamiento público del juego.
Si el playtest se prolonga más allá del lanzamiento, finaliza el embargo en el lanzamiento. Selecciona
**Allow Multiplayer Invites in Embargo** si los evaluadores se invitan entre sí a sesiones multijugador.
Consulta [Configurar la fecha de embargo](https://docs.xbox.com/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md#configure-embargo-date).

El embargo es una opción de configuración de todo el título, almacenada en el sandbox `ALL`, y se aplica a todos los sandboxes.
Para comprobarlo, descarga `ALL`:

```bash theme={null}
xbox xbl config download --title-id 1234ABCD --sandbox-id ALL --view draft --dest xbox-config-all
```

`productdeveloper.xml` contiene el embargo:

```xml theme={null}
<XboxLiveEmbargoDate>2027-03-01T17:00:00Z</XboxLiveEmbargoDate>
<EmbargoInvitesEnabled>true</EmbargoInvitesEnabled>
```

El embargo entra en vigor cuando se publica la configuración de todo el título. Si Partner Center muestra
cambios sin publicar, publícalos allí o con `--sandbox-id HIDDEN`:

> [!WARNING]
>
> Una publicación de todo el título publica todos los cambios pendientes de todo el título, no solo el embargo, y esos
> cambios también llegan a RETAIL. Revisa primero los cambios pendientes.

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --sandbox-id HIDDEN
```

El comando pregunta antes de publicar. Consulta
[Selección del origen](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl.md#source-selection).

La publicación es asincrónica. Antes de publicar en RETAIL, comprueba que `lastPublish` muestra que la
publicación de todo el título se realizó correctamente:

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id HIDDEN
```

## 4. Publicar la configuración en RETAIL

Publica la configuración del sandbox de desarrollo directamente en RETAIL. RETAIL no requiere una
publicación previa en CERT ni la certificación.

> [!WARNING]
>
> Una publicación en RETAIL está disponible para los jugadores en cuanto termina, y los logros publicados no se pueden
> quitar. Consulta [Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md).

Valida primero. La validación no cambia nada y enumera los logros que agrega la publicación:

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD \
  --source-sandbox-id XDKS.1 --sandbox-id RETAIL --validate-only
```

Si la validación muestra la advertencia `FirstRetailPublishWithoutEffectiveEmbargo`, todavía no hay ningún embargo
en vigor. Completa el [paso 3](#3-set-the-embargo), incluida la publicación de todo el título.

Publicar desde `XDKS.1` reemplaza los documentos de trabajo de RETAIL que tienen los mismos nombres, así como
los archivos de almacenamiento global del título de RETAIL, y elimina los archivos que solo contiene RETAIL. Consulta
[Publicación entre sandboxes](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl.md#cross-sandbox-publishing-replaces-global-title-storage-files).

Cuando la validación no muestre problemas, publica. El comando describe la publicación y pregunta primero:

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --source-sandbox-id XDKS.1 --sandbox-id RETAIL
```

Comprueba `lastPublish` hasta que termine la publicación:

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id RETAIL
```

Después, [crea y publica el playtest](https://docs.xbox.com/es/tools/xbox-cli/first-playtest.md).


## Related topics

- [XBOX CLI](https://docs.xbox.com/es/tools/xbox-cli/index.md)
- [Tu primer playtest](https://docs.xbox.com/es/tools/xbox-cli/first-playtest.md)
- [Uso de Playtest](https://docs.xbox.com/es/publishing/game-publishing/concepts/playtest-preview.md)
- [Configuración de los servicios de XBOX](https://docs.xbox.com/es/publishing/game-publishing/concepts/xbox-services.md)
- [Uso en el cliente de los privilegios de usuario de los servicios XBOX](https://docs.xbox.com/es/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client.md)
