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

# Utiliser les XBOX services dans un test de jeu

> Préparez la configuration des XBOX services d'un jeu pour un test de jeu, des XBOX services complets et des succès jusqu'à l'embargo et à la publication dans RETAIL.

Un test de jeu s'exécute dans le sandbox RETAIL, l'environnement en ligne qu'utilisent les joueurs. Lorsque le build utilise
la connexion XBOX, les succès, la présence ou d'autres XBOX services, le jeu a besoin des XBOX services complets,
et sa configuration des XBOX services doit être publiée dans RETAIL. Les testeurs utilisent alors les mêmes
XBOX services en ligne que les joueurs d'un jeu commercialisé. Consultez
[XBOX services et Playtest](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#xbox-services-and-playtest).

Effectuez ces étapes une seule fois, avant de [créer le test de jeu](https://docs.xbox.com/fr-CA/tools/xbox-cli/first-playtest.md) :

1. [Obtenir les XBOX services complets](#1-get-full-xbox-services).
2. [Choisir ce qu'il advient des succès](#2-choose-what-happens-to-achievements).
3. [Définir l'embargo](#3-set-the-embargo).
4. [Publier la configuration dans RETAIL](#4-publish-the-configuration-to-retail).

Les exemples utilisent l'ID de titre XBOX `1234ABCD` et un sandbox de développement, `XDKS.1`, qui contient
la configuration avec laquelle le build a été testé.

## 1. Obtenir les XBOX services complets

Un nouveau jeu démarre avec les XBOX services désactivés. Les XBOX services limités fonctionnent uniquement dans les sandboxes
de développement et n'incluent ni les succès ni les statistiques. Une fois le concept de votre jeu approuvé, envoyez le
Store ID du jeu à votre représentant XBOX et demandez-lui d'intégrer le produit. Sélectionnez ensuite
**Enable full XBOX services** sur la page **Game setup** du jeu dans Partner Center. Consultez
[Activer les XBOX services](https://docs.xbox.com/publishing/game-publishing/concepts/xbox-services.md#enable-xbox-services).

D'ici là, une configuration comportant des succès échoue à la validation :

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

## 2. Choisir ce qu'il advient des succès

Les succès publiés dans RETAIL sont permanents. Vous pouvez toujours modifier leur nom, leur description
et leurs illustrations, mais vous ne pouvez pas les retirer ni modifier leurs règles de déverrouillage ou leur gamerscore. Les statistiques publiées dans
RETAIL ne peuvent pas non plus être supprimées. Le système de succès du jeu, géré par le titre ou basé sur les événements, est
fixé par la première publication dans RETAIL. Avant cette publication, choisissez l'une de ces options :

| Choix | Quand l'utiliser | Comment |
| - | - | - |
| Publier les succès définitifs | Les succès sont définitifs. | Publiez comme d'habitude. Pour un jeu non commercialisé, l'embargo de l'étape suivante les masque aux autres joueurs. |
| Demander une dérogation de validation | La conception des succès doit changer pendant le test de jeu. | Demandez à votre représentant XBOX une dérogation de validation pour la période de développement. Retirez-la avant de soumettre le jeu à la certification. |

Un jeu pour PC ou consoles XBOX ne peut pas omettre la publication de ses succès dans RETAIL. Dans Partner
Center, répondre **No** à **Publish Achievements to Retail?** échoue avec :

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

Tous les succès publiés doivent respecter les Exigences XBOX relatives aux succès et au gamerscore. Consultez
[Succès](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#achievements).

## 3. Définir l'embargo

L'embargo masque les succès, la présence et les autres données des XBOX services du jeu aux joueurs dans
l'application XBOX et l'interface utilisateur de la console jusqu'à une date que vous choisissez, et bloque les captures d'écran et les captures vidéo.
Sans embargo, les joueurs extérieurs au test de jeu peuvent voir la configuration du jeu.

Définissez un embargo uniquement pour un jeu qui n'est pas encore commercialisé. Sur un jeu commercialisé, un nouvel embargo masque
les données de ses XBOX services à ses joueurs.

Dans Partner Center, ouvrez **XBOX services** > **XBOX settings**, accédez à **Embargo date** et définissez
une date et une heure UTC postérieures à la fin du test de jeu, et au plus tard à la date de sortie publique du jeu.
Si le test de jeu se poursuit au-delà de la sortie, terminez l'embargo à la sortie. Sélectionnez
**Allow Multiplayer Invites in Embargo** si les testeurs s'invitent mutuellement à des sessions multijoueurs.
Consultez [Configurer la date d'embargo](https://docs.xbox.com/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md#configure-embargo-date).

L'embargo est un paramètre à l'échelle du titre, stocké dans le sandbox `ALL`, et s'applique à tous les sandboxes.
Pour le vérifier, téléchargez `ALL` :

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

`productdeveloper.xml` contient l'embargo :

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

L'embargo entre en vigueur lorsque la configuration à l'échelle du titre est publiée. Si Partner Center affiche
des modifications non publiées, publiez-les dans Partner Center, ou avec `--sandbox-id HIDDEN` :

> [!WARNING]
>
> Une publication à l'échelle du titre publie toutes les modifications en attente à l'échelle du titre, et pas seulement l'embargo, et ces
> modifications atteignent aussi RETAIL. Passez d'abord en revue les modifications en attente.

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

La commande demande une confirmation avant de publier. Consultez
[Sélection de la source](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl.md#source-selection).

La publication est asynchrone. Avant de publier dans RETAIL, vérifiez que `lastPublish` indique que la
publication à l'échelle du titre a réussi :

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

## 4. Publier la configuration dans RETAIL

Publiez la configuration du sandbox de développement directement dans RETAIL. RETAIL ne nécessite ni
publication préalable dans CERT ni certification.

> [!WARNING]
>
> Une publication dans RETAIL est en ligne pour les joueurs dès qu'elle est terminée, et les succès publiés ne peuvent pas
> être retirés. Consultez [Sécurité et opérations destructrices](https://docs.xbox.com/fr-CA/tools/xbox-cli/safety.md).

Commencez par valider. La validation ne modifie rien et répertorie les succès que la publication ajoute :

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

Si la validation affiche l'avertissement `FirstRetailPublishWithoutEffectiveEmbargo`, aucun embargo n'est encore
en vigueur. Terminez l'[étape 3](#3-set-the-embargo), y compris la publication à l'échelle du titre.

La publication à partir de `XDKS.1` remplace les documents de travail de RETAIL qui portent les mêmes noms, ainsi que les
fichiers de stockage global du titre de RETAIL, en supprimant tous les fichiers que seul RETAIL contient. Consultez
[Publication entre sandboxes](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl.md#cross-sandbox-publishing-replaces-global-title-storage-files).

Lorsque la validation ne signale aucun problème, publiez. La commande décrit la publication et demande d'abord une confirmation :

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

Vérifiez `lastPublish` jusqu'à ce que la publication soit terminée :

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

Ensuite, [créez et publiez le test de jeu](https://docs.xbox.com/fr-CA/tools/xbox-cli/first-playtest.md).


## Related topics

- [Votre premier test de jeu](https://docs.xbox.com/fr-CA/tools/xbox-cli/first-playtest.md)
- [XBOX CLI](https://docs.xbox.com/fr-CA/tools/xbox-cli/index.md)
- [Utiliser Playtest](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/playtest-preview.md)
- [Configurer les XBOX services pour un jeu](https://docs.xbox.com/fr-CA/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md)
- [Intégration d'un moteur personnalisé pour PC : prise en main (C/C++)](https://docs.xbox.com/fr-CA/build/gdk-and-engines/custom-engine.md)
