Informations de migration vers les entités - XBOX Game Development Documentation

L’API d’entité introduit de nouveaux modèles d’accès conçus pour remédier aux points faibles des systèmes de compte et de données actuels. Les informations présentées ici vous seront utiles si vous utilisiez auparavant les méthodes suivantes pour implémenter la gestion des données de vos informations de titre, de joueur ou de personnage. Accès au titre :

client/GetTitleData
admin/GetTitleData
server/GetTitleData

Accès au joueur :

Accès au personnage :

client/GetCharacterData
client/UpdateCharacterData

Avec l’API d’entité, vous pouvez appeler une seule méthode pour enregistrer les valeurs de données des types d’entités titre, joueur et personnage. L’API fournit des règles d’accès qui reproduisent et étendent le comportement actuel du système pour les données personnalisées, dans une meilleure interface. À certains égards, ces modifications ne sont pas rétrocompatibles. Vous pouvez toutefois ajouter des appels à l’API d’entité sans modifier le comportement des API existantes.

Terminologie

Le tableau suivant décrit les précisions terminologiques liées aux API d’entité.

Terme	Description
title	Ce concept est inchangé. Votre titre peut contenir des informations globales accessibles à tous les joueurs. Ceci est similaire à TitleData. Il est identifié par l’ID de titre (`TitleId`) du jeu ou de l’application.
master_player_account	Ce type d’entité vous permet de partager des informations sur un joueur entre plusieurs jeux d’un espace de noms. Ceci est similaire à UserPublisherData. Il est identifié par l’ID de joueur (`PlayFabId`) du joueur, retourné lors de toute connexion ou de tout appel visant à récupérer les informations du compte de joueur (p. ex., l’API Client PlayFab GetAccountInfo).
title_player_account	Ce concept est basé sur l’utilisateur/joueur des méthodes d’API existantes. Chaque joueur peut contenir des informations pour le titre actuel. Ceci est similaire à la méthode GetUserData. Il est identifié par l’ID d’entité (`EntityKey.Id`) retourné dans l’objet EntityKey lors de toute connexion pour laquelle vous définissez `LoginTitlePlayerAccountEntity` sur `True`.
character	Ce concept est inchangé. Votre joueur peut posséder des personnages, chacun pouvant contenir des informations. Ceci est similaire à CharacterData. Il est identifié par l’ID de personnage (`CharacterId`) du personnage.
PlayFabId	Auparavant, ce terme couvrait à la fois les concepts `master_player_account` et `title_player_account`. La séparation de ces concepts simplifie et clarifie la fonctionnalité. Un joueur peut interagir avec plusieurs titres du même espace de noms. Le joueur peut avoir des informations uniques dans un `title_player_account` différent pour chaque titre, et un seul `master_player_account` avec des données partagées entre les titres. Cela permet la promotion croisée des jeux et les récompenses inter-jeux.

Voir aussi

Introducing Entities, Objects and Files sur le blog PlayFab.
Démarrage rapide des entités

​Terminologie

​Voir aussi

Terminologie

Voir aussi