Succès dans les jeux Unity

Cet article explique comment utiliser les succès des services de jeux Play dans les jeux Unity. Nous partons du principe que vous avez configuré votre projet et le plug-in Google Play Jeux pour Unity, comme indiqué dans le guide de démarrage.

Créer un succès

Après avoir configuré votre projet et le plug-in, créez les succès dans la Google Play Console, puis mettez le plug-in à jour avec les ressources Android de vos succès. Pour en savoir plus sur la création de succès dans la Play Console, consultez le guide des succès.

Afficher et débloquer un succès

Pour débloquer un succès, utilisez la méthode Social.ReportProgress avec une valeur de progression de 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
    });

En fonction du comportement attendu de Social.ReportProgress, une valeur de 0,0f signifie que le succès s'affiche, et une progression de 100,0f que le succès est débloqué.

Pour afficher un succès qui était auparavant masqué sans le débloquer, appelez Social.ReportProgress avec une valeur de 0.0f.

Incrémenter un succès

Si le succès est incrémentiel, l'implémentation de Social.ReportProgress dans Play Jeux s'efforcera de respecter le comportement attendu d'après l'API Social d'Unity. Il est toutefois possible que le comportement ne soit pas identique. Nous vous recommandons donc de ne pas utiliser Social.ReportProgress pour les succès incrémentiels. Utilisez plutôt la méthode PlayGamesPlatform.IncrementAchievement, qui est une extension Play Jeux.

    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
    });

Afficher l'interface utilisateur des succès

Pour afficher l'interface utilisateur intégrée de tous les succès, appelez Social.ShowAchievementsUI.

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