Freigeben über

Verwenden von zurücksetzbaren Statistiken und Bestenlisten

  • Artikel

Dieses Tutorial enthält eine vollständige exemplarische Vorgehensweise zum Konfigurieren und Verwalten von Statistiken mit Versionsverwaltung, die das Zurücksetzen von Statistiken ermöglicht, und damit auch mit Bestenlisten.

Wir konzentrieren uns auf die Verwendung der Admin API-Methoden mit zusätzlichen Informationen zur Verwendung der Client- und Server-API-Methoden zum Abfragen der Daten – sowohl für die aktuelle Version als auch für die alte Version.

Unser Ziel ist es, Ihnen einen technischen Überblick darüber zu geben, wie neu festlegbare Statistiken in PlayFab funktionieren und wie sie in Ihren Spielen verwendet werden können.

Statistiken und Bestenlisten

Zunächst ist es wichtig zu beachten, dass alle Statistiken, die für einen Spieler in einem Spiel in PlayFab definiert sind, Teil einer Bestenliste sind. Das Definieren Ihrer Statistiken definiert also auch Ihre Bestenliste.

Statistiken sind für Spieler möglicherweise nicht unbedingt sichtbar, aber sie sind vorhanden. Sie können sie verwenden, um Listen von Spielern nach einer von Ihnen definierten Punktzahl abzurufen – ob sie die Oberste aller Ergebnisse, die untersten, die um den aktuellen Spieler zentriert sind, oder die in der Freundesliste eines Benutzers.

Viele Statistiken in Spielen sind als Lebensdauerwerte gedacht - was bedeutet, dass spieler ständig ihre Ergebnisse aktualisieren, wobei alte bleiben, bis jeder Spieler seine persönliche Bestleistung schlägt. Für einige Spielererfahrungen ist es jedoch wichtig, die Bestenliste von Zeit zu Zeit "löschen" zu können.

Dies kann verwendet werden, um einen Benutzer zu ermutigen, zu versuchen, für einen bestimmten Zeitraum der beste Spieler zu sein, oder einfach alle Spieler, die seit einer Weile nicht mehr aktiv waren, aus dem Ranking zu entfernen.

Wie in diesem Tutorial erläutert, können Statistiken in PlayFab so konfiguriert werden, dass sie in einem vordefinierten Intervall zurückgesetzt werden.

Dies ist nicht nur für die oben beschriebenen Szenarien nützlich, es kann auch für Titel verwendet werden, die eine eindeutige Bestenliste mit aktuellen Ergebnissen benötigen, die für Dinge wie Spielhervorforderungen verwendet werden können, bei denen Sie einen Spieler eine Einladung an eine Person mit einem ähnlichen Qualifikationsgrad senden möchten.

Das Festlegen eines Zurücksetzungszeitraums bedeutet, dass die Spieler, die in einem Aufruf von GetLeaderboardAroundPlayer zurückgegeben werden, z. B. diejenigen sind, die das Spiel kürzlich gespielt haben und ähnliche Ergebnisse wie der lokale Spieler haben.

Es ist auch möglich, eine Statistik als manuellen Vorgang zurückzusetzen. Dies ist ein praktisches System zum Löschen aller Daten, die Sie aus Ihren Vorabstarttests oder Alpha-/Beta-Play haben.

Dies ist auch nützlich für das Worst-Case-Szenario, in dem ein Fehler im Spielcode eingeführt wurde, der zu unkontrollierten Ergebnissen führt. In jedem Fall müssen Sie die Fähigkeit haben, die Bestenliste sauber zu löschen, damit die Spieler das Gefühl haben, dass sie eine faire Chance haben, darauf zu kommen.

Notiz

Beim Zurücksetzen von Statistiken werden diese Werte nicht gelöscht, wie Sie unten sehen werden. Beim Zurücksetzen werden Statistiken in PlayFab versioniert, sodass die neue Version autoritativ ist, während frühere Versionen für spätere Analysen beibehalten werden (und damit Sie Spieler basierend auf ihren alten Ergebnissen belohnen können).

Konfigurieren von zurücksetzbaren Statistiken

Die Zurücksetzungszeiträume für Statistiken werden mithilfe des Admin-API-Satzes oder des Game Manager konfiguriert. Sie können dann über den Game Manager, die Server-API und die Client-API aktualisiert und abgefragt werden (obwohl das Veröffentlichen von Statistiken vom Client erfordert, dass die Option Client zum Veröffentlichen von Statistiken auf der Registerkarte Einstellungen-API-Features> des Spiels im Game Manager festgelegt ist).

Wir beschreiben die API-Methode hierfür, obwohl die hier definierten Parameter mit denen im Game Manager selbst identisch sind.

Zum Einrichten der Statistiken können Sie die Admin-Methode CreatePlayerStatisticDefinition und die UpdatePlayerStatisticDefinition -Methode verwenden, um später Änderungen vorzunehmen.

In beiden Fällen gibt es nur zwei Parameter:

  • StatisticName – Der Zeichenfolgenbezeichner für die Spielerstatistik.
  • VersionChangeInterval – Der Zeitraum, der definiert, wann die Statistiken automatisch zurückgesetzt werden sollen.

Ist VersionChangeInterval der Schlüssel zu diesem Feature und kann als stündlich, täglich, wöchentlich oder monatlich definiert werden. Sie kann auch auf "Nie" festgelegt werden, wenn Sie später entscheiden, dass die Statistik nicht mehr regelmäßig zurückgesetzt werden soll.

Im folgenden Beispiel richtet der Aufruf der CreatePlayerStatisticDefinition -Methode die Statistik-Headshots mit einer täglichen Zurücksetzung ein, was bedeutet, dass die Bestenliste für diese Statistik im Spiel jeden Tag um 00:00 UTC zurückgesetzt wird.

public void CreatePlayerStatisticDefinition() {
    PlayFabAdminAPI.CreatePlayerStatisticDefinition(
        new CreatePlayerStatisticDefinitionRequest() {
            StatisticName = "Headshots",
            VersionChangeInterval = StatisticResetIntervalOption.Day
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Im Folgenden wird die Antwort für den vorherigen API-Aufruf veranschaulicht.

{
    "code": 200,
    "status": "OK",
    "data":
    {
        "Statistic":
        {
            "StatisticName": "Headshots",
            "CurrentVersion": 0,
            "VersionChangeInterval": "Day"
        }
    }
}

Die unten gezeigte Codierung ist ein alternatives Beispiel.

public void UpdatePlayerStatisticDefinition() {
    PlayFabAdminAPI.UpdatePlayerStatisticDefinition(
        new UpdatePlayerStatisticDefinitionRequest() {
            StatisticName = "Headshots",
            VersionChangeInterval = StatisticResetIntervalOption.Week
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Der Aufruf veranschaulicht das Festlegen des Zurücksetzungszeitraums für die Statistik auf wöchentlich mit der folgenden Antwort.

{
    "code": 200,
    "status": "OK",
    "data":
    {
        "Statistic":
        {
            "StatisticName": "Headshots",
            "CurrentVersion": 0,
            "VersionChangeInterval": "Week"
        }
    }
}

In jedem Fall ist das Ergebnis , das PlayerStatisticDefinitionFolgendes enthält:

  • Die Zeichenfolgen-ID der Statistik (StatisticName).
  • Gibt an, wie oft die Statistik zurückgesetzt wurde (CurrentVersion).
  • Der definierte Zeitraum, in dem die Statistik zurückgesetzt wird (VersionChangeInterval).

Die Zurücksetzungszeiträume werden wirksam, sobald sie definiert sind. In diesem Fall bedeutet der zweite Aufruf, dass das Zurücksetzen jetzt als 00:00 UTC, Montagmorgen (Mitternacht am Sonntagabend/Montagmorgen unter Verwendung der UTC-Zeitzone) definiert ist, unabhängig davon, was vor dem Anruf war.

Die verbleibenden Zurücksetzungsintervalle werden ebenfalls mit UTC definiert, wobei der Monat die Zurücksetzung am ersten Tag jedes Monats um 00:00 Uhr UTC bewirkt.

Für die Abgeschlossene Liste sind die Zurücksetzungszeiträume:

  • Nie: Beenden Sie die Versionsverwaltung der Statistik auf zeitbasierter Basis.
  • Stunde: Version der Statistik am Anfang jeder Stunde (XX:00 UTC).
  • Tag: Versionieren Sie die Statistik jeden Tag um Mitternacht (00:00 UHR UTC).
  • Woche: Version der Statistik jeden Montag um Mitternacht (00:00 UTC).
  • Monat: Version der Statistik um Mitternacht (00:00 UTC) am ersten Tag jedes Monats.

Bereits vorhandene Statistiken

Alle im Spiel definierten Statistiken können nach ihrer Definition abgefragt werden, unabhängig davon, ob sie als Zurücksetzungsstatistiken eingerichtet wurden oder nicht.

Dies ist wichtig, da Statistiken mithilfe des UpdatePlayerStatistics-Aufrufs erstellt werden können. Alle Statistiken, die nicht mit einem Zurücksetzungszeitraum (VersionChangeInterval) erstellt wurden, müssen nicht gestartet werden. Daher würde eine Abfrage für die Statistikkonfiguration mit diesem Parameter zurückgegeben, der auf Neverfestgelegt ist.

Wenn im obigen Beispiel auch eine Statistik mit dem Namen FlagsCapturedUpdatePlayerStatistics erstellt wurde (oder im Game Manager direkt für einen Spieler erstellt wurde) und einige Wochen vergangen waren, würde sie wie im unten gezeigten Aufruf angezeigt.

public void GetPlayerStatisticDefinitions() {
    PlayFabAdminAPI.GetPlayerStatisticDefinitions(
        new GetPlayerStatisticDefinitionsRequest(),
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Dies führt zu folgendem Ergebnis:

{
    "code": 200,
    "status": "OK",
    "data":
    {
        "Statistics": [
        {
            "StatisticName": "Headshots",
            "CurrentVersion": 2,
            "VersionChangeInterval": "Week"
        },
        {
            "StatisticName": "FlagsCaptured",
            "CurrentVersion": 0,
            "VersionChangeInterval": “Never”
        }]
    }
}

In diesem Fall ist für die Statistik mit dem Namen Headshots ein Zurücksetzungsintervall definiert, das CurrentVersion angibt, dass die Statistik zweimal zurückgesetzt wurde.

Inzwischen hat VersionChangeIntervalkein , was auch der Grund ist, FlagsCaptured warum der CurrentVersionist 0 (da es nie versioniert wurde).

Statistiken, die über UpdatePlayerStatistics (oder den PlayFab-Spiel-Manager) erstellt wurden, können weiterhin so definiert werden, dass sie einen Zurücksetzungszeitraum mit UpdatePlayerStatisticDefinitionhaben, wie oben beschrieben.

Sobald dies geschehen ist, setzen sie in diesem Intervall genau so zurück, als ob sie ursprünglich mit CreatePlayerStatisticDefinitiondefiniert wären.

Manuelles Zurücksetzen einer Statistik

Für die Situation, in der ein Spielfehler erlaubt ist, um eine Statistik zu betrügen, oder wenn Sie einfach zurücksetzen müssen, um Ergebnisse aus vorab veröffentlichten Gameplay zu entfernen, kann die Statistik gezwungen werden, im Game Manager oder über einen Aufruf von IncrementPlayerStatisticVersionzurückzusetzen.

Dadurch werden die aktuellen Statistiken, die Sie angeben, sofort zurückgesetzt, die Bestenliste für das Spiel wird entfernt und eine leere Tafel für neue Werte bereitgestellt, die gemeldet werden sollen.

In unserem Beispiel könnte dieser Aufruf wie unten gezeigt aussehen.

public void IncrementPlayerStatisticVersion() {
    PlayFabAdminAPI.IncrementPlayerStatisticVersion(
        new IncrementPlayerStatisticVersionRequest() {
            StatisticName = "Headshots"
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Dies erhöht die Headshots Statistik erneut und gibt Informationen zu der Version zurück, die gerade aktiviert wurde.

{
    "code": 200,
    "status": "OK",
    "data":
    {
        "StatisticVersion":
        {
            "StatisticName": "Headshots",
            "Version": 3,
            "ActivationTime": "2016-02-03T08:02:29.864Z",
            "ArchivalStatus": "NotScheduled"
        }
    }
}

In diesem Fall werden die Informationen zurückgegeben, die PlayerStatisticVersion die ID der Statistik (StatisticName) sowie deren Versionsnummer, den Zeitpunkt, zu dem sie zur maßgeblichen Version (ActivationTime) wurde, und die ArchivalStatus (dies ist NotScheduled immer für die aktuelle Version) enthalten.

Bei einer Statistik, die ebenfalls über verfügt VersionChangeInterval, ändert das manuelle Zurücksetzen jedoch nicht die nächste geplante Zurücksetzungszeit. Wenn eine Statistik täglich zurückgesetzt werden soll (und manuell um 23:30 Uhr UTC zurückgesetzt wird), wird sie immer noch um Mitternacht UTC zurückgesetzt.

Wenn das Zurücksetzen erfolgt

Wie bereits erwähnt, wird beim Zurücksetzen des Zurücksetzungsintervalls die Statistik versioniert, sodass sofort eine neue Version verfügbar ist, während die alte Version dieser Statistik für den späteren Abruf archiviert wird.

Sobald das Zurücksetzungsintervall auftritt (oder eine manuelle Zurücksetzung durchgeführt wird) und die Statistik versioniert ist, werden Schreibvorgänge in die alte Version für bis zu zehn Minuten akzeptiert. Darüber hinaus ist die Statistik gesperrt, sodass zukünftige Updates verhindert werden.

Sobald die Statistik abgelaufen ist, wird der Archivprozess gestartet, sodass sie später durch den Titel abgerufen werden können.

Die Phasen des Archivierungsprozesses für eine Statistik sind:

  • NotScheduled : Die Archivierung der Statistik wurde nicht gestartet (normalerweise nur für die aktuell aktive Statistikversion).
  • Geplant : Der Archivprozess wurde geplant, aber noch nicht ausgeführt.
  • InProgress : Die Statistik wird im Archiv gesichert.
  • Fehler: Unerwarteter Fehler (in diesem Fall wenden Sie sich an unsere Supportforen).
  • Vollständig : Diese Version der Statistik wurde archiviert.

Alle früheren und aktuellen Versionen einer Statistik können mithilfe GetPlayerStatisticVersionsvon abgefragt werden. Dadurch werden die Informationen für jede Version zurückgegeben, wie im vorherigen Beispiel zum manuellen Zurücksetzen gezeigt.

Mit anderen Worten, dieser Aufruf sollte wie der unten dargestellte angezeigt werden.

public void GetPlayerStatisticVersions() {
    PlayFabAdminAPI.GetPlayerStatisticVersions(
        new GetPlayerStatisticVersionsRequest() {
            StatisticName = "Headshots"
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Dies kann dazu führen, dass die folgenden Informationen für unseren Beispieltitel zurückgegeben werden.

{
    "code": 200,
    "status": "OK",
    "data":
    {
        "StatisticVersions": [
        {
            "StatisticName": "Headshots",
            "Version": 0,
            "ActivationTime": "2015-01-20T05:47:27.17Z",
            "DeactivationTime": "2016-01-25T00:00:00.000Z",
            "ArchivalStatus": "Complete",
            "ArchiveDownloadUrl": {{URL}}
        },
        {
            "StatisticName": "Headshots",
            "Version": 1,
            "ActivationTime": "2016-01-25T00:00:00.000Z",
            "DeactivationTime": "2016-02-01T00:00:00.000Z",
            "ArchivalStatus": "Complete",
            "ArchiveDownloadUrl": {{URL}}
        },
        {
            "StatisticName": "Headshots",
            "Version": 2,
            "ActivationTime": "2016-02-01T00:00:00.000Z",
            "DeactivationTime": "2016-02-03T08:02:29.864Z",
            "ArchivalStatus": "InProgress"
        },
        {
            "StatisticName": "Headshots",
            "Version": 3,
            "ActivationTime": "2016-02-03T08:02:29.864Z",
            "ArchivalStatus": "NotScheduled"
        }]
    }
}

Zusätzlich zu den von IncrementPlayerStatisticVersionzurückgegebenen Werten enthält die Antwort auch die Zeitstempel für den Zeitpunkt, an dem jede Version abgelaufen war (DeactivationTime) für Versionen vor der aktuellen aktiven Version und eine URL zum Herunterladen der CSV mit dem vollständigen Datensatz der alten Bestenliste, nachdem der Archivvorgang abgeschlossen wurde (ArchiveDownloadUrl).

Lesen und Schreiben in Statistikversionen

Schließlich ähneln die Aufrufe auf der Seite der Server- und Client-API dem, was Sie aus den ursprünglichen PlayFab-Benutzer- und Zeichenstatistikaufrufen kennen.

Der Unterschied besteht darin, dass die Version jetzt Teil der Anforderung oder der Antwort ist.

Beim Abrufen von Statistiken wird der Wert für die aktuelle Statistikversion sowie die Versionsnummer selbst zurückgegeben.

Die folgenden Beispiele zeigen den Aufruf der Headshots Statistik sowie die zurückgegebenen Daten.

Serveranforderung

public void GetPlayerStatistics() {
    PlayFabServerAPI.GetPlayerStatistics(
        new GetPlayerStatisticsRequest() {
            PlayFabId= "_PlayFabId_",
            StatisticNames = new List<string>() { "Headshots" }
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Serverantwort

{
    "code": 200,
    "status": "OK",
    "data":
    {
        "PlayFabId": {{PlayFabId}},
        "Statistics": [
        {
            "StatisticName": "Headshots",
            "Value": 10,
            "Version": "3"
        }]
    }
}

Clientanforderung

public void GetPlayerStatistics() {
    PlayFabClientAPI.GetPlayerStatistics(
        new GetPlayerStatisticsRequest() {
            StatisticNames = new List<string>() { "Headshots" }
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Clientantwort

{
    "code": 200,
    "status": "OK",
    "data": {
        "Statistics": [
        {
            "StatisticName": "Headshots",
            "Value": 10,
            "Version": "3"
        }]
    }
}

In der Zwischenzeit verwendet der Update Aufruf eine optionale Version, damit der Titel steuern kann, welche Version aktualisiert wird, für Fälle, in denen die Version während des Spiels erhöht wurde.

Notiz

Wenn der Titel in diesem Beispiel in die vorherige Version geschrieben werden soll, solange dies noch möglich ist, würde er in Version 2 geschrieben, wie unten gezeigt.

Serveranforderung

public void UpdatePlayerStatistics() {
    PlayFabServerAPI.UpdatePlayerStatistics(
        new UpdatePlayerStatisticsRequest() {
            PlayFabId= "_PlayFabId_",
            Statistics = new List<StatisticUpdate>() {
                new StatisticUpdate() {
                    StatisticName = "Headshots",
                    Version = 2,
                    Value = 10
                }
            }
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Serverantwort

{
    "code": 200,
    "status": "OK",
    "data": {}
}

Clientanforderung

public void UpdatePlayerStatistics() {
    PlayFabClientAPI.UpdatePlayerStatistics(
        new UpdatePlayerStatisticsRequest() {
            Statistics = new List<StatisticUpdate>() {
                new StatisticUpdate() {
                    StatisticName = "Headshots",
                    Version = 2,
                    Value = 10
                }
            }
        },
        result => Debug.Log("Complete"),
        error => Debug.Log(error.GenerateErrorReport())
    );
}

Clientantwort

{
    "code": 200,
    "status": "OK",
    "data": {}
}

Aber denken Sie daran: Während die abgelaufene Version bis zu 10 Minuten lang in geschrieben werden kann, schlägt jeder Versuch, in diese Version zu schreiben, nach dieser Zeit fehl, mit einer Antwort wie der unten gezeigten.

{
    "code": 400,
    "status": "BadRequest",
    "error": "StatisticVersionClosedForWrites",
    "errorCode": 1197,
    "errorMessage": "The statistic version is not current and is no longer accepting updates"
}

Ressourcen

Zur Vollständigkeit enthält dieser Abschnitt eine Liste aller oben beschriebenen Enumerationen, Klassen und API-Methoden mit kurzen Beschreibungen.

Basisenumerungen

  • Intervall : Zeitraum, mit dem die Statistik (Bestenliste) zurückgesetzt wird:

    • Nie
    • Stunde
    • Tag
    • Woche
    • Monat

  • StatisticVersionArchivalStatus : die status des Prozesses zum Speichern der Statistikwerte eines Spielers einer Version in einem herunterladbaren Archiv:

    • Nicht geplant
    • Geplant
    • InProgress
    • Fehlgeschlagen
    • Vollständig

Basisklassen und ihre Member

  • PlayerStatisticDefinition

    • StatisticName (Zeichenfolge): Der eindeutige Name der Statistik.
    • CurrentVersion (Zeichenfolge): Die aktuelle aktive Version der Statistik, die bei jedem Zurücksetzen der Statistik inkrementiert wird.
    • VersionChangeInterval (Interval): Das Intervall, in dem die Werte der Statistik für alle Spieler zurückgesetzt werden.

  • PlayerStatisticVersion

    • StatisticName (Zeichenfolge): Der Name der Statistik, als die Version aktiv wurde.
    • Version (Zeichenfolge): Die Version der Statistik (eine hexadezimale Zahl, die als Zeichenfolge codiert ist).
    • ScheduledVersionChangeIntervalTime (DateTime): Der Zeitpunkt, zu dem die Statistikversion basierend auf der konfigurierten ResetInterval-Instanz aktiv werden soll.
    • CreatedTime (DateTime): Der Zeitpunkt, zu dem die Statistikversion aktiv wurde.
    • ArchivalStatus (StatisticVersionArchivalStatus): Die status des Prozesses zum Speichern von Statistikwerten dieser Version in einem herunterladbaren Archiv, sofern konfiguriert.
    • ResetInterval (Interval): Das Zurücksetzungsintervall, durch das die Version aktiviert wurde, sofern konfiguriert.

  • StatisticValue

    • StatisticName (Zeichenfolge): Der eindeutige Name der Statistik.
    • Wert (Int32): Der Statistikwert für den Spieler.
    • Version (Zeichenfolge): Für einen vorhandenen Statistikwert für einen Spieler die Version der Statistik, als sie geladen wurde.

  • StatisticUpdate

    • StatisticName (Zeichenfolge): Der eindeutige Name der Statistik.
    • Version (Zeichenfolge): Bei Aktualisierungen eines Statistikwerts für einen Spieler die Version der Statistik, die aktualisiert werden soll
    • Wert (Int32): Der Statistikwert für den Spieler.

Admin-API-Methoden

  • CreatePlayerStatisticDefinition

    • CreatePlayerStatisticDefinitionRequest

      • Name (Zeichenfolge) – Mindestlänge 1, maximale Länge 128 – Der eindeutige Name der Statistik.
      • (VersionChangeInterval) (Intervall) – Das Intervall, in dem die Werte der Statistik für alle Spieler zurückgesetzt werden (Zurücksetzungen beginnen bei der nächsten Intervallgrenze).

    • CreatePlayerStatisticDefinitionResult

      • Statistics (PlayerStatisticDefinition): Die Definition der erstellten Statistik.

  • UpdatePlayerStatisticDefinition

    • UpdatePlayerStatisticDefinitionRequest

      • StatisticName (Zeichenfolge): Der eindeutige Name der Statistik.
      • VersionChangeInterval (Interval): Das Intervall, in dem die Werte der Statistik für alle Spieler zurückgesetzt werden (Zurücksetzungen beginnen an der nächsten Intervallgrenze).

    • UpdatePlayerStatisticDefinitionResult

      • Statistics (PlayerStatisticDefinition): Die Definition der erstellten Statistik.

  • GetPlayerStatisticDefinitions

    • GetPlayerStatisticDefinitionsRequest (keine Parameter).
    • GetPlayerStatisticDefinitionsResult
      • Statistics (PlayerStatisticDefinition[]): Das Array von Definitionen für das Zurücksetzen.

  • GetPlayerStatisticVersions

    • GetPlayerStatisticVersionsRequest

      • StatisticName (Zeichenfolge): Der eindeutige Name der Statistik.

    • GetPlayerStatisticVersionsResult

      • StatisticsVersions (PlayerStatisticVersion[]): Der Versionsänderungsverlauf der Statistik (alle Versionen).

  • IncrementPlayerStatisticVersion

    • IncrementPlayerStatisticVersionRequest

      • StatisticName (Zeichenfolge): Der eindeutige Name der Statistik.

    • IncrementPlayerStatisticVersionResult

      • StatisticVersion (PlayerStatisticVersion): Die Statistikversion, die als Ergebnis dieses Vorgangs abgelaufen ist (und deren Archivierung status).

Client-API-Methoden

  • GetPlayerStatistics

    • GetPlayerStatisticsRequest

      • StatisticNames (string[]): Array der zurückzugebenden Statistik anhand ihrer eindeutigen Namen.

    • GetPlayerStatisticsResult

      • Statistics (StatisticsValue[]): Array von StatisticValue-Daten für alle angeforderten Statistiken.

  • UpdatePlayerStatistics

    • UpdatePlayerStatisticsRequest

      • Statistics (StatisticsUpdate[]): Die zu aktualisierende Statistik mit den angegebenen Werten.

    • UpdatePlayerStatisticsResult (keine Parameter).

Server-API-Methoden

  • GetPlayerStatistics

    • GetPlayerStatisticsRequest

      • PlayFabId (Zeichenfolge): Die PlayFab-ID des Spielers, dessen Statistiken aktualisiert werden.
      • StatisticNames (string[]): Array von Statistiken, die nach ihren eindeutigen Namen zurückgegeben werden sollen.

    • GetPlayerStatisticsResult

      • Statistics (StatisticsValue[]): Array von StatisticValue-Daten für alle angeforderten Statistiken.

  • UpdatePlayerStatistics

    • UpdatePlayerStatisticsRequest

      • PlayFabId (Zeichenfolge): Die PlayFab-ID des Spielers, dessen Statistiken aktualisiert werden.
      • Statistics (StatisticsUpdate[]): Die zu aktualisierende Statistik mit den angegebenen Werten.

    • UpdatePlayerStatisticsResult (keine Parameter).