Bestenlisten

Mit Bestenlisten kann der Wettstreit zwischen Ihren Spielern angeregt werden – sowohl für eingefleischte Fans, die um den ersten Platz in einer öffentlichen Bestenliste wetteifern, als auch für gelegentliche Spieler, die ihre Fortschritte mit denen ihrer Freunde vergleichen möchten.

Weitere Informationen zur Implementierung von Bestenlisten für deine Plattform findest du unter Clientimplementierungen.

Bestenlisten

Wenn Sie eine Bestenliste erstellen, werden die meisten Aspekte dieser Bestenliste von den Play-Spieldiensten für Sie verwaltet. Der typische Prozess dafür sieht wie folgt aus:

1. Am Ende eines Spiels (oder zu einem von Ihnen festgelegten geeigneten Zeitpunkt) sendet das Spiel den Punktestand des Spielers an eine oder mehrere Bestenlisten, die Sie für das Spiel erstellt haben.
2. Play-Spieldienste prüfen, ob dieser Wert besser ist als der aktuelle Eintrag des Spielers in der Bestenliste für den Tages-, Wochen- oder Gesamtwert. Ist das der Fall, aktualisieren die Play-Spieldienste die entsprechenden Bestenlisten mit dem neuen Wert.
3. Die Play-Spieldienste senden einen Punktebericht an den Spielclient zurück. In diesem Bericht wird dem Kunden angezeigt, ob es sich um einen neuen Tages-, Wochen- oder Gesamtwert handelt. Andernfalls teilt der Play Spiele-Dienst dem Client mit, was der aktuelle Tages-, Wochen- oder Gesamthöchstwert für diesen Spieler ist.
4. Wenn du die Ergebnisse eines Spielers für eine Bestenliste abrufen möchtest, kannst du einen Zeitraum angeben (täglich, wöchentlich oder seit Beginn). Du kannst auch festlegen, ob der Nutzer eine Bestenliste für soziale Netzwerke oder eine öffentliche Bestenliste sehen möchte. Play Spieledienste führt alle erforderlichen Filterungen durch und sendet die Ergebnisse dann an den Client zurück.
5. Wenn viele Punkte gemeldet werden müssen, sendet Play Spieledienste nur die Daten für die Bestenlisten zurück. Sie können auch Rohdaten für die besten Ergebnisse oder die Ergebnisse abrufen, die sich in der Nähe des Spielers befinden.

Mehrere Bestenlisten

Spiele können mehrere Bestenlisten haben, bis zu maximal 70. Ein Spiel mit mehreren Leveln kann beispielsweise für jedes Level eine eigene Bestenliste haben und ein Rennspiel kann für jede Rennstrecke eine separate Bestenliste haben.

Zeiträume für Bestenlisten

Das Play Spiele SDK erstellt automatisch tägliche, wöchentliche und Gesamtwertungen für jede Bestenliste, die Sie erstellen. Du musst nicht für jeden Zeitraum eine separate Bestenliste erstellen.

Tägliche Bestenlisten werden das ganze Jahr über um 00:00 Uhr (UTC-7, also „Mitternacht Pacific Daylight Time“) zurückgesetzt.

Wöchentliche Bestenlisten werden zwischen Samstag und Sonntag um Mitternacht in derselben Zeitzone wie tägliche Bestenlisten (UTC-7) zurückgesetzt.

Öffentliche Bestenlisten und Bestenlisten für soziale Netzwerke

Das Play Spiele SDK kann dem Spieler zwei verschiedene Versionen jeder Bestenliste anzeigen:

Die Soziale Bestenliste besteht aus Personen in den Gruppen des Nutzers (genauer gesagt aus Mitgliedern der Gruppen, die der Nutzer für Ihre App freigegeben hat), die ihre Spielaktivitäten mit dem Nutzer teilen möchten.

Die öffentliche Bestenliste umfasst Spieler, die ihre Spielaktivitäten öffentlich teilen. Wenn der Spieler seine Spielaktivitäten nicht öffentlich teilen möchte, wird er nicht in dieser Bestenliste angezeigt.

Bestenlisten anzeigen

Die Bibliotheken mobiler Clients steuern die gesamte Formatierung und Anzeige von Bestenlisten. Sie können angeben, ob ein Spieler eine bestimmte Bestenliste sehen oder aus einer Liste aller Ihrer Bestenlisten auswählen kann.

Sie können auch eigene Versionen der Bestenlisten implementieren, indem Sie direkt über die Clientbibliotheken auf die Daten zugreifen.

Attribute

Zum Erstellen und Verwalten von Bestenlisten sollten Sie mit den folgenden Attributen für Bestenlisten vertraut sein:

Grundlagen

Die folgenden grundlegenden Elemente spielen bei allen Bestenlisten eine Rolle:

• ID ist ein eindeutiger String, der in der Google Play Console für Sie generiert wird. Mit dieser eindeutigen ID verweisen Sie in Ihren Game-Clients auf die Bestenliste.
• Name ist ein kurzer Name für die Bestenliste (z. B. „Beste Ergebnisse“ oder „Level 3“). Er kann bis zu 100 Zeichen umfassen.
• Symbol: Ein quadratisches Symbol, das mit der Bestenliste verknüpft wird. Best Practices zum Erstellen von Bestenlistensymbolen finden Sie in den Symbolrichtlinien.
• Die Listenreihenfolge ist die Reihenfolge, in der die Bestenliste angezeigt wird, wenn ein Spieler die mit Ihrem Spiel verknüpften Bestenlisten aufruft.
• Limits sind optionale Werte, die die untere und obere Grenze der in der Bestenliste zulässigen Punktzahlen festlegen. So können Sie Bewertungen ablehnen, die eindeutig betrügerisch sind. Mit Players.hide können Sie Spieler, die Ihrer Meinung nach betrügerische Ergebnisse eingereicht haben, in allen Bestenlisten Ihrer App ausblenden.

Bestenlisten sortieren

Bestenlisten können eine von zwei Anzeigereihenfolgen aufweisen:

• Bestenlisten des Typs Je höher die Punktzahl, desto besser sind der Standard. Das ist in der Regel in den meisten Spielen der Fall, in denen Spieler Punkte sammeln.
• Bestenlisten vom Typ Kleiner ist besser werden gelegentlich verwendet, wenn ein niedrigerer Wert besser wäre. Die gängigsten Beispiele für diese Art von Bestenliste finden sich in Rennspielen, in denen die Punktzahl die Zeit des Spielers für das Beenden des Rennens darstellt.

Formatierung der Punktzahl

Alle Punktzahlen werden in Bestenlisten eingereicht und intern als lange Ganzzahlen gespeichert. Die Play-Spieldienste können sie Nutzern jedoch in einer Reihe von verschiedenen Formaten präsentieren:

• In numerischen Bestenlisten werden Punktzahlen als Zahlen dargestellt. Sie können als Ganzzahlen oder als reelle Zahlen mit einer festen Anzahl von Dezimalstellen angezeigt werden. Sie reichen den Wert als Ganzzahl ein und der Dezimalpunkt wird an der angegebenen Stelle eingefügt. Ein Wert von 314159 wird beispielsweise als 3.14159, 3141.59 oder 314159 angezeigt, je nachdem, welche Dezimalstelle Sie angegeben haben.

• In den Bestenlisten für Zeit werden die Ergebnisse in Stunden, Minuten, Sekunden und Hundertstelsekunden angegeben. Sie müssen Bewertungen in Millisekunden einreichen. 66032 wird also als 1:06.03 interpretiert.

• In Währungsbestenlisten werden Punktzahlen in einem Währungsformat angezeigt. Sie reichen Bewertungen als 1/1.000.000 der Hauptwährungseinheit ein. Ein Wert von 19.950.000 wird beispielsweise als $19.95 interpretiert, wenn Sie „USD“ als Währung angegeben haben.

Numerische Bestenlisten unterstützen auch benutzerdefinierte Einheiten. Wenn Ihr Spiel Highscores z. B. in Metern misst, können Sie "Meter" als Standardeinheit für Ihre Bestenliste angeben.

Übersetzungen und Formatierung der Punktzahl

Wenn die mobilen Clientbibliotheken Bestenlistendaten von den Play-Spieldiensten anfordern, geben sie eine Sprache und ein Gebietsschema an, in denen diese Bewertungen angezeigt werden sollen. Mit der REST API können Sie auch eine sprachspezifische Sprache angeben. Die Play Spiele-Dienste geben formatierte Bestenlistenpunkte zurück, die für die jeweilige Sprache und Region geeignet sind. Diese formatierten Bewertungen werden angezeigt, unabhängig davon, ob Sie Übersetzungen für Ihr Ranking hinzugefügt haben.

Bei numerischen Bestenlisten wird das Zahlenformat je nach Sprache unterschiedlich angezeigt. (z. B. 12,345.78 in den USA und 12 345,78 in Frankreich) Wenn Sie benutzerdefinierte Einheiten verwenden und Ihrem Spiel Übersetzungen hinzugefügt haben, müssen Sie für jede hinzugefügte Sprache übersetzte Einheiten angeben. Der Dienst zeigt diese übersetzten Einheiten dann gegebenenfalls an.

Je nach ausgewählter Sprache müssen Sie möglicherweise verschiedene Versionen der Namen Ihrer Unterkünfte angeben. Auf Englisch benötigen Sie eine Version für einen Artikel und eine andere für alle anderen (z. B. „Meter“ und „Meter“). Im Polnischen müssen Sie dagegen eine Version für eine Einheit, für wenige Einheiten, für viele Einheiten und für alles andere angeben. Weitere Informationen zu Regeln für die Mehrzahl finden Sie unter Mengestrings(Mehrzahl).

In Bestenlisten für Zeit wird das Zeitformat entsprechend der Sprache und dem Gebietsschema des Spielers angezeigt. Dies ist vor allem bei Verwendung von Sekundenbruchteilen oder einem Stundenwert mit mehr als drei Ziffern der Fall (z. B. 4,815:16:23.42 in den USA und 4.815:16:23,42 in Deutschland).

Bei Bestenlisten für Währungen wird das Währungsformat entsprechend der Sprache und dem Gebietsschema des Spielers angezeigt. Sie können jedoch die Währungseinheit nicht ändern. Wenn Sie beispielsweise Ihre Währung in US-Dollar angeben, wird im Spiel $19.95 in den USA und 19,95 $ in Frankreich angezeigt. Sie können jedoch nicht angeben, dass in Ihrem Spiel in den USA Dollar und in Frankreich Euro angezeigt werden sollen.

Symbolrichtlinien

Symbole sollten als PNG- oder JPEG-Dateien im Format 512 x 512 erstellt werden. Ihre Symbole werden in den meisten Game-Clients verkleinert. Daher sollten Sie keine Symbole mit zu vielen Details erstellen. Sie können Symbole mit einem Alphakanal einreichen. Die Transparenz wird beibehalten. Das Bestenlistensymbol wird auf Android-Geräten vor einem dunkleren grauen Hintergrund angezeigt. Wählen Sie daher ein Symbol aus, das in dieser Situation gut funktioniert.

Dasselbe Symbol wird in allen Sprachen verwendet. Wir empfehlen daher, in einem Symbol keinen Text oder lokalisierten Inhalt zu verwenden.

Bestenliste erstellen

In diesem Abschnitt erfahren Sie, wie Sie Bestenlisten für neue oder vorhandene Spiele erstellen.

Ein Leaderboard für ein neues Spiel erstellen

Wenn Sie eine Bestenliste für ein neues und unveröffentlichtes Spiel erstellen möchten, rufen Sie den Eintrag Ihres Spiels in der Google Play Console auf und gehen Sie zu Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Bestenlisten. Klicken Sie dann auf die Schaltfläche Bestenliste erstellen.

Geben Sie anschließend einfach die für diese Bestenliste erforderlichen Informationen ein.

Klicken Sie auf Als Entwurf speichern. Die Bestenliste ist dann im Status „Entwurf“ verfügbar. Wenn Sie Ihr Spiel veröffentlichen, werden alle Bestenlisten des Spiels veröffentlicht.

Bestenliste für ein veröffentlichtes Spiel erstellen

Führen Sie dieselben Schritte wie oben aus, um für ein bereits veröffentlichtes Spiel eine zusätzliche Bestenliste zu erstellen. Weitere Informationen zum Testen einer aktualisierten Version eines Spiels finden Sie unter Spieländerungen veröffentlichen.

Nachdem Sie Ihre Bestenliste erfolgreich getestet haben, können Sie Ihr Spiel mit den neuen Bestenlisten erneut veröffentlichen und so weltweit verfügbar machen.

Bestenliste bearbeiten

Wenn Sie eine bereits erstellte Bestenliste bearbeiten möchten, klicken Sie in der Google Play Console auf dem Tab Bestenlisten auf die Bestenliste. Nun sehen Sie dasselbe Formular, das Sie beim Erstellen der Bestenliste verwendet haben. Sie können die Felder nach Bedarf bearbeiten.

Klicken Sie nach dem Bearbeiten einer Bestenliste auf die Schaltfläche Als Entwurf speichern. Die neu bearbeitete Bestenliste hat den Status „Entwurf“. Sie können sie jetzt testen.

Wenn alles richtig funktioniert, wählen Sie im Feld oben im Formular für Bestenlisten die Option Änderungen veröffentlichen aus. Anschließend können Sie Ihr Spiel zusammen mit allen aktualisierten Bestenlisten wieder öffentlich veröffentlichen.

Änderungen rückgängig machen

Wenn dir die neu bearbeitete Bestenliste nicht gefällt und du zur vorherigen Version zurückkehren möchtest, wähle einfach oben im Formular für die Bestenliste Rückgängig aus. Die Bestenliste wird auf die bereits veröffentlichte Version zurückgesetzt.

Bestenliste löschen

Sie können Bestenlisten löschen, die den Status „Entwurf“ haben oder veröffentlicht wurden. Wenn Sie eine Bestenliste in der Google Play Console löschen möchten, rufen Sie das Formular für die Bestenliste auf und klicken Sie oben im Formular auf Bestenliste löschen.

Alternativ kannst du Players.hide aufrufen, um die Bestenliste eines Spielers in der App auszublenden.

Bestenliste zurücksetzen

Sie können die Spielerfortschrittsdaten nur für Ihre Draft-Bestenlisten zurücksetzen.

• Wenn Sie Bestenlisten in der Google Play Console zurücksetzen möchten, klicken Sie oben im Formular für das betreffende Ereignis auf Fortschritt zurücksetzen.
• Wenn du Bestenlistendaten programmatisch zurücksetzen möchtest, rufe die ScoresMethoden der Management API auf.

Übersetzungen für Bestenlisten hinzufügen

Sie können eigene Übersetzungen für Bestenlisten angeben, die mit Ihrem Spiel verknüpft sind. Führen Sie dazu zuerst die unter Übersetzungen für Ihr Spiel hinzufügen beschriebenen Schritte aus. Außerdem müssen Sie eine oder mehrere Bestenlisten für Ihr Spiel erstellt haben.

Wenn Sie eigene Übersetzungen für Bestenlisten hinzufügen möchten, öffnen Sie in der Google Play Console den Tab Bestenlisten für Ihr Spiel und wählen Sie eine vorhandene Bestenliste aus. Klicken Sie auf der Seite mit den Bestenlistendetails auf den Tab für eine Sprache, die Sie zuvor auf dem Tab Spieldetails hinzugefügt haben. Bearbeiten Sie auf der Detailseite der Bestenliste für diese Sprache das Formular mit Ihren Übersetzungen für diese Bestenliste. Klicken Sie auf Speichern, um die Details der übersetzen Bestenliste zu speichern.

Bestenlistenpunkte ausblenden

Google Play Spieledienste bieten eine Funktion zum Schutz vor Manipulation der Bestenliste, die nach verdächtigen manipulierten Ergebnissen sucht und diese automatisch ausblendet. Diese Funktion ist nur für Android-Spiele verfügbar.

Der Manipulationsschutz ist standardmäßig für neue Bestenlisten aktiviert, die Sie für Ihr Android-Spiel erstellen. Für vorhandene Bestenlisten ist er deaktiviert. So aktivieren Sie den Manipulationsschutz für Ihre bereits veröffentlichten Bestenlisten:

1. Öffnen Sie in der Google Play Console den Tab Spieldienste und wählen Sie Ihr Spiel aus der Liste aus.
2. Öffnen Sie den Tab Bestenlisten und wählen Sie die Bestenlisteninstanz aus, für die Sie den Manipulationsschutz aktivieren möchten.
3. Aktivieren Sie die Option Manipulationsschutz für Bestenliste aktivieren.
4. Klicken Sie auf Speichern und fahren Sie fort.
5. Veröffentlichen Sie Ihr Spiel.

Nachdem der Manipulationsschutz für eine Bestenliste in der Google Play Console aktiviert wurde, kann es bis zu 24 Stunden dauern, bis diese Funktion wirksam wird. Bewertungen, die vor der Aktivierung des Manipulationsschutzes eingereicht wurden, werden nicht rückwirkend ausgeblendet.

In einigen Fällen kann es sinnvoll sein, den Manipulationsschutz zu deaktivieren, z. B. wenn Ihr Spiel neben Android auch im Web ausgeführt wird und Bestenlisten über diese Plattformen hinweg freigegeben werden.

Clientimplementierungen

Weitere Informationen zur Implementierung von Bestenlisten für Ihre Plattform finden Sie in den folgenden Ressourcen:

• Android
• Web
• C++ API
• Best Practices für die Implementierung von Bestenlisten