Freigeben über


PlayStream-Ereignisse

Zum Erfassen von Daten mit PlayStream können Sie vier verschiedene APIs verwenden: WriteEvents, WritePlayerEvent, WriteCharacterEvent und WriteTitleEvent.

PlayFabGenerated-Ereignisse im Vergleich zu UserGenerated-Ereignissen

Es stehen zwei Arten von Ereignissen zur Verfügung: PlayFabGenerated und UserGenerated. Beide Ereignistypen sind playergeordnet, d. h., wenn mehrere APIs in einer bestimmten Reihenfolge aufgerufen werden, werden alle durch die Ereignisse ausgelösten Aktionen in der gleichen Reihenfolge wie die API-Aufrufe ausgeführt.

PlayFabGenerated-Ereignisse werden von PlayFab über einen normalen API-Aufruf erstellt.

UserGenerated-Ereignisse werden hingegen von Entwicklern erstellt, die ihre Struktur und Daten definieren und für ihre Spiele spezifisch sind. Diese Ereignisse werden vollständig durch Echtzeitanalysetools widergespiegelt und im Gegensatz zu Standardereignissen benötigen Sie benutzerdefinierten Code, um sie zu veröffentlichen.

UserGenerated-Ereignisse können nach Entität klassifiziert und an einen Spieler, einen Charakter oder einen Titel gebunden werden. Ein Ereignisentitätsverweis wird mithilfe dieser beiden Felder angegeben:

  • EntityType
  • EntityID

Im Folgenden finden Sie eine Vergleichstabelle zwischen einigen PlayFabGenerated- und UserGenerated-Ereignismerkmalen.

PlayFabGenerated-Ereignisse UserGenerated-Ereignisse
Generiert von PlayFab-Dienste Die Entwickler
Schema Standardschema (definiert durch PlayFab) Meist benutzerdefiniertes Schema (von Entwicklern definiert)
Berichte und Vorlagen Wird in allgemeinen Berichten und Vorlagen verwendet Nicht in Berichten oder Vorlagen verwendet
Ereignisnamespace V1: "com.playfab"
V2: "Ereignisse"
V1: "title"
V2: "benutzerdefiniert"
Wie wird ausgegeben? N/V V1: WriteTitleEvent, WritePlayerEvent, WriteCharacterEvent
V2: WriteEvents

Standardschemaereignisse im Vergleich zu benutzerdefinierten Schemaereignissen

In PlayFab können Sie sowohl PlayFabGenerated-Standardschemaereignisse als auch UserGenerated custom-schema-Ereignisse verwenden, obwohl die Anzahl der letzteren relativ begrenzt ist.

In der folgenden Tabelle finden Sie Beispiele für diese beiden Ereignistypen.

PlayFabGenerated-Ereignisse UserGenerated-Ereignisse
Standardschema player_logged_in
entity_created
client_focus_change
client_session_start
Benutzerdefiniertes Schema N/V Freistil