Inizia a utilizzare il plug-in Google Play Giochi per Unity

Questo argomento descrive come configurare il progetto Unity per utilizzare il plug-in di Google Play Giochi per Unity. Le attività includere l'impostazione del progetto, la scelta di una piattaforma social e la configurazione l'accesso al giocatore.

Prima di iniziare

Installazione di plug-in

  1. Scarica il plug-in mediante una delle seguenti opzioni:

  2. Individua il file unitypackage nella directory current-build. Questo file è il plug-in. Ad esempio, dovrebbe avere un aspetto simile al seguente:

      current-build/GooglePlayGamesPluginForUnity-X.YY.ZZ.unitypackage

  3. Apri il progetto di gioco in Unity.

  4. Importa il file unitypackage negli asset del progetto facendo clic sull'icona Asset > Importa pacchetto > Voce di menu Pacchetto personalizzato.

  5. Assicurati che la piattaforma di compilazione attuale sia impostata su Android.

    1. Nel menu principale, fai clic su File > Impostazioni build....

    2. Seleziona Android e fai clic su Cambia piattaforma.

    3. Dovrebbe essere presente una nuova voce di menu in Finestra > Google Play Giochi. Se non sono presenti, aggiorna gli asset facendo clic su Asset > Aggiorna e quindi prova a impostare di nuovo la piattaforma di creazione.

Scarica risorse Android da Play Console

Ogni obiettivo, classifica ed evento in cui crei Play Console include una risorsa Android che utilizzi quando configurare il progetto Unity.

  1. Scarica le risorse Android per il tuo gioco.

    1. In Play Console, apri il progetto dei servizi per i giochi di Play per il tuo gioco.

    2. Fai clic sulla scheda Obiettivi, quindi su Trova risorse.

    3. Nella finestra Esporta risorse, fai clic sulla scheda Android.

    4. Seleziona e copia i contenuti XML.

Configura il progetto Unity

  1. Aggiungi le risorse Android al tuo progetto Unity.

    1. In Unity, fai clic su ** Finestra > Google Play Giochi > Configura... > Configurazione Android **.

    2. Completa le seguenti operazioni nelle finestre di configurazione:

    3. Directory in cui salvare le costanti: la cartella del file delle costanti.

    4. Nome classe costanti: il nome della classe C# da creare, incluso lo spazio dei nomi.

    5. Definizione delle risorse: incolla qui i dati delle risorse Android da Play Console.

    6. ID client web: l'ID client dell'app web collegata. Questo è solo necessaria se hai un backend basato sul web per il tuo gioco e ti serve un codice di autorizzazione del server per scambiare un token di accesso server di backend o se ti serve un token ID affinché il player chiamate API non-game.

    7. Fai clic su Configura. Il gioco viene configurato con l'ID client e genera una classe C# che contiene costanti per ciascuno dei tuoi Google Cloud.

Configurazione Android

Configura il percorso di installazione dell'SDK Android in Unity. Si trova in nel menu delle preferenze nella sezione Strumenti esterni.

Per configurare il gioco Unity per l'esecuzione con Google Play Giochi su Android, devi prima apri Android SDK Manager e verifica di aver scaricato quanto segue pacchetti. A seconda che utilizzi o meno SDK Manager di Android Studio, oppure utilizzando la versione autonoma di SDK Manager, i nomi dei componenti potrebbero essere diversi. - Google Play Services - Raccolta di assistenza Android - Repository Maven locale per le librerie di assistenza (noto anche come servizio di assistenza Android) repository) - Repository Google - Android 6.0 (API 23) (non influisce sulla versione minima dell'SDK).

A questo punto, configura il nome del pacchetto del gioco. A questo scopo, fai clic su File > Costruire Impostazioni, seleziona la piattaforma Android e fai clic su Impostazioni player per mostra la finestra Impostazioni del player di Unity. In questa finestra, cerca il set di dati Identifier in Altre impostazioni. Inserisci qui il nome del pacchetto (ad esempio com.example.my.awesome.game).

Per accedere ai servizi per i giochi di Play, devi firmare il file APK, assicurati di firmarlo con corretto, ovvero quello che corrisponde al certificato SHA1 fingerprint che hai inserito nella Console per gli sviluppatori durante la configurazione.

Dopodiché fai clic sulla voce di menu Finestra |Google Play Giochi|Configurazione - Configurazione di Android. Viene visualizzata la schermata di configurazione di Android.

Inserisci il nome della classe Costanti. Questo è il nome della classe completa che verrà aggiornato (o creato) e contiene gli ID delle risorse del gioco. Il formato del nome è <namespace>.<classname>. Ad esempio: AwesomeGame.GPGSIds

Incolla i dati della definizione della risorsa. Questi sono i dati XML di Google Play Developer Console, che contiene gli ID risorsa e l'ID applicazione per Android.

Questi dati vengono trovati in Google Play Console facendo clic su "Ricevi risorse" in una qualsiasi delle pagine delle risorse (ad es. Obiettivi o Classifiche), quindi su Android.

Dopo aver incollato i dati nell'area di testo, fai clic sul pulsante Configurazione.

Nota: se utilizzi un'applicazione web o un server di backend con il tuo gioco, puoi collegare l'applicazione web al gioco per consentire di recuperare token ID e/o indirizzo email. Per farlo, collega un'applicazione web al in Google Play Console e inserisci l'ID client per l'applicazione web nella finestra di dialogo di configurazione.

Istruzioni aggiuntive sulla creazione per Android su Windows

Se utilizzi Windows, devi assicurarti che l'installazione dell'SDK Java sono accessibili da Unity. Per

  1. Imposta la variabile di ambiente JAVA_HOME sul percorso di installazione dell'SDK Java (ad es. C:\Program Files\Java\jdk1.7.0_45).
  2. Aggiungi la cartella bin dell'SDK Java alla variabile di ambiente PATH (ad es. C:\Program Files\Java\jdk1.7.0_45\bin)
  3. Riavvia.

Come modificare le variabili di ambiente: in Windows 2000/XP/Vista/7, fai clic con il tasto destro del mouse Risorse del computer, Proprietà e infine vai a Proprietà di sistema avanzate (o Proprietà di sistema e fai clic sulla scheda Avanzate), quindi fai clic su Variabili di ambiente. Su Windows 8, premi tasto Windows + W e cerca Per le variabili di ambiente, consulta la documentazione per la tua versione di Windows.

Esegui il progetto

Se utilizzi l'esempio Test di fumo, dovresti essere in grado di creare ed eseguire il progetto a questo punto. Verrà visualizzato il tentativo di accesso automatico. all'avvio di Smoketest.

Per creare ed eseguire su Android, fai clic su File > Impostazioni build, seleziona la piattaforma Android e poi Passa alla piattaforma, quindi Crea ed esegui.

Scegli una piattaforma social

Il plug-in di Google Play Giochi implementa il plug-in di Unity interfaccia social, per la compatibilità con giochi che usano già questa interfaccia durante l'integrazione con altri piattaforme di terze parti. Tuttavia, alcune funzionalità sono specifiche di Play Giochi e sono offerte come estensioni all'interfaccia social standard fornita da Unity.

È possibile accedere alle chiamate API standard tramite l'oggetto Social.Active, che fa riferimento a un'interfaccia ISocialPlatform. L'interfaccia non standard Puoi accedere alle estensioni di Google Play Giochi trasmettendo il file Social.Active nella classe PlayGamesPlatform, dove i metodi aggiuntivi sono disponibili.

Utilizza il plug-in senza eseguire l'override della piattaforma social predefinita

Quando chiami PlayGamesPlatform.Activate, Google Play Giochi diventa il tuo implementazione predefinita sulla piattaforma social, il che significa che le chiamate statiche ai metodi in Social e Social.Active verrà svolta dal team di Google Play Giochi . Si tratta del comportamento previsto per la maggior parte dei giochi che utilizzano il plug-in.

Tuttavia, se per qualche motivo vuoi mantenere l'implementazione predefinita accessibili (ad esempio, per inviare obiettivi e classifiche a un un'altra piattaforma social), puoi utilizzare il plug-in di Google Play Giochi senza che eseguono l'override di quello predefinito. Per

  1. Non chiamare PlayGamesPlatform.Activate
  2. Se Xyz è il nome di un metodo che vuoi chiamare nella classe Social, non chiamare Social.Xyz. Chiama il numero PlayGamesPlatform.Instance.Xyz
  3. Non usare Social.Active durante l'interazione con Google Play Giochi. Invece, usa PlayGamesPlatform.Instance.

In questo modo, puoi anche inviare punteggi e risultati contemporaneamente a due Altre piattaforme social:

    // Submit achievement to original default social platform
    Social.ReportProgress("MyAchievementIdHere", 100.0f, callback);

    // Submit achievement to Google Play
    PlayGamesPlatform.Instance.ReportProgress("MyGooglePlayAchievementIdHere", 100.0f, callback);

Verifica il servizio di accesso

Viene tentato automaticamente di connettersi ai servizi per i giochi di Play utilizzando l'app Il servizio di accesso all'apertura del gioco. Se connessione riesce, il gioco mostra una richiesta di accesso ed è pronto per utilizzare Plug-in di Google Play Giochi per Unity.

Se un utente non ha mai utilizzato Google Play Giochi sul proprio dispositivo, acquisita automaticamente tramite la schermata di configurazione una tantum per creare un Play Giochi .

Nel metodo Start dello script, ascolta il risultato dell'audio tentativo di accesso, recupera lo stato dell'autenticazione e disattiva Play Giochi Funzionalità dei servizi se l'utente non ha eseguito l'accesso.

    using GooglePlayGames;

    public void Start() {
      PlayGamesPlatform.Instance.Authenticate(ProcessAuthentication);
    }

    internal void ProcessAuthentication(SignInStatus status) {
      if (status == SignInStatus.Success) {
        // Continue with Play Games Services
      } else {
        // Disable your integration with Play Games Services or show a login button
        // to ask users to sign-in. Clicking it should call
        // PlayGamesPlatform.Instance.ManuallyAuthenticate(ProcessAuthentication).
      }
    }
}

Il codice risultato è un'enumerazione che puoi utilizzare per identificare il motivo di un accesso errore.

Se preferisci utilizzare la piattaforma social di Unity, puoi in alternativa utilizzare la codice seguente:

  using GooglePlayGames;

  public void Start() {
    PlayGamesPlatform.Activate();
    Social.localUser.Authenticate(ProcessAuthentication);
  }

Non puoi effettuare chiamate all'API Google Play Giochi finché non avrai ricevuto un esito positivo valore restituito da Authenticate. Di conseguenza, consigliamo che i giochi mostrino schermata di standby finché non viene chiamato il callback per assicurarsi che gli utenti non possano iniziare a giocare il gioco fino al completamento dell'autenticazione.

Recupera i codici di autenticazione del server

Per accedere alle API di Google su un server web di backend per conto del devi ottenere un codice di autenticazione dall'applicazione client e e lo passiamo alla tua applicazione server web. Il codice può quindi essere scambiato un token di accesso per effettuare chiamate alle varie API. Per informazioni sui flusso di lavoro, consulta Accedi con Google per i siti web.

Per ottenere il codice di accesso lato server:

  1. Configura l'ID client web dell'applicazione web collegata al tuo gioco nella Play Console.

  2. Chiama PlayGamesPlatform.Instance.RequestServerSideAccess quando il giocatore per ottenere il codice di accesso lato server.

  3. Passa questo codice all'applicazione server.

  PlayGamesPlatform.Instance.RequestServerSideAccess(
    /* forceRefreshToken= */ false,
    code -> {
      // send code to server
    });

Configurare e aggiungere funzionalità