Erfolge in Unity-Spielen

In diesem Thema wird beschrieben, wie Sie in Unity-Spielen Erfolge der Play-Spieldienste verwenden. Es wird davon ausgegangen, dass Sie Ihr Projekt und das Google Play Spiele-Plug-in für Unity wie im Einstiegsleitfaden beschrieben eingerichtet haben.

Erfolg erstellen

Erstellen Sie beim Einrichten Ihres Projekts und Plug-ins die Erfolge in der Google Play Console und aktualisieren Sie dann das Plug-in mit den Android-Ressourcen für Ihre Erfolge. Weitere Informationen zum Erstellen von Erfolgen in der Play Console finden Sie im Leitfaden zu Erfolgen.

Erfolg freischalten und sichtbar machen

Um einen Erfolg freizuschalten, verwenden Sie die Methode Social.ReportProgress mit einem Fortschrittswert von 100.0f:

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // unlock achievement (achievement ID "Cfjewijawiu_QA")
    Social.ReportProgress("Cfjewijawiu_QA", 100.0f, (bool success) => {
      // handle success or failure
    });

Gemäß dem erwarteten Verhalten von Social.ReportProgress bedeutet ein Wert von 0,0 f, dass der Erfolg angezeigt wird, und ein Fortschritt von 100,0 f, dass der Erfolg freigeschaltet wurde.

Wenn du ein zuvor ausgeblendetes Achievement ohne Entsperrung anzeigen möchtest, rufe Social.ReportProgress mit dem Wert „0.0f“ auf.

Erfolg erhöhen

Wenn der Erfolg inkrementell ist, wird bei der Play Spiele-Implementierung von Social.ReportProgress versucht, das erwartete Verhalten gemäß der Social API von Unity einzuhalten. Das Verhalten ist jedoch möglicherweise nicht identisch. Daher empfehlen wir, Social.ReportProgress nicht für inkrementelle Erfolge zu verwenden. Verwenden Sie stattdessen die Methode PlayGamesPlatform.IncrementAchievement, eine Play Spiele-Erweiterung.

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // increment achievement (achievement ID "Cfjewijawiu_QA") by 5 steps
    PlayGamesPlatform.Instance.IncrementAchievement(
        "Cfjewijawiu_QA", 5, (bool success) => {
            // handle success or failure
    });

Benutzeroberfläche für Erfolge anzeigen

Wenn du die integrierte Benutzeroberfläche für alle Erfolge anzeigen möchtest, rufe Social.ShowAchievementsUI auf.

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // show achievements UI
    Social.ShowAchievementsUI();