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.

Informationen zum Implementieren von Bestenlisten für Ihre Plattform finden Sie unter Kundenimplementierungen.

Erläuterung zu Bestenlisten

Wenn du eine Bestenliste erstellst, übernehmen die Play-Spieldienste die meisten Aspekte dieser Bestenliste für dich. Der typische Prozess dafür sieht wie folgt aus:

1. Am Ende eines Spiels (oder zu einem von Ihnen bestimmten Zeitpunkt) wird die Punktzahl des Spielers von dem Spiel an eine oder mehrere Bestenlisten übermittelt, die Sie für das Spiel erstellt haben.
2. Die Play-Spieldienste prüfen, ob diese Punktzahl in der täglichen, wöchentlichen oder Allzeit-Punktzahl höher ist als der aktuelle Eintrag des Spielers in der Bestenliste. Ist dies der Fall, aktualisieren die Play-Spieldienste die entsprechenden Bestenlisten mit der neuen Punktzahl.
3. Die Play-Spieldienste senden einen Punktzahlbericht an den Spieleclient zurück. Dieser Bericht teilt dem Client mit, ob es sich um einen neuen Tages-, Wochen- oder Allzeit-Highscore handelt. Ist dies nicht der Fall, teilen die Play-Spieldienste dem Client den aktuellen Tages-, Wochen- oder Allzeit-Highscore für diesen Spieler mit.
4. Um die Ergebnisse eines Spielers für eine Bestenliste abzurufen, können Sie einen Zeitraum anfordern (täglich, wöchentlich oder insgesamt) und angeben, ob der Nutzer eine soziale oder öffentliche Bestenliste sehen möchte oder nicht. Die Play-Spieldienste führen alle erforderlichen Filter durch und senden die Ergebnisse dann zurück an den Client.
5. Wenn es viele Punktzahlen zu melden gibt, senden die Play-Spieldienste nur die Daten für die besten Punktzahlen der Bestenliste zurück. Sie können auch Punktzahl-Rohdaten für die besten Punktzahlen oder die Punktzahlen neben denen des Spielers abrufen.

Mehrere Bestenlisten

Spiele können bis zu 70 Bestenlisten haben. Bei einem Spiel mit mehreren Levels kann zum Beispiel eine eigene Bestenliste für jedes Level angeboten werden. Ein Rennspiel kann jeweils eine separate Bestenliste für jede Strecke führen.

Zeiträume von Bestenlisten

Das Play Spiele SDK erstellt automatisch Tages-, Wochen- und Allzeitversionen jeder von dir erstellten Bestenliste. Sie müssen nicht für jeden Zeitraum separate Bestenlisten erstellen.

Tägliche Bestenlisten werden das ganze Jahr über um UTC-7 (Mitternacht Pacific Daylight Time) zurückgesetzt.

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

Öffentliche Bestenlisten und Bestenlisten für soziale Netzwerke

Mit dem Play Spiele SDK können dem Spieler zwei verschiedene Versionen jeder Bestenliste angezeigt werden:

Die Bestenliste für soziale Netzwerke ist eine Bestenliste, die sich aus Personen in den Kreisen des Nutzers (oder genauer gesagt den Mitgliedern der Kreise, die der Nutzer mit Ihrer App geteilt hat) zusammensetzt, die beschlossen haben, ihre Spielaktivitäten mit dem Nutzer zu teilen.

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

Hinweis :Bestenlisten für soziale Netzwerke sind anfangs leer, bis Sie die entsprechende Bestenliste über die Google Play Console veröffentlichen. Informationen zum Veröffentlichen Ihrer Bestenliste finden Sie unter Spieländerungen veröffentlichen.

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 Ihre eigenen Versionen der Bestenlisten implementieren, indem Sie direkt auf die Daten aus den Client-Bibliotheken zugreifen.

Warnung: Spielernamen, die Sie direkt mithilfe der Clientbibliotheken abrufen, können Unicode-Zeichen enthalten (z. B. wenn der Name nicht englische Zeichen enthält). Wenn du deine eigene Version einer Bestenlisten-UI mit dekorativen Schriftarten implementierst, solltest du darauf achten, dass diese Namen auf deiner UI korrekt angezeigt werden können.

Merkmale

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, den die Google Play Console für Sie generiert. Mit dieser eindeutigen ID verweisen Sie in Ihren Spieleclients auf die Bestenliste.
• Name ist ein Kurzname der Bestenliste, z. B. "High Scores" oder "Level 3". Er kann bis zu 100 Zeichen umfassen.
• Das Symbol ist ein quadratisches Symbol, das mit Ihrer Bestenliste verknüpft wird. Best Practices für das Erstellen von Symbolen für Bestenlisten finden Sie im Abschnitt Symbolrichtlinien unten.
• Die Listenreihenfolge ist die Reihenfolge, in der die Bestenliste angezeigt wird, wenn ein Spieler die Bestenlisten Ihres Spiels aufruft.
• Limits sind optionale Werte, die Unter- und Obergrenzen für die in der Bestenliste zulässigen Punktzahlen definieren. Auf diese Weise können Sie Einsendungen von Punktzahlen verwerfen, die offensichtlich betrügerisch sind. Mit Players.hide können Sie auch Spieler aus allen Bestenlisten Ihrer App ausblenden, die Ihrer Meinung nach betrügerische Punktzahlen eingereicht haben.

Sortierung

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 zu sehen, in denen Spieler Punkte sammeln.
• Bestenlisten des Typs Je niedriger die Punktzahl, desto besser werden gelegentlich verwendet, wenn eine kleinere Punktzahl besser geeignet ist. Diese Art von Bestenliste kommen am häufigsten in Rennspielen vor, bei denen die Punktzahl der Zeit für das Rennen entspricht.

Hinweis :Nach der Veröffentlichung einer Bestenliste kann der Reihenfolgetyp („Größer ist besser“ oder „Kleiner ist besser“) festgelegt werden und kann nicht mehr geändert werden. Sie können die Listenreihenfolge einer Bestenliste auch nach der Veröffentlichung ändern.

Formatierung der Punktzahl

Während alle Punktzahlen als lange Ganzzahlen an Bestenlisten gesendet und intern gespeichert werden, können die Play-Spieldienste sie dem Nutzer in verschiedenen Formaten präsentieren:

• In numerischen Bestenlisten werden Punktzahlen als Zahlen dargestellt. Diese können als Ganzzahlen oder als reelle Zahlen mit einer festen Anzahl von Dezimalstellen angezeigt werden. Sie übermitteln die Punktzahl als Ganzzahlen und das Komma 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 Zeitbestenlisten werden Punktzahlen im Format Stunden / Minuten / Sekunden / Hundertstelsekunden angezeigt. Sie müssen Punktzahlen als Millisekunden einreichen, sodass 66032 als 1:06.03 interpretiert wird.

• In Währungsbestenlisten werden Punktzahlen in einem Währungsformat angezeigt. Sie übermitteln Punktzahlen mit einem 1.000.000. Teil der Hauptwährungseinheit. Eine Punktzahl von 19.950.000 würde beispielsweise als $19.95 interpretiert werden, wenn Sie als Währung USD 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 Punktzahlen angezeigt werden sollen. Mit der REST API können Sie auch eine gebietsschemabasierte Sprache angeben. Die Play-Spieldienste geben formatierte Punktzahlen in Bestenlisten entsprechend der Sprache und Region zurück. Diese formatierten Punktzahlen werden unabhängig davon angezeigt, ob Sie Übersetzungen für Ihre Bestenliste 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 an geeigneter Stelle an.

Je nach ausgewählter Sprache müssen Sie möglicherweise verschiedene Versionen der Namen Ihrer Einheiten bereitstellen. Im Englischen benötigen Sie eine Version für einen Artikel und eine andere für alles andere (z. B. „meter“ und „meters“). Auf Polnisch hingegen müssten Sie eine Version für eine Einheit, einige, viele Einheiten und alles andere bereitstellen. Weitere Informationen zu Pluralregeln finden Sie unter Mengenstrings(Plurale).

Bei Zeitbestenlisten wird das Zeitformat entsprechend der Sprache und dem Gebietsschema des Spielers angezeigt. Dies macht sich vor allem dann bemerkbar, wenn Sie Sekundenbruchteile oder einen Stundenwert mit mehr als drei Ziffern verwenden (z. B. 4,815:16:23.42 in den USA und 4.815:16:23,42 in Deutschland).

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

Symbolrichtlinien

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

Es wird für alle Gebietsschemas dasselbe Symbol verwendet. Deshalb raten wir davon ab, in Symbolen Text oder lokalisierte Inhalte zu verwenden.

Bestenliste erstellen

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

Bestenliste für ein neues Spiel erstellen

Wenn Sie eine Bestenliste für ein neues und unveröffentlichtes Spiel erstellen möchten, rufen Sie in der Google Play Console den Eintrag für Ihr Spiel 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. Ihre Bestenliste ist dann im Status „Entwurf“ verfügbar. Mit der Veröffentlichung Ihres Spiels werden auch alle Bestenlisten Ihres 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 diese. Sie sehen nun dasselbe Formular, das Sie beim Erstellen der Bestenliste verwendet haben, und können jedes Feld nach Belieben bearbeiten.

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

Wenn es korrekt funktioniert, wählen Sie im Feld oben im Bestenlistenformular Änderungen veröffentlichen aus. Dann können Sie Ihr Spiel zusammen mit allen aktualisierten Bestenlisten wieder veröffentlichen.

Änderungen rückgängig machen

Wenn Ihnen Ihre neu bearbeitete Bestenliste nicht gefällt und Sie zum vorherigen Durchlauf zurückkehren möchten, wählen Sie einfach im Feld oben im Leaderboard-Formular Rückgängig machen aus. Ihre Bestenliste wird auf die bereits veröffentlichte Version zurückgesetzt.

Bestenliste löschen

Sie können Bestenlisten im Status „Entwurf“ oder veröffentlichte Bestenlisten löschen. 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 können Sie Players.hide aufrufen, um die Bestenliste eines Spielers in der App auszublenden.

Bestenliste zurücksetzen

Sie können nur die Spielerfortschrittsdaten für Ihre Entwürfe der Bestenlisten zurücksetzen.

• Wenn Sie Bestenlisten in der Google Play Console zurücksetzen möchten, klicken Sie oben im Formular für das Ereignis auf Fortschritt zurücksetzen.
• Wenn Sie Daten zu Bestenliste programmatisch zurücksetzen möchten, rufen Sie die Scores-Methoden der Management API auf.

Übersetzungen für Bestenlisten hinzufügen

Sie können Ihre eigenen Übersetzungen für die zu Ihrem Spiel gehörenden Bestenlisten angeben. Führen Sie vorher 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 Ihre eigenen Ü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 Detailseite der Bestenliste auf den Tab für eine Sprache, die Sie zuvor auf dem Tab Infos zum Spiel hinzugefügt haben. Bearbeiten Sie auf der Detailseite der Bestenliste das Formular mit Ihren Übersetzungen für diese Sprache. Klicken Sie zum Speichern Ihrer übersetzten Bestenlistendetails auf Speichern.

Bestenlisten-Punktzahlen ausblenden

Die Google Play-Spieldienste bieten eine Manipulationsschutzfunktion für Bestenlisten, die nach mutmaßlich manipulierten Punktzahlen sucht und sie automatisch ausblendet. Diese Funktion ist nur für Android-Spiele verfügbar.

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

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. Aktiviere die Option Manipulationsschutz für Bestenlisten aktivieren.
4. Klicken Sie auf Speichern und fahren Sie fort.
5. Veröffentlichen Sie Ihr Spiel.

Wenn der Manipulationsschutz für eine Bestenliste in der Google Play Console aktiviert ist, 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 Situationen kann es sinnvoll sein, den Manipulationsschutz zu deaktivieren, z. B. wenn Ihr Spiel nicht nur über Android, sondern auch im Web ausgeführt wird und Bestenlisten über diese Plattformen hinweg geteilt werden.

Clientimplementierungen

Informationen zum Implementieren von Bestenlisten für Ihre Plattform finden Sie in den folgenden Ressourcen:

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