Freigeben über

Informationen zur Entitätsmigration

  • Artikel

Die Entitäts-API führt neue Zugriffsmuster ein, die die Problempunkte des aktuellen Kontos und der Datensysteme verringern sollen.

Die hier dargestellten Informationen sind nützlich, wenn Sie zuvor die folgenden Methoden verwendet haben, um die Datenverwaltung für Ihre Titel-, Spieler- oder Zeicheninformationen zu implementieren.

Titelzugriff :

Spielerzugriff :

Zeichenzugriff :

Mithilfe der Entitäts-API können Sie eine einzelne Methode aufrufen, um die Datenwerte für die Entitätstypen Titel, Player und Zeichen zu speichern. Die API stellt Zugriffsregeln bereit, die das aktuelle Systemverhalten benutzerdefinierter Daten in einer besseren Schnittstelle replizieren und erweitern.

In gewisser Hinsicht sind diese Änderungen nicht abwärtskompatibel. Sie können jedoch Aufrufe zur Entitäts-API hinzufügen, ohne das Verhalten der vorhandenen APIs zu ändern.

Terminologie

In der folgenden Tabelle werden verfeinerte Terminologie im Zusammenhang mit den Entitäts-APIs beschrieben.

Benennung Beschreibung
Titel Dieses Konzept bleibt unverändert. Ihr Titel kann globale Informationen enthalten, die allen Spielern zur Verfügung stehen. Dies ähnelt TitleData. Sie wird durch die Titel-ID (TitleId) des Spiels/der Anwendung identifiziert.
master_player_account Mit diesem Entitätstyp können Sie Informationen zu einem Spieler über mehrere Spiele in einem Studio freigeben. Dies ähnelt UserPublisherData. Es wird durch die Spieler-ID (PlayFabId) des Spielers identifiziert, die als Teil einer Anmeldung oder eines Aufrufs zum Abrufen von Kontoinformationen für das Spielerkonto (z. B. die PlayFab-Client-API GetAccountInfo) zurückgegeben wird.
title_player_account Dieses Konzept basiert auf Benutzer/Player in den vorhandenen API-Methoden. Jeder Spieler kann einige Informationen für den aktuellen Titel enthalten. Dies ähnelt der GetUserData-Methode . Dies wird durch die Entitäts-ID (EntityKey.Id) identifiziert, die Sie im EntityKey-Objekt für jede Anmeldung erhalten, bei der Sie als TrueangebenLoginTitlePlayerAccountEntity.
Charakter Dieses Konzept bleibt unverändert. Ihr Spieler kann charaktere besitzen, die jeweils einige Informationen enthalten können. Dies ähnelt CharacterData. Sie wird durch die Zeichen-ID (CharacterId) des Zeichens identifiziert.
PlayFabId Früher deckte dieser Begriff sowohl als auch master_player_accounttitle_player_account konzepte ab. Die Trennung dieser Konzepte vereinfacht und verdeutlicht die Funktionalität. Ein Spieler kann mit mehreren Titeln interagieren, die sich alle im selben Studio befinden. title_player_account Der Besitzer des Studios muss diesen Spieler aber auch als einzelne master_player_account Entität mit titelübergreifenden freigegebenen Daten identifizieren. Dies ermöglicht Dinge wie die Kreuzwerbung von Spielen und die übergreifende Belohnung von Spielern.

Weitere Informationen