Obiettivi nei giochi Unity

Questo argomento descrive come utilizzare gli obiettivi dei servizi per i giochi di Play in Unity giochi. Si presuppone che tu abbia configurato il progetto Plug-in di Google Play Giochi per Unity, come spiegato nella Guida introduttiva.

Creare un obiettivo

Quando imposti il progetto e il plug-in, crea gli obiettivi in Google Play Console e quindi aggiorna il plug-in con le risorse Android per i tuoi risultati. Per maggiori dettagli sulla creazione di obiettivi in Play Console, consulta le guida agli obiettivi.

Scopri e sblocca un obiettivo

Per sbloccare un obiettivo, utilizza il metodo Social.ReportProgress con un valore di avanzamento di 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
    });

In base al comportamento previsto Social.ReportProgress, un valore di 0.0f significa che l’obiettivo viene rivelato e un avanzamento di 100.0f significa che l'obiettivo è stato sbloccato.

Per rivelare un risultato ottenuto in precedenza era nascosto senza sbloccarlo, chiama Social.ReportProgress con con un valore di 0.0f.

Incrementare un obiettivo

Se l'obiettivo è incrementale, l'implementazione di Play Giochi Social.ReportProgress cercherà di rispettare le comportamento previsto in base all'API social di Unity. Il comportamento potrebbe non essere Tuttavia, ti consigliamo di non utilizzare Social.ReportProgress per di obiettivi incrementali. Utilizza invece PlayGamesPlatform.IncrementAchievement, che è un estensione Play Giochi.

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

Mostra l'interfaccia utente degli obiettivi

Per mostrare la UI integrata per tutti gli obiettivi, chiama Social.ShowGoalmentsUI.

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