Skip to main content
Quatre types de stockage local sont accessibles sur la console XBOX One :
  • Stockage local temporaire
  • Données de jeu installées
  • Partition de travail du développeur
  • Stockage local persistant
XR-133 : Limitations d’écriture dans le stockage local
Les titres exécutés sur XBOX Series S, XBOX Series X ou toute
autre console de la même famille de consoles ne doivent pas écrire plus de 1 Gio de données dans le stockage local persistant (PLS) ou le stockage local temporaire sur une fenêtre glissante de 5 minutes. Les titres qui dépassent 1 Gio d’écritures ne réussiront pas les tests de certification. Les développeurs peuvent consulter les captures de minutage PIX pour repérer les avertissements indiquant le dépassement de la limite d’écriture. En outre, les titres peuvent surveiller leurs statistiques d’écriture au moment de l’exécution en appelant XPackageGetWriteStats. Stockage local temporaire Le stockage local temporaire est exposé aux titres en tant que lecteur T. Le stockage temporaire est accessible pendant l’exécution du titre en utilisant /x:/title avec n’importe quelle commande XtfFileIO. Le stockage local temporaire permet le stockage et la récupération à distance de fichiers temporaires, tels que des fichiers journaux. La disponibilité des fichiers écrits dans le stockage local temporaire n’est garantie que pendant l’exécution d’un titre. Rien ne garantit que les données écrites sur le lecteur T: seront conservées d’un lancement du jeu à l’autre. Le stockage temporaire peut être supprimé à un moment donné après l’arrêt du titre. Le stockage local temporaire présente également les caractéristiques suivantes :
  • 2 Go de stockage dédié
  • Le contenu est supprimé après l’arrêt du titre.
  • Le contenu est conservé lors de la suspension et de la reprise, y compris avec Quick Resume.
Données de jeu installées L’emplacement des données de jeu installées du titre en cours d’exécution est mappé au lecteur G. Ce volume est en lecture seule dans la vue du jeu en cours d’exécution lors de l’utilisation de builds empaquetées. Partition de travail du développeur La partition de travail du développeur est exposée en tant que lecteur D. La partition de travail du développeur est un stockage local destiné uniquement au développement. Vous devez exclure de la compilation toutes les références à celle-ci en mode commercial afin d’éviter tout problème potentiel. Stockage local persistant Les titres peuvent demander l’accès au stockage local persistant (PLS) dans leur manifeste. Cet espace de stockage est destiné à servir de cache à long terme pour stocker des données autres que les sauvegardes de jeu, telles que des replays et des enregistrements de jeu rendus de manière personnalisée. Le PLS n’est pas conçu pour être un espace de stockage de données principal. Il ne doit jamais être utilisé pour les sauvegardes de jeu, les mises à jour de contenu ou toute autre donnée qui doit exister pour que le titre puisse s’exécuter. Stockez plutôt les sauvegardes de jeu à l’aide de l’API Connected Storage ou, éventuellement pour les titres exclusivement en ligne, à l’aide de Title Storage des services XBOX ou d’un service de stockage cloud hébergé par l’éditeur. Le PLS présente les caractéristiques suivantes :
  • Propre au titre : cet espace de stockage n’est accessible que par le titre qui l’a demandé.
  • Propre à la console : cet espace de stockage est toujours créé dans un XVD propre à la console (même si le titre est installé sur un disque externe) et ne peut pas être utilisé sur une autre console.
  • Allocation garantie : le système s’assure que l’espace est alloué avant que le titre ne soit autorisé à démarrer. Si l’espace disponible sur le disque dur est insuffisant, l’utilisateur est invité à libérer de l’espace pour permettre l’exécution du titre.
  • Contrôlé par l’utilisateur : l’espace de stockage peut être supprimé par les utilisateurs depuis l’interface système. Le système ne supprime jamais automatiquement les éléments de cet espace.
  • Lié à la durée de vie de l’installation du titre : lorsqu’un titre est désinstallé, l’espace de stockage local associé est également supprimé. Si le titre est réinstallé, aucune des données existantes précédentes n’est restaurée.
  • Résilient et inviolable : l’espace de stockage est chiffré et son intégrité est vérifiée afin que les données enregistrées par le titre ne puissent pas être falsifiées.
Pour demander le PLS, ajoutez le balisage suivant au fichier MicrosoftGame.config en tant qu’enfant de <Game>.
Pour acquérir de l’espace de stockage local persistant, appelez XPersistentLocalStorageGetPathSize et XPersistentLocalStorageGetPath pour obtenir la taille du chemin et les données, ce qui renvoie le chemin du stockage persistant du titre. La quantité totale d’espace disponible est déterminée par ce que le titre a demandé dans la déclaration de stockage local du fichier MicrosoftGame.config. Si le titre utilise une mise à jour de contenu pour augmenter la taille de l’espace de stockage local persistant demandé, l’espace de stockage précédent sera supprimé et son contenu sera perdu lors de la mise à niveau. Stockage local persistant partageable Les titres peuvent choisir de partager leur stockage local persistant en lecture seule avec d’autres titres. Les relations qui permettent à un titre de lire le PLS d’un autre titre sont décrites ci-dessous : Pour rendre le PLS partageable, ajoutez le balisage <Shareable> au fichier MicrosoftGame.config en tant qu’enfant de <PersistentLocalStorage>.
Si un titre marque son PLS comme partageable, il doit s’assurer, avant la suspension du jeu,
de fermer tous les handles vers son PLS ; sinon, la suspension du jeu échouera et le jeu sera arrêté. Stockage local persistant extensible Le stockage local persistant extensible est une extension du PLS qui permet aux titres de demander l’accès à une quantité beaucoup plus importante d’espace de stockage local, sans réserver cet espace de manière permanente à l’avance. Il convient aux titres présentant certains scénarios qui nécessitent de l’espace supplémentaire, par exemple les téléchargements de contenu généré par l’utilisateur (UGC) ou les fichiers de replay locaux volumineux, que tous les utilisateurs n’utilisent pas forcément. Pour demander le PLS extensible, ajoutez le balisage suivant au fichier MicrosoftGame.config en tant qu’enfant de <Game>.
Avant d’écrire dans le PLS extensible, votre titre doit vérifier l’espace disponible à l’aide de l’API XPersistentLocalStorageGetSpaceInfo. Notez que l’appel de GetDiskFreeSpaceExW indique uniquement aux titres la quantité maximale d’espace libre restant dans le PLS ; cet espace n’est pas garanti disponible. XPersistentLocalStorageGetSpaceInfo renvoie également l’espace libre total ainsi que l’espace libre disponible (le minimum entre l’espace libre et l’espace réel sur le disque sous-jacent). Si votre titre a besoin de plus d’espace que celui disponible, n’a pas rempli son allocation de PLS extensible, mais que l’espace sous-jacent sur le disque est insuffisant pour augmenter le XVD du PLS, vous devez inviter l’utilisateur final à libérer l’espace supplémentaire demandé dont votre titre a besoin à l’aide de la fonction XPersistentLocalStoragePromptUserForSpaceAsync. Si le titre utilise une mise à jour de contenu pour passer d’un stockage local persistant non extensible à un espace de stockage extensible, l’espace de stockage précédent sera supprimé et son contenu sera perdu lors de la mise à niveau. Contenu téléchargeable Le contenu téléchargeable, une fois installé, peut être monté et démonté à la demande. Appelez XPackageMount pour monter le DLC et XPackageGetMountPath pour obtenir le chemin.
Ne codez jamais en dur les valeurs de chemin renvoyées, car elles peuvent varier au fil du temps et ne sont valides qu’après le montage d’un package.

​
Accès aux données de jeu avec les outils de console à distance

Les outils de console à distance peuvent utiliser le même mappage que les titres en cours d’exécution en spécifiant /title avec le commutateur /X. Les outils de console à distance peuvent alors accéder aux données écrites sur le volume de travail et aux données de jeu installées du titre actuel. Pour copier des fichiers du volume de travail vers votre PC de développement, utilisez xbcp de la manière suivante : Pour copier des fichiers de votre PC de développement vers le volume du titre, utilisez xbcp de la manière suivante : Vous ne pouvez accéder au PLS depuis un PC de développement que lorsque le titre est en cours d’exécution. Les fichiers peuvent être copiés vers et depuis cet emplacement à l’aide des commandes xb. Par exemple : Pour plus d’informations sur la syntaxe à utiliser avec les outils de console à distance pour manipuler des fichiers sur la console, consultez Copie de fichiers (xbcp.exe) (rubrique sous NDA).

​
Documentation de référence de l’API

​
Voir aussi

Vue d’ensemble des sauvegardes de jeu Hubs de jeux de franchise
Last modified on October 6, 2026