Passer au contenu principal
Les données de titre sont un ensemble de paires clé-valeur en texte brut, utilisées pour stocker et gérer à distance, sur le serveur, les données de configuration du jeu. Elles permettent de garder accessibles et organisées les variables de configuration à l’échelle du titre, qui peuvent être récupérées côté client. Ce démarrage rapide explique comment créer et utiliser des données de titre par programmation. Il s’agit d’un sujet important, car le stockage des données de configuration d’un jeu à distance sur le serveur, où elles peuvent être modifiées à tout moment, est l’une des raisons les plus fondamentales d’utiliser un service comme PlayFab.

Obtention des données de titre

Depuis le client de jeu

Utilisez GetTitleData de PlayFabClientAPI pour obtenir les KVP d’un titre spécifique. L’exemple de code suivant affiche les valeurs de toutes les données de titre.

Depuis le serveur de jeu

Utilisez GetTitleData de PlayFabServerAPI pour obtenir les KVP d’un titre spécifique. L’exemple de code suivant affiche les valeurs de toutes les données de titre.

Définition des données de titre

Il est peu probable que les données de titre changent très fréquemment. Dans la plupart des cas, vous devez utiliser vos données de titre pour des données statiques qui restent pratiquement inchangées pendant toute la durée de vie du titre. Vous pouvez définir les données de titre à l’aide de Game Manager ou d’une fonction de l’API serveur.

Définition des données de titre à l’aide de Game Manager

Pour ajouter des données de titre principales à un titre à l’aide de Game Manager, procédez comme suit.
  1. Ouvrez le titre dans Game Manager.
  2. Sélectionnez Content, puis Title Data.
  3. Sélectionnez New Title Data
  4. Dans la page des nouvelles données de titre, entrez une valeur pour Key et une valeur pour Value. Key et Value sont tous deux stockés sous forme de chaînes.
  5. Utilisez le bouton Save pour enregistrer le nouvel élément de données.
La capture d'écran montre de nouvelles données de titre. Capture d'écran des données de titre

Définition des données de titre en appelant l’API serveur en C

L’API SetTitleData est une API serveur que vous devez appeler depuis un serveur dédié. Vous ne pouvez définir qu’une seule KVP de données de titre par appel à SetTitleData.

Définition des remplacements de données de titre à l’aide de Game Manager

Un remplacement est également un ensemble de paires clé-valeur JSON, idéalement destiné à contenir les modifications différentielles requises dans les paires clé-valeur des données de titre principales. Par rapport aux données de titre principales, ces modifications différentielles peuvent comprendre de nouvelles paires clé-valeur, la modification de la valeur d’une clé existante ou la suppression d’une clé (avec NULL comme valeur). Pour ajouter des remplacements aux données de titre principales, procédez comme suit.
  1. Ouvrez le titre dans Game Manager.
  2. Sélectionnez Content, puis Title Data.
  3. Sélectionnez New Override.
  4. Entrez l’Override Label, puis entrez une valeur pour Key et une valeur pour Value. Key et Value sont tous deux stockés sous forme de chaînes.
  5. Utilisez le bouton Save pour enregistrer le nouveau remplacement des données de titre.
Pour l’instant, cet ensemble de paires clé/valeur de remplacement ne prend effet qu’avec Experiments.
Si le joueur appartient à une variante d’expérience contenant des remplacements de données de titre, ceux-ci sont appliqués automatiquement côté serveur et renvoyés avec les données de titre côté client.
L’actualisation et la conservation des valeurs de remplacement des données de titre peuvent prendre jusqu’à une minute.
La capture d'écran montre un nouveau remplacement de données de titre. La capture d'écran montre comment définir un nouveau remplacement de données de titre. La capture d'écran montre les données de titre et le remplacement.

Données de titre internes

Comme les données utilisateur, les données de titre disposent d’un stockage interne masqué pour le client. Ces données peuvent également être définies dans Game Manager ou via une API serveur.

Obtention des données de titre internes en appelant l’API serveur en C #

Définition des données de titre internes en appelant l’API serveur en C #

Voir aussi

Dernière modification le 8 octobre 2026