Passer au contenu principal

Configuration des sandboxes pour le développement avec les services XBOX

Avant d’utiliser les services XBOX depuis votre jeu, vous devez configurer en ligne les informations relatives à votre titre dans Partner Center. Ces informations comprennent des fonctionnalités comme les classements que votre titre souhaite afficher, les succès que les joueurs peuvent débloquer, la configuration du matchmaking, etc. Lorsque vous modifiez votre configuration de service, vous devez publier ces modifications depuis Partner Center pour qu’elles soient prises en compte par les services XBOX. Vous les publiez dans un sandbox de développement, un environnement isolé dans lequel vous pouvez travailler sur votre titre sans affecter la version en ligne. Par défaut, les consoles XBOX One (ou ultérieures) et les PC Windows 10 (ou ultérieurs) se trouvent dans le sandbox RETAIL. Pour plus d’informations, consultez également Sandboxes avancés des services XBOX.

Dans cet article


Avantages des sandboxes

Les sandboxes de développement offrent plusieurs avantages :
  • Itérer en toute sécurité. Vous pouvez modifier la configuration de service de votre titre sans affecter la version actuellement disponible.
  • Accès aux outils. Pour des raisons de sécurité, certains outils ne fonctionnent que dans un sandbox de développement.
  • Créer des branches de votre configuration. Les développeurs de votre équipe peuvent tester des modifications de la configuration de service dans des sandboxes distincts sans s’affecter mutuellement.
  • Confidentialité. Les autres éditeurs ne peuvent pas voir ce sur quoi vous travaillez sans avoir obtenu l’accès à votre sandbox.

ID de sandbox

Chaque sandbox possède un identificateur unique qui respecte la casse. Les sandboxes de développement suivent une convention de nommage basée sur le moniker de votre éditeur (par exemple, XDKS.1 ou XLDP.5). On parle d’ID de sandbox et, dans certains cas, de nom de sandbox.
Les ID de sandbox respectent la casse. XDKS.1 n’est pas identique à xdks.1 ou Xdks.1. Toutefois, l’outil XblPCSandbox.exe corrige automatiquement la casse lorsque vous changez de sandbox sur PC. Tous les ID de sandbox sont en majuscules. Reportez-vous toujours à Partner Center pour connaître l’ID de sandbox exact.

Quelles données sont isolées par sandbox ?

Les données des services XBOX ne sont pas toutes concernées par les sandboxes. Les données isolées par sandbox sont propres à chaque sandbox : elles n’existent que dans le sandbox où elles ont été créées et ne sont pas visibles depuis les autres sandboxes. Les données non isolées sont partagées globalement entre tous les sandboxes, y compris RETAIL. Principales conséquences :
  • Les succès obtenus dans un sandbox ne sont pas transférés vers un autre sandbox.
  • Les utilisateurs de sandboxes différents ne peuvent pas être associés ni jouer ensemble en multijoueur.
  • La configuration de service publiée dans un sandbox n’est pas visible dans un autre.

Comptes de test

Vous pouvez créer des comptes de test à utiliser pour le développement et les tests au lieu de votre compte XBOX personnel. C’est l’option recommandée pour travailler avec les sandboxes. Les comptes de test :
  • Ne peuvent se connecter **qu’**aux sandboxes de développement (et non à RETAIL).
  • Peuvent se voir accorder l’accès à des sandboxes spécifiques.
  • Peuvent avoir une date d’expiration que vous pouvez consulter et gérer dans Partner Center.
  • Peuvent avoir des comptes enfants, ce qui vous permet de tester des scénarios comme les interactions sociales ou le multijoueur.
Si vous rencontrez des difficultés pour vous connecter avec un compte de test, consultez la section Résolution des erreurs de connexion et de sandbox pour plus de détails.
Pour plus d’informations, consultez également Comptes de test.

Utilisation de plusieurs sandboxes

Plusieurs sandboxes sont utiles dans des scénarios plus avancés :
  • Isolement de la configuration de service. Utilisez un sandbox Development pour le développement actif et un sandbox Testing pour votre équipe d’assurance qualité. Les modifications que vous publiez dans Development n’affectent pas ce que voient les testeurs.
  • Isolement du multijoueur. Maintenez les développeurs et les testeurs dans des sandboxes distincts afin que le matchmaking ne mélange pas les deux groupes pendant les tests.
Si vous faites partie du programme XBOX Creators, vous ne pouvez disposer que d’un seul sandbox. Pour créer plusieurs sandboxes, vous devez faire partie du programme Managed Partners.
Pour plus de détails sur l’isolement des sandboxes, les instances de produit et les scénarios impliquant plusieurs organisations, consultez Sandboxes avancés des services XBOX.

Place des sandboxes dans votre flux de travail

Voici le flux de travail type lors de l’utilisation des sandboxes :
  1. Basculez votre appareil vers votre sandbox de développement. Consultez les instructions pour PC ou console ci-dessous, selon l’environnement que vous prévoyez de configurer.
  2. Publiez les modifications dans votre sandbox de développement au fil de vos itérations sur la configuration de service.
  3. Partagez l’accès avec les membres de l’équipe qui doivent travailler dans le même sandbox.
  4. Revenez à RETAIL lorsque vous devez tester dans l’environnement commercial, mettre à jour les applications système ou jouer à d’autres jeux.

Configurer votre sandbox sur PC

Changer de sandbox à l’aide de XblPCSandbox.exe (recommandé)

XblPCSandbox.exe est un outil en ligne de commande inclus dans le GDK. C’est la méthode recommandée pour changer de sandbox sur PC. Pour obtenir des informations plus détaillées sur l’utilisation de XblPCSandbox.exe et de ses arguments, consultez XBOX Live PC Sandbox Switcher (XblPCSandbox.exe)

Configurer votre sandbox sur console

Cette section explique comment basculer votre console XBOX One (ou ultérieure) vers un sandbox de développement afin de tester votre jeu avec les services XBOX.

Utilisation du XBOX Device Portal

Vous pouvez utiliser le XBOX Device Portal pour modifier le sandbox de votre console. Pour ce faire, accédez à « Dev Home » sur votre console et activez-le. Vous pouvez ensuite saisir l’adresse IP dans le navigateur web de votre PC pour vous connecter à votre console. Sélectionnez alors XBOX Live et saisissez le sandbox dans la zone de texte.

Utilisation de XBOX Manager

XBOX Manager est destiné aux consoles XBOX One ou ultérieures. XBOX Manager vous permet d’administrer certains aspects de votre console depuis votre PC, notamment le redémarrage, la gestion des applications installées et le changement de sandbox. Cliquez avec le bouton droit sur la console dont vous souhaitez modifier le sandbox, puis accédez à Settings… Vous pouvez alors y saisir un sandbox.

Utilisation de l’interface de la console XBOX

Si vous souhaitez modifier votre sandbox de développement directement depuis votre console XBOX One (ou ultérieure), accédez à Paramètres, puis à Paramètres du développeur : une option permettant de modifier votre sandbox s’affiche.

Et ensuite ?

Si vous avez rencontré des problèmes lors du changement de sandbox, consultez Résolution des erreurs de connexion et de sandbox pour suivre un processus de diagnostic guidé et consulter la référence des codes d’erreur.

Voir aussi

Dernière modification le 20 octobre 2026