Bestenlisten sind eine gute Möglichkeit, den Wettbewerb unter den Spielern zu fördern, deine größten Fans (die in der Öffentlichkeit um den ersten Platz kämpfen werden) Bestenliste) und für Gelegenheitsspieler, die sich für die ihre Fortschritte mit denen ihrer Freunde vergleichen).
Informationen zum Implementieren von Bestenlisten für Ihre Plattform Siehe Clientimplementierungen.
Informationen zu Bestenlisten
Wenn du eine Bestenliste erstellst, werden die meisten Aspekte dieser Bestenliste für Sie. Der typische Prozess sieht so aus:
- Am Ende eines Spiels (oder zu einem von Ihnen festgelegten geeigneten Moment) Das Spiel sendet die Punktzahl des Spielers an eine oder mehrere von Ihnen erstellte Bestenlisten. für das Spiel.
- Die Google Play-Spieldienste prüfen, ob diese Punktzahl besser als die aktuelle Punktzahl des Spielers ist Leaderboard-Eintrag für die Tages-, Wochen- oder Allzeit-Punktzahl. Ist dies der Fall, Die Google Play-Spieldienste aktualisieren die entsprechenden Bestenlisten mit der neuen Punktzahl.
- Die Google Play-Spieldienste senden einen Punktzahlbericht an den Spielclient zurück. Dieser Bericht teilt dem Kunden mit, ob es sich um einen neuen Tages-, Wochen- oder Allzeit-Highscore handelt. Ist dies nicht der Fall, teilen die Google Play-Spieldienste dem Client mit, wie hoch die Wochen- oder Allzeit-Highscore ist für diesen Spieler gedacht.
- Wenn Sie die Ergebnisse eines Spielers für eine Bestenliste abrufen möchten, können Sie eine Zeit anfordern (täglich, wöchentlich oder insgesamt) und geben an, ob die Nutzenden um eine soziale oder öffentliche Bestenliste zu sehen. Der Games-Dienst führt alle und sendet die Ergebnisse an den Client zurück.
- Wenn viele Punktzahlen gemeldet werden müssen, sendet der Spieledienst nur die Daten für die besten Bestenlisten-Punktzahlen abrufen. Sie können auch Rohdaten Punktzahldaten für die höchsten Punktzahlen oder die Punktzahlen neben denen des Spielers.
Mehrere Bestenlisten
Spiele können mehrere Bestenlisten von bis zu 70 Bestenlisten haben. Für Bei einem mehrstufigen Spiel können Sie für jedes Level und ein Rennspiel kann für jedes Level eine eigene Bestenliste Titel.
Zeiträume der Bestenliste
Das Play Spiele SDK erstellt automatisch Tages-, Wochen- und Allzeitversionen jeder Bestenliste, die Sie erstellen. Sie müssen keine separaten Bestenlisten für den jeweiligen Zeitraum.
Tagesbestenlisten werden um UTC-7 zurückgesetzt, also um Mitternacht (Pacific Daylight Time) das ganze Jahr über.
Wöchentliche Bestenlisten werden zwischen Samstag und Sonntag um Mitternacht zurückgesetzt, Zeitzone als tägliche Bestenlisten (UTC-7) angegeben werden.
Öffentliche und soziale Bestenlisten
Das Play Spiele SDK kann zwei verschiedene Versionen jeder Bestenliste Player:
Das Social-Media-Leaderboard ist eine Bestenliste, die sich aus Personen in den Kreise (oder genauer gesagt Mitglieder der Kreise, die der Nutzer in Ihrer App teilen), die sich dazu entschieden haben, ihre Spielaktivitäten zu teilen für den Nutzer.
Die öffentliche Bestenliste umfasst Spieler, die ihre Spielaktivitäten ihre Spielaktivitäten öffentlich zu teilen. Wenn Ihr Player noch keine ihre Spielaktivitäten öffentlich teilen, werden sie nicht in dieser Bestenliste angezeigt.
Bestenlisten anzeigen
In den mobilen Client-Bibliotheken übernehmen die Bibliotheken die gesamte Formatierung und Anzeigen von Bestenlisten. Du kannst angeben, ob ein Spieler bestimmte Bestenliste anzeigen oder eine Liste all deiner Bestenlisten abrufen, auswählen.
Sie können auch Ihre eigenen Versionen der Bestenlisten implementieren. durch direkten Zugriff auf die Daten aus den Clientbibliotheken.
Attribute
Wenn Sie Bestenlisten erstellen und verwalten möchten, sollten Sie mit diesen vertraut sein. Leaderboard-Attribute:
Grundlagen
Die folgenden grundlegenden Elemente sind mit jeder Bestenliste verbunden:
- Die ID ist ein eindeutiger String, den die Google Play Console automatisch generieren lassen. Mit dieser eindeutigen ID verweisen Sie auf die Bestenliste in Ihre Spiel-Clients.
- Der Name ist ein Kurzname für die Bestenliste, z. B. "Highscores" oder „Level 3“). Er darf bis zu 100 Zeichen umfassen.
- Das Symbol ist ein quadratisches Symbol, das mit Ihrem Leaderboard an. Best Practices beim Erstellen Ihrer Bestenlistensymbole finden Sie unter im Abschnitt Symbolrichtlinien weiter unten.
- Die Listenreihenfolge ist die Reihenfolge, in der die Bestenliste angezeigt wird. Ein Spieler ruft die mit Ihrem Spiel verknüpften Bestenlisten auf.
- Grenzwerte sind optionale Werte, die die Unter- und Obergrenze für
Punktzahlen, die in der Bestenliste zulässig sind. Dies kann dir helfen, die Punktzahl zu verwerfen
Beiträge, die eindeutig betrügerisch sind. Sie können auch
Players.hide
, um Spieler auszublenden die Ihrer Meinung nach betrügerische Punktzahlen aus allen Bestenlisten in für Ihre App.
Sortierung
Bestenlisten können eine von zwei Reihenfolgen haben:
- Bestenlisten des Typs Größer ist besser sind der Standard. Dies ist Dies ist in den meisten Spielen üblich, bei denen Spieler Punkte sammeln.
- Bestenlisten des Typs Je niedriger die Anzahl ist besser, werden gelegentlich verwendet, wäre eine niedrigere Bewertung besser. Die häufigsten Beispiele für diese Art von Bestenlisten werden in Rennspielen angezeigt, wobei die Punktzahl die um das Rennen zu beenden.
Formatierung der Punktzahl
Alle Punktzahlen werden an Bestenlisten gesendet und intern so lange gespeichert, Ganzzahlen dargestellt werden, kann der Spieledienst sie dem Nutzer in verschiedenen Formate:
In numerischen Bestenlisten werden Punktzahlen als Zahlen dargestellt. Diese können als als ganze Zahlen oder als reelle Zahlen mit einer festen Anzahl von Dezimalstellen. Sie übermitteln der Wert als ganze Zahlen und das Dezimalzeichen wird in die angegebene Standort. Ein Wert von
314159
würde zum Beispiel als3.14159
angezeigt werden,3141.59
oder314159
, je nach der von Ihnen angegebenen Dezimalstelle.In Zeitbestenlisten werden Punktzahlen in Stunden / Minuten / Sekunden / Hunderten angezeigt. eines zweiten Formats. Sie müssen Punktzahlen als Millisekunden einreichen, also wäre
66032
als1:06.03
interpretiert.In Währungsbestenlisten werden Punktzahlen in einem Währungsformat angezeigt. Sie übermitteln als 1/1.000.000. der Hauptwährungseinheit. Ein Wert von 19.950.000 würde als
$19.95
interpretiert werden, vorausgesetzt, Sie haben Ihre Währung US-Dollar.
Numerische Bestenlisten unterstützen auch benutzerdefinierte Einheiten. Wenn Ihr Spiel beispielsweise Highscores in Metern misst, können Sie "meter" angeben. als Standardeinheit für Ihre Bestenliste.
Übersetzungen und Formatierung von Punktzahlen
Wenn die mobilen Client-Bibliotheken Bestenlistendaten vom Games-Dienst anfordern, legen sie eine Sprache und ein Gebietsschema fest, in denen diese Bewertungen angezeigt werden sollen. Die REST-Anfrage/-Antwort API ermöglicht das Angeben einer gebietsschemabasierten und Sprache. Der Games-Dienst gibt formatierte Bestenlisten-Punktzahlen zurück. für diese Sprache und diese Sprache geeignet ist. Diese formatierten Bewertungen werden unabhängig davon, ob Sie translations für deine Bestenliste.
Bei numerischen Bestenlisten wird das Zahlenformat pro
Sprache. z. B. 12,345.78
in den USA und 12 345,78
in Frankreich. Wenn
benutzerdefinierte Einheiten verwenden und
Übersetzungen
müssen Sie übersetzte Einheiten für jede Sprache bereitstellen,
hinzugefügt. Der Dienst zeigt diese übersetzten Einheiten dann gegebenenfalls an.
Je nach ausgewählter Sprache müssen Sie unter Umständen Versionen der Namen Ihrer Anzeigenblöcke. Auf Englisch benötigen Sie eine Version für eine und ein weiteres für alle anderen Elemente, z. B. "meter" und "meters". In Polnisch hingegen schon. Sie müssten eine Version für eine Einheit bereitstellen, einige Einheiten, viele Einheiten und alles andere. Weitere Informationen zu Pluralregeln siehe Menge Strings(Plurale)
Bei Zeitbestenlisten wird das Zeitformat entsprechend dem
die Sprache und das Gebietsschema des Spielers. Dies wird vor allem sichtbar, wenn Sie
Sekundenbruchteile oder Stunden mit mehr als drei Stellen haben (für
Beispiel: 4,815:16:23.42
in den USA und 4.815:16:23,42
in Deutschland).
Bei Währungsbestenlisten wird das Währungsformat wie folgt angezeigt:
in die Sprache und das Gebietsschema des Spielers ein. Sie können jedoch die Einheit
Währung. Wenn Sie Ihre Währung beispielsweise in US-Dollar angeben,
$19.95
in den USA und 19,95 $
in Frankreich anzeigen. Sie können jedoch nicht festlegen,
in den USA Dollar und in Frankreich Euro anzeigt.
Richtlinien für Symbole
Symbole sollten als PNG- oder JPEG-Dateien im Format 512 x 512 erstellt werden. Ihre Symbole werden in den meisten Spieleclients verkleinert. Daher sollten Sie Symbole nicht zu sehr viele kleine Details. Sie können Symbole mit einem Alpha-Kanal einreichen und die bleibt die Transparenz erhalten. Das Bestenlistensymbol erscheint auf Android-Geräten einen dunkleren grauen Hintergrund verwenden. Wählen Sie daher ein Symbol aus, in dieser Situation.
Das gleiche Symbol wird in allen Sprachen verwendet. Daher raten wir davon ab, oder lokalisierten Inhalten in einem Symbol.
Bestenliste erstellen
In diesem Abschnitt erfahren Sie, wie Sie Bestenlisten für neue oder vorhandene Spiele erstellen.
Bestenliste für ein neues Spiel erstellen
Um eine Bestenliste für ein neues und nicht veröffentlichtes Spiel zu erstellen, gehe zu Google Play Console-Eintrag für Ihr Spiel und navigieren Sie zu Wachstum > Play Spiele Dienste > Einrichtung und Verwaltung > Bestenlisten auf und klicken Sie auf Schaltfläche Bestenliste erstellen:
![„Bestenliste hinzufügen“ im Hauptbereich der Bestenlisten](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/leaderboardAddNew.png?authuser=8&hl=de)
Gib dann einfach die für diese Bestenliste erforderlichen Informationen ein.
![Ein ausgefülltes Formular für die „beste Runde“ Leaderboard an.](https://developers-dot-devsite-v2-prod.appspot.com/static/games/services/images/leaderboardSampleForm.png?authuser=8&hl=de)
Klicken Sie auf Als Entwurf speichern, damit Ihre Bestenliste im Entwurf angezeigt wird. Bundesstaat. Sobald Sie Ihr Spiel veröffentlichen, werden alle Bestenlisten Ihres Spiels veröffentlicht. damit nichts.
Bestenliste für ein veröffentlichtes Spiel erstellen
So erstellen Sie eine zusätzliche Bestenliste für ein bereits veröffentlichtes Spiel: führen Sie dieselben Schritte wie oben aus. Weitere Informationen zum Testen einer aktualisierten eines Spiels finden Sie unter Spieländerungen veröffentlichen.
Sobald Sie Ihre Bestenliste getestet haben und damit zufrieden sind, können Sie sie erneut veröffentlichen. mit den neuen Bestenlisten, die dann der ganzen Welt zur Verfügung stehen.
Bestenliste bearbeiten
Um eine bereits erstellte Bestenliste zu bearbeiten, klicken Sie auf die Bestenliste in der Bestenlisten der Google Play Console. Nun sehen Sie die das Sie bei der Erstellung der Bestenliste verwendet haben. eines der Felder nach Bedarf bearbeiten.
Klicken Sie nach dem Bearbeiten einer Bestenliste auf die Schaltfläche Als Entwurf speichern. Die Neu bearbeitete Bestenlisten werden in den Entwurf aufgenommen. Damit können Sie testen, herausgefunden.
Wenn er korrekt funktioniert, wählen Sie Änderungen veröffentlichen aus dem Feld oben im Formular für die Bestenliste. Dann können Sie Ihr Spiel erneut veröffentlichen. mit all Ihren aktualisierten Bestenlisten veröffentlichen.
Änderungen rückgängig machen
Wenn Ihnen die neu bearbeitete Bestenliste doch nicht gefällt, können Sie zur vorherigen Iteration, wählen Sie einfach Rückgängig machen aus im Leaderboard-Formular. Deine Bestenliste wird wieder in die bereits veröffentlichte Version zurückgesetzt. Version.
Bestenliste löschen
Du kannst Bestenlisten löschen, die sich im Entwurf befinden oder die aus unterschiedlichen veröffentlicht. Wenn du eine Bestenliste in der Google Play Console löschen möchtest, öffne das Formular für und klicken Sie oben im Formular auf Bestenliste löschen.
Alternativ können Sie
Players.hide
zum Ausblenden des
in der App angezeigt wird.
Bestenliste zurücksetzen
Sie können nur die Spielerfortschrittsdaten für Ihre Bestenlistenentwürfe zurücksetzen.
- Wenn Sie Bestenlisten in der Google Play Console zurücksetzen möchten, klicken Sie neben ganz oben im Formular für diesen Termin.
- Um Bestenlistendaten programmatisch zurückzusetzen, rufen Sie die
Scores
-Methoden der Management API
Übersetzungen für Bestenlisten hinzufügen
Du kannst deine eigenen Übersetzungen für Bestenlisten angeben, die mit für Ihr Spiel. Führen Sie zuerst die Schritte unter Übersetzungen für Ihre Spiel. Sie müssen außerdem mindestens eine Bestenliste für Ihr Spiel erstellt haben.
Um Ihre eigenen Übersetzungen für Bestenlisten hinzuzufügen, öffnen Sie den Tab Bestenlisten für Ihr Spiel in der Google Play Console und wählen Sie dann eine vorhandene Bestenliste aus. Am Bestenlisten-Detailseite klicken, klicken Sie auf den Tab für eine Sprache, die auf dem Tab Infos zum Spiel hinzugefügt wurden. Auf der Seite mit den Bestenlistendetails Sprache hinzufügen, bearbeiten Sie das Formular mit den Übersetzungen für diese Bestenliste. Klicken Sie auf Speichern, um Ihre übersetzten Bestenlistendetails zu speichern.
Bestenlisten-Punktzahlen ausblenden
Die Google Play-Spieldienste bieten eine Manipulationsschutzfunktion für Bestenlisten, die prüft auf mutmaßlich manipulierte Werte und blendet sie automatisch aus. Diese Funktion ist nur für Android-Spiele verfügbar.
Der Manipulationsschutz ist standardmäßig für neue Bestenlisten aktiviert, die die Sie für Ihr Android-Spiel erstellen, ist aber für vorhandene Bestenlisten deaktiviert. Um den Manipulationsschutz für Ihre Bestenlisten zu aktivieren, die bereits veröffentlicht haben, führen Sie folgende Schritte aus:
- Öffnen Sie in der Google Play Console den Tab Spieldienste und wählen Sie die gewünschte Option aus. aus der Liste auswählen.
- Öffnen Sie den Tab Bestenlisten und wählen Sie die Bestenlisteninstanz aus, für die Sie den Manipulationsschutz aktivieren möchten.
- Setzen Sie die Option Manipulationsschutz für Bestenlisten aktivieren auf EIN.
- Klicken Sie auf Speichern und fahren Sie fort.
- Veröffentlichen Sie Ihr Spiel.
Sobald der Manipulationsschutz für eine Bestenliste in der Google Play Console aktiviert ist, Es kann bis zu 24 Stunden dauern, bis diese Funktion aktiviert wird. Eingereichte Punktzahlen bevor Sie den Manipulationsschutz aktiviert haben, nicht rückwirkend verborgen werden.
In einigen Situationen kann es sinnvoll sein, den Manipulationsschutz zu deaktivieren, z. B. läuft Ihr Spiel neben Android auch im Web und teilt Bestenlisten auf diesen Plattformen).
Clientimplementierungen
Informationen zum Implementieren von Bestenlisten für Ihre Plattform finden Sie hier: Ressourcen: