Spielerdaten

Spielerdaten sind Informationen über einen Spieler, die im PlayFab-Dienst gespeichert sind und die Sie auf mehreren Geräten und mehreren Spielen freigeben können.

PlayFab bietet zwei Möglichkeiten zum Speichern von Spielerdaten:

  • Entitäten: Ermöglicht ihnen das Speichern von Daten in Objekten und Dateien über Spieler, Charaktere und Gruppen hinweg.
  • Spielerdaten/UserData: Ermöglicht ihnen das Speichern von Schlüssel-Wert-Paardaten für Spieler.

Um die größtmögliche Flexibilität und beste Leistung zu bieten, wird empfohlen, dass alle neuen Titel Entitätsobjekte verwenden.

In den PlayFab-APIs verwenden die Funktionsnamen den Begriff UserData. Im Game Manager wird dieses Konzept als Spielerdaten beschrieben. Sie sind identisch und austauschbar.

Es gibt drei Zugriffsmodi auf Spielerdaten:

  • Client: Dies sind Playerdaten, die ihrem Titelclient zum Lesen und Aktualisieren zur Verfügung stehen. Sie verwenden die Client-APIs UpdateUserData zum Erstellen, Aktualisieren oder Löschen und GetUserData zum Lesen von Daten für den Player.
  • Schreibgeschützt: Dies sind Playerdaten, die von Ihrem Server erstellt oder aktualisiert werden. Ihr Titelclient kann diese Daten lesen, aber nicht aktualisieren. Sie verwenden die Server-API UpdateUserReadOnlyData zum Erstellen, Aktualisieren oder Löschen und die Client-API GetUserReadOnlyData zum Lesen titelspezifischer Daten für den Player. Diese Daten sind für den Spieler sichtbar, können aber nur vom Server geändert werden.
  • Intern: Dies sind Playerdaten, die nur für Ihren Server verfügbar sind. Sie verwenden die Server-APIs UpdateUserInternalData zum Erstellen, Aktualisieren oder Löschen und GetUserInternalData zum Lesen titelspezifischer Daten für den Player. Diese Daten sind nur servergeschützt und können vom Client nicht angezeigt werden.

Wenn Sie Playerdaten verwenden, sind nur Benutzerdaten und schreibgeschützte Benutzerdaten für die Client-API verfügbar. Wenn Sie Spielerdaten haben, die ein anderer Spieler lesen kann, müssen Sie den Permission Wert auf Public festlegen, wenn Sie die Daten schreiben.

Spielerdaten im Vergleich zu Spielerherausgeberdaten

Spielerdaten sind Spielerinformationen, die für einen Spieltitel spezifisch sind. Es sollte für titelspezifische Informationen verwendet werden, z. B. das Speichern der Position Ihres Spielers in einem Kerker oder andere spielspezifische Daten.

Player Publisher-Daten sind Daten, die dem Spielerkonto zugeordnet sind, im Gegensatz zum Spielerkonto und dem Titel. Es wird verwendet, um Informationen zu einem Spieler zu speichern, die für alle Titel in Ihrem Studio relevant sind (die auch titelspezifische Informationen enthalten können, um titelübergreifende Belohnungen zu ermöglichen).

Alle Titel in einem Studio in PlayFab teilen standardmäßig eine Herausgeber-ID, und diese ID definiert diese Beziehung. Spielerkonten sind auf der Verlegerebene vorhanden und werden für alle Titel mit derselben Herausgeber-ID freigegeben (und verfügen dann zusätzlich über unterschiedliche Spielerdaten pro Titel).

Wenn Sie Titel in einem Studio mit unterschiedlichen Herausgeber-IDs oder Titel in verschiedenen Studios benötigen, die dieselbe Herausgeber-ID verwenden, können Sie ein Ticket in den PlayFab-Communityforen öffnen, und unser Entwicklererfolgsteam wird Ihnen helfen.

Notiz

Verwechseln Sie player publisher data nicht mit Publisher-Daten, die Schlüssel-Wert-Paar-Daten sind, die von allen Titeln gemeinsam verwendet werden (nicht pro Spieler).

Die Datennutzung des Player-Verlegers ist nahezu identisch mit der Nutzung von Spielerdaten. Beides sind Wörterbücher, die eine Zeichenfolge einem JSON-Blob (oder einem anderen beliebigen Zeichenfolgenwert) zuordnen.

Weitere Informationen finden Sie unter Verwenden von Spielerherausgeberdaten zum Gewähren einer Belohnung für das Spielen mehrerer Titel.