Erfolge können eine hervorragende Möglichkeit zum Steigern der Nutzerinteraktionen innerhalb Ihres Spiels sein. Sie können Erfolge in Ihrem Spiel implementieren, um Spieler zu ermutigen, mit Funktionen zu experimentieren, die sie normalerweise nicht verwenden, oder um Ihr Spiel mit völlig anderen Spielstilen zu gestalten. Erfolge können auch eine unterhaltsame Möglichkeit für Spieler sein, ihre Fortschritte miteinander zu vergleichen und sich in unbeschwertem Wettbewerb zu messen.
Informationen zur Implementierung von Erfolgen für Ihre Plattform finden Sie unter Clientimplementierungen.
Merkmale
Zum Verständnis der Funktionsweise von Erfolgen sollten Sie mit einigen der mit ihnen verbundenen Attribute vertraut sein.
Die folgenden grundlegenden Elemente spielen bei allen Erfolgen eine Rolle:
- Die ID ist ein eindeutiger String, der von der Google Play Console generiert wird. Mithilfe dieser eindeutigen ID verweisen Sie auf den Erfolg in Ihren Spiel-Clients.
- Der Name ist ein Kurzname für den Erfolg, z. B. "Meister Pieman". Er kann bis zu 100 Zeichen umfassen.
- Die Beschreibung bietet eine kurze Beschreibung Ihres Erfolgs. In der Regel teilt dies dem Spieler mit, wie er den Erfolg erzielt hat (z. B. „Backe vor Sonnenuntergang ein Zitronenbaiser). Die Beschreibung kann bis zu 500 Zeichen umfassen.
- Das Symbol ist ein quadratisches Symbol, das mit Ihrem Erfolg verknüpft ist. Best Practices beim Erstellen Ihrer Erfolgssymbole finden Sie im Abschnitt Symbolrichtlinien.
- Die Listenreihenfolge gibt an, in welcher Reihenfolge die gesperrten Erfolge angezeigt werden, wenn ein Spieler die zu Ihrem Spiel gehörenden Erfolge aufruft. Sie können die Reihenfolge in beliebiger Reihenfolge festlegen. Freigeschaltete Erfolge werden oben in der Liste in der erreichten Reihenfolge angezeigt.
Bundesland
Erfolge können einen von drei verschiedenen Status haben:
- Bei einem verborgenen Erfolg sind Details zum Erfolg für den Spieler verborgen. Die Play-Spieldienste stellen im ausgeblendeten Zustand eine generische Platzhalterbeschreibung und ein generisches Symbol für den Erfolg bereit. Wir empfehlen, einen Erfolg zu verbergen, wenn er einen Spoiler zu deinem Spiel enthält, den du nicht zu früh verraten möchtest (z. B. „Finde heraus, dass du die ganze Zeit ein Geist warst!“).
- Ein offener Erfolg bedeutet, dass der Spieler den Erfolg zwar kennt, ihn aber noch nicht erhalten hat. Die meisten Erfolge befinden sich anfangs im aufgedeckten Status.
- Ein freigeschalteter Erfolg bedeutet, dass der Spieler den Erfolg erfolgreich erzielt hat. Ein Erfolg kann offline freigeschaltet werden. Wenn das Spiel online geht, wird es mit den Play-Spieldiensten synchronisiert, um den entsperrten Status des Erfolgs zu aktualisieren.
Inkrementelle Erfolge
Erfolge können als Standarderfolge oder inkrementelle Erfolge festgelegt werden. Im Allgemeinen macht ein Spieler bei einem inkrementellen Erfolg über einen längeren Zeitraum hinweg schrittweise Fortschritte in Richtung des Erreichens des Erfolgs. Während der Spieler Fortschritte beim inkrementellen Erfolg macht, können Sie seinen teilweisen Fortschritt an die Play-Spieldienste melden.
Der Google Play-Dienst verfolgt die Fortschrittsinformationen, benachrichtigt das Spiel, wenn der Spieler die erforderlichen Kriterien zum Freischalten dieses Erfolgs erfüllt hat, und teilt dem Spieler mit, wie weit er auf dem Weg zum Erreichen dieses Ziels ist.
![Beispiel eines inkrementellen Erfolgs mit einem Spielfortschritt von 40 %](https://developer.android.com/static/images/games/pgs/achievementIncremental.png?authuser=6&hl=de)
Inkrementelle Erfolge werden über Spielsitzungen hinweg addiert. Fortschritte können nicht innerhalb des Spiels entfernt oder zurückgesetzt werden. Beispiel: "Gewinne 50 Spiele" wird als inkrementeller Erfolg gewertet. „Gewinne 3 Spiele in Folge“ nicht, da der Fortschritt eines Spielers zurückgesetzt wird, wenn er ein Spiel verliert. „5.000 Pokerchips haben“ gilt ebenfalls nicht, da ein Spieler während des Spielens Chips gewinnen und verlieren kann. Bei den letzten beiden Erfolgen ist es Ihre Aufgabe, den Status „Siege nacheinander“ oder die Chips des Spielers zu erfassen und Standarderfolge freizuschalten, wenn der Spieler sie erzielt.
Beim Erstellen eines inkrementellen Erfolgs müssen Sie die Gesamtanzahl der erforderlichen Schritte bis zum Freischalten des Erfolgs definieren. Dies muss eine Zahl zwischen 2 und 10.000 sein. Während der Nutzer Fortschritte beim Freischalten des Erfolgs macht, solltest du die Anzahl der zusätzlichen Schritte, die der Nutzer in den Play-Spieldiensten ausgeführt hat, melden. Sobald die Gesamtzahl der Schritte den Freischaltwert erreicht, wird der Erfolg entsperrt (auch wenn er ausgeblendet war). Sie brauchen den kumulativen Fortschritt des Nutzers nicht zu speichern.
Punkte
Mit Erfolgen ist ein Punktwert verknüpft. Die Punktzahl des Spielers muss ein Vielfaches von 5 sein und ein Spiel kann niemals mehr als 1.000 Punkte für alle Erfolge haben, es kann aber weniger sein. Außerdem kann kein einzelner Erfolg mehr als 200 Punkte haben.
Erfahrungspunkte erfassen (XP)
Spieler können in ihrem Spielprofil ein Level erreichen, wenn sie in Spielen, die für Play Spiele aktiviert sind, Erfolge erzielen. Für jeden mit einem Erfolg verknüpften Punkt erhält der Spieler 100 Erfahrungspunkte (XP). Mit anderen Worten:
XP for an achievement = 100 * (point value for the achievement)
Die Play-Spieldienste erfassen die XP, die jeder Spieler erhält, und sendet eine Benachrichtigung an die Google Play Spiele App, wenn der Spieler genügend Punkte gesammelt hat, um das nächste Level zu erreichen. Spieler können ihren Level- und XP-Verlauf auf ihrer Profilseite in der Google Play Spiele App einsehen.
Mindestzahl von Erfolgen
Ein Spiel mit integrierten Erfolgen sollte vor der Veröffentlichung mindestens fünf Erfolge haben. Sie können Tests mit weniger als fünf Erfolgen durchführen. Wir empfehlen jedoch, mindestens fünf Erfolge zu erstellen, bevor Sie Ihr Spiel veröffentlichen.
Maximale Erfolge
Die Anzahl der Erfolge ist durch die Punkte und die Verteilung begrenzt. Bei einer maximalen Anzahl von 1.000 Punkten und jedem Erfolg, der 5 Punkte zugewiesen wird, beträgt die maximale Anzahl von Erfolgen 200. Werden Erfolge jedoch mehr Punkte zugewiesen, sinkt dadurch die Anzahl der verfügbaren Erfolge.
Symbolrichtlinien
Symbole sollten als PNG- oder JPG-Dateien im Format 512 x 512 erstellt werden. Sie müssen uns nur das Symbol für den freigeschalteten Erfolg zur Verfügung stellen. Wir generieren automatisch eine Graustufenversion für das aufgedeckte Symbol. Aus diesem Grund empfehlen wir, dass Ihre Erfolgssymbole farbenfrohe Elemente enthalten, damit Ihre Nutzer leicht zwischen aufgedeckten und freigeschalteten Erfolgen unterscheiden können.
Wenn ein Erfolgssymbol in einem Android-Toast angezeigt wird, wird das Symbol von einem Kreis überlagert und seine äußeren Ecken werden ausgeblendet. Vergewissern Sie sich, dass Ihr Symbol auch unter diesen Umständen gut aussieht.
![Beispiel eines Erfolgssymbols in einem Kreis](https://developer.android.com/static/images/games/pgs/achievementIconExample.png?authuser=6&hl=de)
Dasselbe Symbol wird für alle Gebietsschemas verwendet. Deshalb raten wir davon ab, in Symbolen Text oder lokalisierte Inhalte zu verwenden.
Erfolg erstellen
In diesem Abschnitt wird beschrieben, wie Sie Erfolge für neue und veröffentlichte Spiele erstellen.
Neues Spiel
Wenn Sie einen Erfolg für ein neues und unveröffentlichtes Spiel erstellen möchten, rufen Sie in der Google Play Console auf dem Tab Spiele mit Spieldiensten den Eintrag für Ihr Spiel auf.
Wählen Sie links den Tab Erfolge aus und klicken Sie auf die Schaltfläche Erfolg hinzufügen.
![Schaltfläche "Erfolg hinzufügen" im Hauptsteuerfeld für Erfolge](https://developer.android.com/static/images/games/pgs/achievementAddButton.png?authuser=6&hl=de)
Geben Sie anschließend einfach die für diesen Erfolg erforderlichen Informationen ein.
![Beispiel eines ausgefüllten Erfolgsformulars für den Erfolg "Letzter Platz"](https://developer.android.com/static/images/games/pgs/achievementSampleForm.png?authuser=6&hl=de)
Klicken Sie auf Speichern. Ihr Erfolg wird dann im Modus "Bereit zur Veröffentlichung" zur Verfügung gestellt. Sobald Sie Ihr Spiel veröffentlichen, werden damit auch alle Erfolge Ihres Spiels veröffentlicht.
Veröffentlichtes Spiel
Führen Sie dieselben Schritte wie oben aus, um für ein bereits veröffentlichtes Spiel einen zusätzlichen Erfolg zu erstellen. Der einzige Unterschied besteht darin, dass die Schaltfläche Speichern nun mit Als Entwurf speichern beschriftet ist und sich Ihr Erfolg im Modus "Bereit zum Testen" befindet. Weitere Informationen zum Testen einer aktualisierten Version eines Spiels finden Sie unter Spieländerungen veröffentlichen.
Nachdem Sie Ihren Erfolg erfolgreich getestet haben, können Sie Ihr Spiel mit den neuen Erfolgen erneut veröffentlichen und so weltweit verfügbar machen.
Erfolg bearbeiten
Wenn Sie einen bereits erstellten Erfolg bearbeiten möchten, wählen Sie ihn in der Google Play Console auf dem Tab Erfolge aus. Hier sehen Sie dasselbe Formular, das Sie beim Erstellen des Erfolgs verwendet haben. Sie können jedes Feld nach Belieben bearbeiten.
Klicken Sie nach dem Bearbeiten eines Erfolgs auf die Schaltfläche Als Entwurf speichern. Der neu bearbeitete Erfolg befindet sich im Status „Bereit zum Testen“ und Sie können ihn testen. Wenn er korrekt funktioniert, wählen Sie in der Drop-down-Liste Erneut veröffentlichen aus. Dadurch wird dein Spiel zusammen mit allen aktualisierten Erfolgen noch einmal veröffentlicht.
Änderungen rückgängig machen
Wenn dir dein aktueller Erfolg nicht gefällt und du zu deinem bisherigen Erfolg zurückkehren möchtest, wähle in der Google Play Console in der Drop-down-Liste die Option Rückgängig machen aus. Alle Erfolge werden dann auf die zuvor veröffentlichte Version zurückgesetzt.
Erfolg löschen
Sobald Ihr Erfolg veröffentlicht wurde, kann er nicht mehr gelöscht werden.
Sie können nur unveröffentlichte Erfolge löschen, indem Sie unten im Formular für den entsprechenden Erfolg auf die Schaltfläche Löschen klicken.
Erfolg zurücksetzen
Du kannst nur die Fortschrittsdaten deiner Spieler im Entwurfsmodus zurücksetzen.
- Wenn Sie Erfolge in der Google Play Console zurücksetzen möchten, klicken Sie unten im Formular für das Ereignis auf die Schaltfläche Erfolgsfortschritt zurücksetzen.
- Wenn Sie Erfolgsdaten programmatisch zurücksetzen möchten, rufen Sie die
Achievements
-Methoden der Management API auf.
Übersetzungen für Erfolge hinzufügen
Sie können Ihre eigenen Übersetzungen für die zu Ihrem Spiel gehörigen Erfolge angeben. Führen Sie vorher die unter Übersetzungen für Ihr Spiel hinzufügen beschriebenen Schritte aus. Außerdem müssen Sie einen oder mehrere Erfolge für Ihr Spiel erstellt haben.
Wenn Sie eigene Übersetzungen für Erfolge hinzufügen möchten, öffnen Sie in der Google Play Console den Tab Erfolge für Ihr Spiel und wählen Sie einen vorhandenen Erfolg aus. Wählen Sie auf der Detailseite des Erfolgs den Tab für eine Sprache aus, die Sie zuvor auf dem Tab Spieldetails hinzugefügt haben. Bearbeiten Sie auf der Erfolgsdetailseite für diese Sprache das Formular mit Ihren Übersetzungen für diesen Erfolg. Klicken Sie auf Speichern, um Ihre übersetzten Erfolgsdetails zu speichern.
Clientimplementierungen
Informationen zur Implementierung von Erfolgen für deine Plattform findest du in den folgenden Ressourcen: