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

# Sandbox

> Découvrez comment les sandbox XBOX isolent le contenu pour le développement et les tests, notamment la création de produits dans des sandbox et le contrôle de l'accès avec des MSA.

Créez des jeux XBOX dans des sandbox. Cette approche est appelée *isolation du contenu*. Lorsque vous créez un produit dans une sandbox, vous pouvez le tester dans un environnement isolé auquel seuls des utilisateurs sélectionnés peuvent accéder. L'accès est limité aux comptes Microsoft (MSA) autorisés à se connecter à la sandbox.

Les sandbox sont essentielles au développement de jeux XBOX. Elles fournissent un environnement permettant de tester les XBOX services, tels que le multijoueur et les succès, ainsi que l'expérience du Microsoft Store. Vous pouvez tester l'expérience d'installation du jeu et examiner la page de détails de votre produit (PDP) dans le Store, notamment les **Store listings**, les **Properties** et les **Gaming metadata**.

Certains types de produits prennent automatiquement en charge les sandbox. Pour d'autres types de produits, comme les offres groupées de jeux, sélectionnez **Create this product in a sandbox** lorsque vous créez le produit.

Vous devez créer votre produit dans une sandbox s'il :

* Utilise les XBOX services.
* Est un module complémentaire disposant de sa propre fiche dans le Microsoft Store.
* Est un module complémentaire dont le produit parent se trouve dans une sandbox.
* Est une offre groupée contenant des produits qui utilisent les XBOX services.
* Contient un ou plusieurs packages XVC.

## Différences entre branches et sandbox

Les branches et les sandbox sont des concepts distincts que vous utilisez souvent ensemble pendant le développement et la publication. Dans Partner Center, chaque module pris en charge possède ses propres branches. La branche **Main** est la branche par défaut. Elle apparaît automatiquement pour tous les modules lorsque vous créez le produit. Vous pouvez créer des branches supplémentaires dans chaque module pris en charge : **Packages**, **Store listings** et **Pricing and availability**. Chaque branche est propre à ce module. Par exemple :

* Une branche Test dans **Packages** est indépendante d'une branche **Test** dans **Store listings**.
* Les modifications que vous apportez dans la branche d'un module ne sont pas automatiquement répercutées dans les autres modules.

Utilisez les branches pour configurer et tester différents paramètres destinés à différentes sandbox. Par exemple, pour tester des modifications de prix sans écraser votre configuration publiée, créez une nouvelle branche dans **Pricing and availability** nommée **New pricing**, importez vos paramètres actuels depuis la branche **Main**, puis apportez les modifications souhaitées dans votre nouvelle branche. Vous pourrez importer les modifications dans la branche **Main** lorsque vous serez prêt à les publier.

Pour plus d'informations, consultez [Branches](/fr/publishing/game-publishing/concepts/branches).

## Types de sandbox

Il existe deux types de sandbox : **globales** et **de développement**.

* Les sandbox globales comprennent **RETAIL**, où les joueurs accèdent aux jeux et aux services, ainsi que d'autres sandbox utilisées pour les tests de certification.
* Les sandbox de développement sont propres à votre compte Partner Center. Vous pouvez utiliser ces sandbox pour développer et tester vos produits.

### Sandbox de développement isolées et partagées

Vous pouvez configurer les sandbox de développement comme **Isolated** (isolées) ou **Shared** (partagées).

* Tout produit de votre compte peut utiliser une sandbox **Shared**.
* Seuls les produits que vous spécifiez peuvent utiliser une sandbox **Isolated**.

Si vous configurez une sandbox comme Isolated, vous devez sélectionner les produits que vous pouvez publier dans cette sandbox. Les modules complémentaires héritent des autorisations de leur produit parent. Pour mettre à jour la liste des produits, sélectionnez la sandbox sur la page **Sandboxes**, puis sélectionnez **Manage approved products** sur la page suivante. Vous pouvez également changer le type de la sandbox entre **Isolated** et **Shared** à tout moment.

## Identificateurs de sandbox

Chaque compte Partner Center a accès à 100 sandbox de développement. Chaque sandbox de développement possède un identificateur unique composé de deux parties : un préfixe propre à votre compte Partner Center, par exemple ABCDEF, et une valeur numérique comprise entre 0 et 99. Ensemble, ces parties forment l'ID de sandbox, par exemple **ABCDEF.1**.

Les sandbox globales sont nommées sans valeur numérique, par exemple **RETAIL**.

Il est courant de disposer :

* D'une ou plusieurs sandbox pour le développement. Par exemple, une sandbox pour chacune de vos équipes de développement.
* D'une ou plusieurs sandbox pour l'assurance qualité. Par exemple, une sandbox pour votre équipe d'assurance qualité interne et une sandbox pour chaque équipe d'assurance qualité externe avec laquelle vous travaillez.
* D'une sandbox pour la préparation à la certification, servant d'emplacement pour préparer et tester les versions candidates que vous soumettez à la certification.

Cette structure permet à vos équipes de rester agiles et concentrées sur leur partie du produit.

## Créer et gérer des sandbox de développement

Lorsque vous créez un nouveau jeu dans une sandbox, vous sélectionnez une sandbox de développement principale sur la page **Game setup**. Si vous n'avez créé aucune sandbox, sélectionnez **Manage sandboxes** pour accéder à la page **Sandboxes** et créer votre première sandbox de développement. Créez de nouvelles sandbox de développement selon vos besoins en revenant à la page **Sandboxes**. Celle-ci est accessible depuis le tableau de bord **Apps and games** et la page de configuration de votre produit.

Pour plus d'informations, consultez : [Comment créer et gérer des sandbox de développement](/fr/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes).

## Créer et gérer des comptes de test

Vous devez vous connecter à une sandbox à l'aide d'un MSA autorisé avant de pouvoir accéder aux produits ou aux XBOX services publiés dans cette sandbox. Les sandbox globales, comme **RETAIL**, utilisent des MSA standard. Les sandbox de développement utilisent des comptes de test XBOX que vous créez dans Partner Center. Vous contrôlez les sandbox auxquelles chaque compte de test peut accéder. Pour créer et configurer des comptes de test, accédez au tableau de bord **Apps and games**, puis sélectionnez **XBOX test accounts**. Vous pouvez alors :

* Créer des lots de comptes de test.
* Afficher et modifier les propriétés d'un lot de comptes de test, comme le type de compte et l'accès aux sandbox.
* Afficher les détails d'un lot de comptes de test, comme l'adresse e-mail, le gamertag, le XUID et les autorisations de chaque compte de test du lot.
* Supprimer des lots de comptes de test.

Pour plus d'informations, consultez [Comment créer et gérer des comptes de test XBOX](/fr/publishing/game-publishing/how-to/how-to-create-and-manage-test-accounts).

## Publier un produit dans une sandbox

Publiez votre produit dans une sandbox pour le consulter ou le tester.

### Publier les XBOX services

Si vous devez uniquement publier les XBOX services d'un jeu, accédez à **Gameplay settings**, sélectionnez **Publish**, puis sélectionnez l'emplacement où publier les paramètres.

### Publier un produit

Pour publier un produit, utilisez l'option **Review and publish**. Vous pouvez y accéder depuis la page **Overview** de votre produit. Sur la page **Review and publish**, sélectionnez la destination souhaitée dans la liste déroulante **Publish to**. Si vous sélectionnez **RETAIL**, vous ne pouvez publier qu'à partir de la branche **Main** de votre produit. Si vous sélectionnez une sandbox de développement, vous choisissez la source dans **Publish from**. Vous pouvez sélectionner **RETAIL**, si le produit est déjà publié dans cette sandbox, ou **Custom**. La sélection de **Custom** vous permet de choisir, pour chacun des modules de votre produit, la branche contenant la configuration souhaitée.

Après avoir sélectionné **Publish**, surveillez l'état de la publication en consultant les informations affichées sur la page **Overview**. Vous pouvez sélectionner **History** pour consulter les détails des publications précédentes.

<Note>
  La seule sandbox globale dans laquelle vous pouvez publier est RETAIL. Pour soumettre des mises à jour à la certification, utilisez le workflow **Certify**.
</Note>

## Tester un produit dans une sandbox

Après avoir publié dans une sandbox, connectez-vous à la sandbox avec un compte autorisé. Si vous avez uniquement publié les XBOX services, vous pouvez vous connecter aux services à l'aide d'un package déployé sur votre appareil via les outils du Game Development Kit (GDK). Si vous avez publié le produit complet, sa disponibilité dans le Microsoft Store de la sandbox dépend du **Schedule** configuré dans le module **Pricing and availability**. Pour plus d'informations, consultez [Configurer un produit pour qu'il soit visible et achetable dans le Microsoft Store](/fr/publishing/game-publishing/how-to/how-to-visible-release).

Si vous avez configuré le module **Pricing and availability** de votre produit avec une date de **Release** ou une date **Discoverable in the Microsoft Store** dans le futur, vous ne pouvez pas le trouver à l'aide de la fonctionnalité de recherche du Microsoft Store. Vous pouvez trouver le produit à l'aide du lien de protocole du Store figurant sur la page **Setup** du produit dans Partner Center.

<Note>
  Si vous avez configuré une [audience privée](/fr/publishing/game-publishing/concepts/availability/visibility-audiences) dans la section **Visibility** du module **Pricing and availability** de votre produit, cela n'affecte pas la visibilité de votre produit dans une sandbox de développement. **Private audience** s'applique uniquement aux produits publiés dans la sandbox RETAIL.
</Note>

## Gérer les autorisations d'un utilisateur au niveau des sandbox

Lorsque vous [ajoutez des utilisateurs à votre compte Partner Center](https://learn.microsoft.com/windows/apps/publish/partner-center/overview-users-groups-azure-ad-applications), vous pouvez [accorder des autorisations personnalisées](https://learn.microsoft.com/windows/apps/publish/partner-center/overview-of-roles-and-permissions-for-account-users). Pour les autorisations au niveau du compte **Test accounts** et **XBOX devices**, vous pouvez sélectionner les sandbox spécifiques pour lesquelles l'utilisateur dispose de ces autorisations. Pour ce faire, sélectionnez l'autorisation, puis sélectionnez **All sandboxes** ou une ou plusieurs sandbox individuelles. Cocher **All sandboxes** accorde l'autorisation à toutes les sandbox existantes et à toutes celles qui seront créées à l'avenir. Pour accorder l'autorisation à toutes les sandbox actuelles mais pas aux futures, décochez **All sandboxes**, puis sélectionnez chaque sandbox individuellement.

## Voir aussi

* [Comment créer et gérer des sandbox de développement](/fr/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes)
* [Branches](/fr/publishing/game-publishing/concepts/branches)
* [Vérifier et publier](/fr/publishing/game-publishing/concepts/modular-submission)
* [Gérer les utilisateurs du compte](https://learn.microsoft.com/windows/apps/publish/partner-center/manage-account-users)


## Related topics

- [Sandboxes](/publishing/game-publishing/concepts/sandboxes.md)
- [Setting up sandboxes](/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)
- [PC Sandbox Switcher (XblPCSandbox.exe)](/tools/tools-services/live-pc-sandbox-switcher.md)
- [Create and manage development sandboxes](/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes.md)
- [XBOX services sandboxes overview](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)