Hinzufügen Listen auf Ihr Android-Spiel, Spiele Service für Android, Google Developers

Dieser Leitfaden zeigt Ihnen, wie Ranglisten-APIs in einer Android-Anwendung verwenden visuelle Bestenlisten zu erstellen, ein Spieler der Gäste aufnehmen, und vergleichen Sie die Punktzahl gegen die Punktzahl des Spielers aus früheren Spielsitzungen. Die APIs können in dem com.google.android.gms.games.leaderboard Paket.

Bevor Sie beginnen

Wenn Sie dies noch nicht getan haben, vielleicht finden Sie es hilfreich, die Ranglisten Spielkonzepte zu überprüfen.

Bevor Sie beginnen, um Code mit dem Bestenlisten-APIs:

• Folgen Sie den Anweisungen für die Installation und die App einrichten verwenden Google Spiele Dienste im Set Up Google Play Services SDK Guide spielen.
• Definieren Sie die Bestenlisten, die Sie Ihr Spiel angezeigt werden soll oder zu aktualisieren, indem Sie die Anweisungen in der Google Play Developer Console Guide.
• Herunterladen und die Ranglisten Code-Beispiele im Android Proben Seite überprüfen.
• Machen Sie sich mit den Empfehlungen beschrieben in Qualitäts-Checkliste.

Sobald der Spieler in und die GoogleApiClient unterzeichnet angeschlossen ist, können Sie Ihr Spiel starten, um den Ranglisten-APIs.

Aktualisieren der Partitur des Spielers

Wenn die Partitur des Players ändert sich (zum Beispiel, wenn der Spieler das Spiel beendet ist), können Sie Ihr Spiel ein Tor auf der Rangliste aktualisieren, indem submitScore () aufrufen. und Leiten in dem Rang-ID und dem Rohwert Wert.

Eine gute Praxis ist die Rangliste ID in Ihrer strings.xml Datei zu definieren, so dass Ihr Spiel, um die Bestenlisten von Ressourcen-ID verweisen kann. Beim Telefonieren Spieler erhält zu aktualisieren und zu laden, stellen Sie sicher, auch diese bewährten Methoden folgen für die Überschreitung Ihrer API-Quote zu vermeiden.

Anzeigen einer Rangliste

Um eine Rangliste angezeigt werden, rufen Sie die startActivityForResult und übergibt in der Absicht, die Standard-Rangliste UI zu erstellen. In dem folgenden Codefragment ist REQUEST_LEADERBOARD eine beliebige ganze Zahl für den Anforderungscode.

Beachten Sie, dass, obwohl kein Ergebnis zurückgegeben wird, haben wir startActivityForResult zu verwenden, so dass die API die Identität des anrufenden Paket erhalten. Ein Beispiel für die Standard-Leader UI ist unten gezeigt.

Die neuesten Nachrichten auf dem Android Developers Blog

Gabel unsere Proben und versuchen, sie selbst

Stellen Sie eine Frage unter dem Google-Play-Spiele-Tag

Treten Sie mit Game On zurück! Videos auf YouTube