Vue d’ensemble
Cette rubrique explique comment obtenir les ID nécessaires pour configurer les sandboxes et configurer votre application afin d’utiliser les services XBOX. Un sandbox assure l’isolement du contenu pour un kit de développement individuel, offrant un environnement propre pour le développement et les tests. Les services XBOX fournissent des fonctionnalités en ligne telles que les événements, les succès et les fonctionnalités multijoueur. Pour activer les sandboxes et utiliser les services XBOX, vous devez obtenir plusieurs ID afin de configurer votre kit de développement et votre titre. Ces opérations peuvent être effectuées au moyen du même processus. Le processus est le suivant.- Obtenez vos ID.
- Définissez vos sandboxes sur vos kits de développement.
- Liez le TitleID à votre titre, ainsi que d’autres identificateurs facultatifs.
ID essentiels
Trois ID sont essentiels au développement de titres et d’applications pour XBOX One (ou version ultérieure) : l’ID de sandbox, le TitleID et l’identificateur de configuration de service (SCID). Bien qu’un ID de sandbox soit nécessaire pour utiliser un kit de développement, le TitleID et le SCID ne sont pas requis pour le développement initial, mais le sont pour toute utilisation des services XBOX. Nous vous recommandons donc d’obtenir les trois en même temps.ID de sandbox
Le sandbox assure l’isolement du contenu de votre kit de développement pendant le développement, ce qui vous garantit un environnement propre pour développer et tester votre titre. L’ID de sandbox identifie votre sandbox. Une console ne peut accéder qu’à un seul sandbox à la fois, mais un même sandbox peut être utilisé par plusieurs consoles. Les ID de sandbox respectent la casse.TitleID
Le TitleID identifie de manière unique votre titre auprès des services XBOX. Le TitleID est utilisé dans l’ensemble des services pour permettre à vos utilisateurs d’accéder notamment au contenu XBOX de votre titre, à leurs statistiques utilisateur et à leurs succès, et pour activer les fonctionnalités multijoueur XBOX. Les Title ID peuvent respecter la casse, selon la manière et l’endroit où ils sont utilisés.Identificateur de configuration de service (SCID)
Dans le cadre du développement, vous créerez des événements, des succès et de nombreuses autres fonctionnalités en ligne. Tous ces éléments font partie de votre configuration de service et nécessitent le SCID pour y accéder. Contrairement à une version antérieure du système d’exploitation XBOX, les titres développés pour le Game OS du Microsoft GDK ne disposent que d’un seul SCID ; toutes les instances d’un titre au sein d’un sandbox donné partagent donc la même configuration. Les SCID du Game OS du Microsoft GDK sont toujours un GUID ayant la même valeur que le TitleID, précédé de zéros. Pour la grande majorité des interactions d’un titre Microsoft Game Development Kit (GDK) avec les services XBOX, il n’est plus nécessaire de spécifier explicitement le SCID, mais il peut être requis en cas d’interaction directe avec les points de terminaison REST des services XBOX. Les SCID respectent la casse.Obtention de vos ID
Pour l’instant, vous obtenez vos ID en collaborant avec votre gestionnaire de compte développeur.Configuration d’un sandbox
Vous ne pourrez pas démarrer votre kit de développement sans définir votre ID de sandbox. Pour ce faire, ouvrez une fenêtre de commande du GDK et utilisez la commande Configuration (xbconfig.exe) (rubrique sous NDA) comme suit.- Vérifiez votre sandbox actuel. Saisissez xbconfig sandboxid à l’invite de commandes.
- S’il ne correspond pas à ce que vous attendez, modifiez votre ID de sandbox. Saisissez xbconfig sandboxid=<your sandbox id> à l’invite de commandes.
- Redémarrez votre console à l’aide de Reboot (xbreboot.exe) (rubrique sous NDA) à l’invite de commandes.
- Vérifiez que votre sandbox a été correctement redéfini. Saisissez xbconfig sandboxid à l’invite de commandes.
Ajout du TitleID et d’autres identificateurs facultatifs à votre binaire
Alors que le sandbox est configuré au niveau de la plateforme pour chaque kit de développement, le TitleID est lié à un binaire spécifique. Pour ajouter un TitleID à votre binaire, modifiez le fichier MicrosoftGame.config de ce binaire en ajoutant un nouveau nœud dans le nœud<Game>, comme suit.
Depuis le Microsoft Game Development Kit (GDK) de mars 2022, le MSAAppId et le TitleId sont tous deux requis si l’un d’eux est spécifié dans le MicrosoftGame.config. Pour plus d’informations, consultez Élément MicrosoftGame.config - MSAAppId et Élément MicrosoftGame.config - TitleId.
L’indicateur RequiresXboxLive
Si l’indicateur RequiresXboxLive est défini sur true, le titre ne se lance que s’il existe une connexion active au réseau XBOX et que le titre réussit l’authentification auprès des services XBOX. Cela garantit que le titre a bien reçu les dernières mises à jour de contenu. Si la connexion est perdue pendant l’exécution du titre, celui-ci est suspendu, puis arrêté. Seuls les titres qui « nécessitent Internet » doivent définir RequiresXboxLive sur true. Notez que marquer ainsi votre titre ne garantit pas que les services requis par le titre sont opérationnels. RequiresXboxLive est également un nœud situé sousGame dans le fichier MicrosoftGame.config.