Spielerdaten

Bei den Spielerdaten handelt es sich um Speicher pro Spieler, der auf Spielerobjekte (title_player_account, master_player_account, und character) beschränkt ist. Verwenden Sie es zum Speichern von Spielfortschritt, Einstellungen und anderen Informationen, die an einen einzelnen Spieler gebunden sind.

Spielerdaten sind eines von mehreren Speicherfeatures in PlayFab, die jeweils auf einen anderen Entitätstyp beschränkt sind. Einen Vergleich finden Sie unter Objekte.

Speicheroptionen

PlayFab bietet zwei Möglichkeiten zum Speichern von Spielerdaten:

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

Um größtmögliche Flexibilität und optimale Leistung zu bieten, empfehlen wir, 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 Spielerdaten, 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 , um Daten für den Player zu lesen.
  • Schreibgeschützt: Dies sind Spielerdaten, 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 , um titelspezifische Daten für den Spieler zu lesen. Diese Daten sind für den Spieler sichtbar, können aber nur vom Server geändert werden.
  • Intern: Dies sind Spielerdaten, die nur für Ihren Server verfügbar sind. Sie verwenden die Server-APIs UpdateUserInternalData zum Erstellen, Aktualisieren oder Löschen und GetUserInternalData , um titelspezifische Daten für den Spieler zu lesen. Diese Daten sind nur auf dem Server verfügbar und können vom Client nicht angezeigt werden.

Wenn Sie Playerdaten verwenden, stehen der Client-API nur Benutzerdaten und schreibgeschützte Benutzerdaten zur Verfügung. Wenn Sie über Spielerdaten verfügen, die ein anderer Spieler lesen können soll, müssen Sie den Permission Wert festlegen, wenn Public Sie die Daten schreiben.

Spielerdaten und Spielerherausgeberdaten

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

Spielerherausgeberdaten sind mit denen master_player_account eines Spielers im Namespace und nicht mit einem title_player_account. Verwende ihn, um Spielerinformationen zu speichern, die für alle Titel im Namespace relevant sind, z. B. titelübergreifende Belohnungen.

Die Herausgeber-ID identifiziert den Namespace; Publisher ist der ältere API-Begriff für diesen Bereich. Standardmäßig teilen alle Titel in einem Studio eine Herausgeber-ID. Das Master-Spielerkonto des Spielers bietet eine titelübergreifende Identität in diesem Namespace, während der Spieler auch unterschiedliche Daten in jedem Titelspielerkonto hat. Weitere Informationen finden Sie unter PlayFab-Konzepte.

Notiz

Einige Legacykonfigurationen haben mehrere Herausgeber-IDs in einem Studio oder eine gemeinsame Herausgeber-ID für mehrere Studios. Diese Konfigurationen sind ungewöhnlich.

Notiz

Verwechseln Sie die Publisher-Daten des Spielers nicht mit den Publisher-Daten , bei denen es sich um Schlüssel/Wert-Paar-Daten handelt, die von allen Titeln gemeinsam genutzt werden ( nicht pro Player ).

Die Nutzung der Daten des Spielerherausgebers ist nahezu identisch mit der Nutzung der Spielerdaten. Bei beiden handelt es sich um Wörterbücher, die eine Zeichenfolge einem JSON-Blob (oder einem anderen beliebigen Zeichenfolgenwert) zuordnen.

Weitere Informationen finden Sie unter Verwenden von Spieler-Herausgeberdaten, um eine Belohnung für das Spielen mehrerer Titel zu gewähren.