In diesem Leitfaden erfahren Sie, wie Sie die APIs für Erfolge in einer Android-Anwendung verwenden, um Erfolge in Ihrem Spiel freizuschalten und anzuzeigen. Die APIs finden Sie in den Paketen com.google.android.gms.games und com.google.android.gms.games.achievements.
Hinweis
Falls Sie es noch nicht getan haben, sollten Sie sich die Konzepte für Spielerfolge ansehen.
Bevor du mit der Programmierung mit der API für Erfolge beginnst, solltest du Folgendes beachten:
Folgen Sie der Anleitung zum Installieren und Einrichten Ihrer App für die Verwendung der Google Play-Spieldienste im Leitfaden Google Play Services SDK einrichten.
Beschreiben Sie die Erfolge, die in Ihrem Spiel freigeschaltet oder angezeigt werden sollen. Folgen Sie dazu der Anleitung im Leitfaden zur Google Play Console.
Laden Sie die Codebeispiele für Erfolge auf der Seite mit Android-Beispielen herunter und sehen Sie sich diese an.
Machen Sie sich mit den Empfehlungen in der Checkliste für die Qualität vertraut.
Client für Erfolge abrufen
Damit Sie die Achievements API verwenden können, muss Ihr Spiel zuerst ein AchievementsClient-Objekt abrufen. Rufen Sie dazu die Methode Games.getAchievementClient() auf und übergeben Sie die Aktivität.
Erfolge freischalten
Wenn Sie einen Erfolg freischalten möchten, rufen Sie die Methode AchievementsClient.unlock() auf und geben Sie die Erfolgs-ID an.
Im folgenden Code-Snippet sehen Sie, wie in Ihrer App Erfolge freigeschaltet werden können:
PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));
Wenn der Erfolg vom inkrementellen Typ ist (d. h., es sind mehrere Schritte erforderlich, um ihn freizuschalten), rufen Sie stattdessen AchievementsClient.increment() auf.
Im folgenden Code-Snippet wird gezeigt, wie Ihre App den Erfolg des Spielers erhöhen kann:
PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);
Sie müssen keinen zusätzlichen Code schreiben, um den Erfolg freizuschalten. Der Erfolg wird automatisch von Google Play Spielediensten freigeschaltet, sobald die erforderliche Anzahl von Schritten erreicht wurde.
Es empfiehlt sich, die Erfolgs-IDs in der Datei strings.xml zu definieren, damit Ihr Spiel die Erfolge anhand der Ressourcen-IDs referenzieren kann. Wenn Sie Aufrufe zum Aktualisieren und Laden von Erfolgen ausführen, beachten Sie auch diese Best Practices, um zu vermeiden, dass Ihr API-Kontingent überschritten wird.
Erfolge anzeigen
Wenn du die Erfolge eines Spielers anzeigen möchtest, rufe AchievementsClient.getAchievementsIntent() auf, um eine Intent zu erhalten, mit der du die Standardoberfläche für Erfolge erstellen kannst. Ihr Spiel kann dann die Benutzeroberfläche aufrufen, indem es startActivityForResult aufruft.
Im folgenden Code-Snippet wird gezeigt, wie Ihre App die standardmäßige Benutzeroberfläche für Erfolge anzeigen kann. Im Snippet ist RC_ACHIEVEMENT_UI eine beliebige Ganzzahl, die vom Spiel als Anfragecode verwendet wird.
private static final int RC_ACHIEVEMENT_UI = 9003; private void showAchievements() { PlayGames.getAchievementsClient(this) .getAchievementsIntent() .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_ACHIEVEMENT_UI); } }); }
Unten sehen Sie ein Beispiel der Standard-Benutzeroberfläche für Erfolge.
