Passer au contenu principal
Cette rubrique décrit ce qu’est Title Storage des services XBOX et quelles sont ses fonctionnalités, et montre comment les configurer. Le service Title Storage des services XBOX fournit un stockage infonuagique pour de grandes quantités de données par joueur ou par jeu. Vous pouvez l’utiliser pour stocker les statistiques et les actifs des joueurs. Les jeux s’exécutant sur toutes les plateformes XBOX peuvent utiliser Title Storage.

Fonctionnalités de Title Storage des services XBOX

Title Storage des services XBOX offre les fonctionnalités générales suivantes.
  • Peut être partagé entre joueurs, titres et différentes plateformes
  • Prend en charge les fichiers JSON, binaires et de configuration

Types de stockage

Limite de limitation

Le nombre de lectures et d’écritures qu’un titre peut effectuer par minute n’est pas limité, mais il ne peut généralement pas en effectuer plus d’une par minute en moyenne, par session d’une heure. Par exemple, un titre peut effectuer 60 lectures ou écritures au début d’une session, mais plus aucune pendant le reste de l’heure. Les titres doivent être conçus pour résister à l’impossibilité d’effectuer d’autres appels par la suite, au cas où les services XBOX devraient limiter les requêtes.
Si votre titre a des exigences de partitionnement particulières, comme des lectures ou des écritures supplémentaires, communiquez avec votre représentant Microsoft.

Types de données

Cette section décrit les trois types pris en charge.

Informations binaires

Les informations binaires comprennent des éléments tels que des images, des sons et des données personnalisées. Comme les données doivent être transmises par HTTP, les données binaires doivent être encodées en caractères acceptés par HTTP. Par exemple, vous pouvez convertir les données en chaînes hexadécimales ou utiliser l’encodage base64. Title Storage ne traite pas les données encodées; votre jeu doit donc utiliser le même schéma d’encodage et de décodage lors de la lecture et de l’écriture dans Title Storage.

Informations JSON

Les informations JSON comprennent des données structurées (paires clé-valeur). Vous pouvez utiliser des objets JSON dans les langages qui les prennent en charge, comme JavaScript. Lorsque vous récupérez des données à partir de fichiers JSON, le jeu peut fournir un paramètre selectQuery pour retourner des éléments spécifiques de la structure. Par exemple, vous pourriez utiliser un fichier JSON contenant les informations suivantes.
Pour des raisons de sécurité, le premier élément des données JSON ne doit pas être un tableau. Les données JSON soumises avec un tableau à la racine sont rejetées par le service.
Votre jeu peut sélectionner des parties de la structure JSON sous forme de selectQuery (par exemple, weapon.name) ; il reçoit alors ce qui suit :

Informations de configuration

Les objets blob de configuration sont des structures de données stockées dans le stockage de titre global. Le format d’un objet blob de configuration est similaire à celui d’un objet JSON. Les objets blob de configuration peuvent inclure des nœuds virtuels qui retournent un paramètre parmi une liste de possibilités. Les nœuds virtuels sont utiles pour fournir des paramètres adaptés à des situations spécifiques, par exemple pour un titre ou des paramètres régionaux. Le nœud virtuel comprend plusieurs paramètres possibles avec des valeurs et des conditions de sélection parmi ces valeurs. Dans l’exemple suivant, le paramètre defaultCardDesign peut prendre l’une des valeurs du nœud virtuel.
Lorsqu’un jeu lit ce fichier, le système sélectionne l’une des valeurs du tableau \_sourceNodes. Dans ce cas, l’élément est sélectionné en fonction de l’ID de titre du jeu. Par exemple, les joueurs du jeu 12456799 verraient ce qui suit :
Les joueurs qui ne jouent pas à ce jeu verraient ce qui suit :
Les jeux peuvent définir des sélecteurs personnalisés qui correspondent à un paramètre de la requête. Par exemple, considérez l’objet JSON suivant dans cet objet blob de configuration.
Les jeux transmettent une chaîne dans le paramètre customSelector pour sélectionner l’élément à retourner. Par exemple, pour obtenir la deuxième option, un jeu demande gameMode.serious en tant que selectQuery.

Bien démarrer avec Title Storage des services XBOX

  1. Déterminez le type de données que vous voulez stocker. Il peut s’agir, par exemple, de parties enregistrées, de l’état du jeu, de défis quotidiens, de cartes de jeu et de ressources graphiques.
  2. Déterminez quels titres et quelles plateformes doivent accéder aux données. Title Storage prend en charge l’accès aux données infonuagiques depuis un seul titre sur une seule plateforme, ainsi que depuis plusieurs titres sur plusieurs plateformes.
Dernière modification le 8 octobre 2026