Passer au contenu principal
Cette rubrique décrit les types d’entités disponibles que vous pouvez utiliser pour construire une EntityKey. Les clés d’entité identifient les entités dans la plupart des méthodes d’API récentes. La valeur du champ EntityKey.Type vous permet de déterminer le type de valeur à définir dans le champ ID.
Les clés d’entité respectent la casse.

​
namespace

L’entité namespace représente l’identité de joueur inter-titres et la portée des données partagées. Par défaut, elle couvre tous les titres d’un studio. Le Publisher ID identifie cet espace de noms ; publisher est l’ancien terme d’API désignant la même portée. L’espace de noms est distinct du studio, qui est un regroupement administratif. Pour plus d’informations, consultez Concepts PlayFab.
Les modifications apportées à cette entité ne sont pas reflétées en temps réel.
Définissez le champ ID sur le Publisher ID de votre jeu. Pour récupérer votre Publisher ID :
  • Connectez-vous à Game Manager.
  • Dans le coin supérieur gauche de Game Manager, sélectionnez l’icône d’engrenage.
  • Sélectionnez Title Settings.
  • Sélectionnez API Features.
  • Le Publisher ID, qui est également l’ID de l’espace de noms, s’affiche dans la section API ACCESS.

​
title

L’entité title représente les informations globales limitées à un titre. Un titre est une ressource PlayFab isolée destinée à un jeu ou à un environnement de jeu.
Les modifications apportées à cette entité ne sont pas reflétées en temps réel.
Définissez le champ ID sur le Title ID de votre jeu. Pour récupérer le Title ID :
  • Connectez-vous à Game Manager.
  • Dans le coin supérieur gauche de Game Manager, sélectionnez l’icône d’engrenage.
  • Sélectionnez Title Settings.
  • Sélectionnez API Features.
  • Le Title ID s’affiche dans la section API ACCESS.

​
master_player_account

Le master_player_account est une entité de joueur partagée par tous les titres associés à un espace de noms donné. Définissez le champ ID sur le LoginResult.PlayFabId de l’API classique. Pour récupérer le LoginResult, appelez l’une des méthodes de connexion de Client Authentication.

​
title_player_account

Pour la plupart des développeurs, title_player_account représente le joueur de la manière la plus traditionnelle. Définissez le champ ID sur LoginResult.EntityToken.Entity.Id dans l’API cliente, ou sur GetEntityTokenResponse.Entity.Id dans l’API d’authentification. Pour récupérer le LoginResult, appelez l’une des méthodes de connexion de Client Authentication. Pour récupérer le GetEntityTokenResponse, appelez Get Entity Token.

​
character

L’entité character est une sous-entité de title_player_account et reflète directement les personnages des API classiques. Définissez le champ ID sur n’importe quel characterId issu de result.Characters[i].CharacterId.

​
group

L’entité group est un conteneur pour d’autres entités. Elle est actuellement limitée aux joueurs et aux personnages. Définissez le champ ID sur result.Group.Id si vous créez un groupe, ou sur result.Groups[i].Group.Id lorsque vous listez vos appartenances.

​
game_server

L’entité game_server est une entité unique utilisée par les serveurs de jeu, principalement pour les fonctionnalités Matchmaking et Lobby. D’autres scénarios pourront être ajoutés à l’avenir pour prendre en charge d’autres fonctionnalités PlayFab. Cette entité donne aux serveurs de jeu leur propre identité, ce qui permet de les identifier de manière unique pour s’abonner aux mises à jour en temps réel de Matchmaking et Lobby, ainsi que de prendre en charge des fonctionnalités spécifiques comme la migration du propriétaire de lobby. Pour vous authentifier en tant qu’entité game_server, appelez l’API AuthenticateGameServerWithCustomId en tant qu’entité de titre et récupérez la paire clé d’entité et jeton game_server. Utilisez cette clé d’entité lorsque vous utilisez le SDK PlayFab Multiplayer avec PFMultiplayerSetEntityToken.
Dernière modification le 19 octobre 2026