Passer au contenu principal
Ce tutoriel explique comment créer et utiliser des données limitées à un espace de noms à l’aide des API de données d’éditeur (Publisher data). Les données d’éditeur sont des données statiques qui couvrent plusieurs titres d’un espace de noms PlayFab, par exemple lorsque plusieurs jeux doivent partager des informations communes. Publisher est l’ancien terme d’API désignant la portée de l’espace de noms, et le Publisher ID identifie l’espace de noms. Un espace de noms est distinct d’un studio, qui est le regroupement administratif des titres, des utilisateurs, des autorisations et de la facturation. Pour plus de renseignements, consultez Concepts PlayFab.
Cette catégorie comprend également les données de joueurs couvrant plusieurs jeux. PlayFab stocke les données sous forme de paires clé/valeur (KVP).
La plupart de ces API sont des API serveur que votre programme doit appeler depuis un serveur dédié, ou au moyen d’une fonction CloudScript dans le service PlayFab. Vous devez appeler les API serveur depuis un serveur dédié ou au moyen d’une fonction CloudScript dans le service PlayFab. Ce comportement est voulu, car les API serveur PlayFab exigent que vous fournissiez votre clé secrète.
Nous ne recommandons pas d’utiliser les API serveur depuis un client de jeu. Si vous devez utiliser une API serveur, utilisez CloudScript pour ce type de fonctionnalité.
Les valeurs des données d’éditeur sont copiées et distribuées sur potentiellement des centaines de machines du cluster de serveurs PlayFab. Dans le cadre de ce processus, ces données sont mises en cache, et l’actualisation des modifications dans ces caches peut prendre jusqu’à quinze minutes.
Les données d’éditeur conviennent particulièrement aux données globales constantes/statiques et ne sont ni adaptées ni fiables en tant que variables globales.

Données d’éditeur

Les données d’éditeur servent à stocker des données statiques pour les titres d’un espace de noms. Chaque entrée n’est pas liée à une entité de joueur (contrairement aux données d’éditeur de l’utilisateur).

Définition des données d’éditeur

L’extrait suivant montre comment définir des données d’éditeur à l’aide de l’API Server.
Il existe un équivalent de cette opération dans l’API Admin.

Obtention des données d’éditeur

L’extrait suivant montre comment obtenir des données d’éditeur à l’aide de l’API Client.
Il existe des équivalents de cette opération dans les API Server et Admin.

Données d’éditeur de l’utilisateur

Les données d’éditeur de l’utilisateur permettent d’introduire des données d’éditeur liées à un utilisateur (joueur) PlayFab. Contrairement aux données d’éditeur classiques, une application cliente peut modifier les données d’éditeur de l’utilisateur. Du point de vue de l’API Client, PlayFab propose 3 niveaux de protection pour les données d’éditeur de l’utilisateur :
  1. Les données d’éditeur de l’utilisateur classiques offrent un accès en lecture et en écriture aux applications clientes.
    • Définies au moyen des API Client, Server et Admin.
    • Obtenues au moyen des API Client, Server et Admin.
    • L’API Client ne peut définir des données d’éditeur que pour un joueur actuellement connecté.
  2. Les données d’éditeur de l’utilisateur en lecture seule offrent un accès en lecture aux applications clientes.
    • Définies au moyen des API Server et Admin.
    • Obtenues au moyen des API Client, Server et Admin.
  3. Les données d’éditeur de l’utilisateur internes n’offrent aucun accès aux applications clientes et servent à stocker la partie secrète des données utilisateur.
    • Définies au moyen des API Server et Admin.
    • Obtenues au moyen des API Server et Admin.

Définition des données d’éditeur de l’utilisateur

L’extrait suivant montre comment définir les 3 types de données d’éditeur à l’aide des API Client et Server.

Obtention des données d’éditeur de l’utilisateur

L’extrait suivant montre comment obtenir les 3 types de données d’éditeur à l’aide des API Client et Server.

Voir aussi

Dernière modification le 8 octobre 2026