Outil XBOX Connected Storage (XblConnectedStorage.exe) - XBOX Game Development Documentation

L’outil XBOX Connected Storage permet de télécharger des sauvegardes de jeu. Il peut télécharger les sauvegardes de n’importe quel sandbox, y compris RETAIL. C’est utile pour déboguer des problèmes difficiles à reproduire. Cet outil en ligne de commande fait partie du Microsoft Game Development Kit (GDK) et de XboxLiveTools.zip ; voir Outils de développement pour les services XBOX. Il est également disponible dans le GDK à partir de la version 2104. XblConnectedStorage.exe permet de télécharger les données de stockage connecté d’un utilisateur. L’outil XBOX services Developer Account (XblDevAccount.exe) est nécessaire pour se connecter avec un compte de développeur avant d’utiliser l’outil XBOX Connected Storage.

Utilisation

L’outil Connected Storage permet de récupérer un fichier XML représentant la sauvegarde de jeu au format de fichier d’importation et d’exportation (rubrique sous NDA). Le fichier XML est destiné à être utilisé avec l’outil xbstorage.exe), qui permet d’importer les données du fichier XML dans un espace de stockage connecté à utiliser avec le XBOX Development Kit. L’outil gère automatiquement la décompression des sauvegardes compressées au format gzip. Trois conditions sont requises pour récupérer le fichier XML d’une sauvegarde de jeu :

Un compte de développeur disposant de l’autorisation de lecture Tools Access. Pour en savoir plus, consultez les [autorisations nécessaires pour utiliser l’outil Connected Storage][#permissions-needed-to-use-the-tool]].
L’ID de configuration de service (SCID) du titre. Vous le trouverez dans Partner Center.
Le gamertag classique de l’utilisateur dont la sauvegarde doit être récupérée.

Exemple d’utilisation en ligne de commande.

XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe

Options de ligne de commande

Utilisez l’option --help pour afficher la liste complète des options de ligne de commande prises en charge par l’outil. Depuis la version 2020.6.0.0, la sortie est la suivante :

XblConnectedStorage 2020.6.0.0
Copyright (C) 2021 Microsoft Corporation
USAGE:
Downloads the Connected Storage data for this user to ./output/xbstorage.xml:
XblConnectedStorage --scid 00000000-0000-0000-0000-0000628cd0f2 --gamertag CrazyGiraffe --output ./output/xbstorage.xml
 --sandbox TEST.0

  -c, --scid        Required. The service configuration ID (SCID) of the title

  -s, --sandbox     Required. The target sandbox for title storage

  -g, --gamertag    Required. The legacy gamertag of the player to retrieve storage for

  -o, --output      (Default: ./output/xbstorage.xml) The output file to write the xbstorage xml file to.

  --help            Display this help screen.

  --version         Display version information.

Autorisations nécessaires pour utiliser l’outil

La protection de la vie privée des utilisateurs et des données de sauvegarde de jeu est importante. Un compte de développeur doit disposer de certaines autorisations pour accéder aux données de sauvegarde de jeu avec l’outil XBOX Connected Storage. Pour afficher ou modifier ces autorisations pour un compte de développeur, procédez comme suit :

Ouvrez la page Gestion des utilisateurs dans Microsoft Partner Center
Sélectionnez l’utilisateur ou le groupe dont vous voulez afficher ou modifier les autorisations
Cliquez sur le lien “Customize Permissions”
Sélectionnez le produit dont vous voulez afficher ou modifier les autorisations
Sélectionnez “XBOX Live”
Sélectionnez “Tools Access”

Un compte de développeur disposant de l’autorisation de lecture “Tools Access” est nécessaire pour télécharger les sauvegardes de jeu de ce produit.

Comprendre les messages d’erreur

500 Internal Server Error

Cette erreur se produit lorsque vous tentez d’accéder à une combinaison SCID/sandbox à laquelle le compte de développeur actuel n’a pas l’autorisation d’accéder. Pour savoir comment résoudre ce problème, consultez la section Autorisations nécessaires pour utiliser l’outil de ce document.

​Utilisation

​Exemple d’utilisation en ligne de commande.

​Options de ligne de commande

​Autorisations nécessaires pour utiliser l’outil

​Comprendre les messages d’erreur

​500 Internal Server Error