Inizia a usare i servizi per i giochi di Play per Android

Attenzione: questa guida è usata per l'utilizzo dell'SDK Play Games Services v1. Per informazioni sull'ultimo SDK, consulta la documentazione relativa alla versione 2 del servizio Play Giochi.

Ti diamo il benvenuto nello sviluppo di giochi Android con i servizi per i giochi di Google Play.

L'SDK Play Giochi offre servizi per i giochi Google Play multipiattaforma che ti consentono di integrare facilmente le funzionalità di gioco più diffuse, come obiettivi, classifiche e i giochi salvati nel tuo tablet e nei tuoi giochi mobile.

Questo corso di formazione ti aiuterà a installare un'applicazione di gioco per Android e a iniziare rapidamente a creare il tuo gioco per Android. L'app di esempio Sfida "Type-a-Number" mostra come integrare obiettivi e classifiche nel gioco.

Prima di iniziare

Per preparare l'app, completa i passaggi indicati nelle sezioni che seguono.

Prerequisiti dell'app

Assicurati che il file build della tua app utilizzi i seguenti valori:

• minSdkVersion di 19 o più
• A compileSdkVersion di 28 o superiore

Configurare il gioco in Google Play Console

Da Google Play Console puoi gestire i servizi per i giochi di Google Play per il tuo gioco e configurare i metadati per autorizzarlo e autenticarlo. Per scoprire di più, consulta la pagina Configurare i servizi per i giochi di Google Play.

Configura la tua app

Nel file build.gradle a livello di progetto, includi il repository Maven di Google e il repository centrale Maven nelle sezioni buildscript e allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Aggiungi la dipendenza Google Play Services per l'SDK Play Giochi al file di build Gradle del tuo modulo, che in genere è app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.1.0'
  }

Esempio di guida dell'app

Questo corso di formazione ti aiuterà a installare un'app di gioco per Android e a iniziare rapidamente a creare il tuo gioco per Android. L'app di esempio Sfida "Type-a-Number" mostra come integrare obiettivi e classifiche nel gioco.

Passaggio 1: scarica l'app di esempio

Per questa guida per gli sviluppatori, dovrai scaricare l'applicazione Android di esempio Type-a-Number Challenge.

Per scaricare e configurare l'applicazione di esempio in Android Studio:

1. Scarica gli esempi Android dalla pagina di download degli esempi.
2. Importa il progetto android-basic-samples. Questo progetto include TypeANumber e altri esempi di giochi Android. Per farlo in Android Studio:
   1. Fai clic su File > Importa progetto.
   2. Vai alla directory in cui hai scaricato android-basic-samples sulla tua macchina di sviluppo. Seleziona il file android-basic-samples/build.gradle e fai clic su OK.
3. Nel modulo TypeANumber, apri AndroidManifest.xml e modifica il nome del pacchetto da com.google.example.games.tanc a un tuo nome di pacchetto diverso. Il nuovo nome del pacchetto non deve iniziare con com.google, com.example o com.android.

Passaggio 2: configura il gioco in Google Play Console

Da Google Play Console puoi gestire i servizi per i giochi di Google Play per il tuo gioco e configurare i metadati per autorizzarlo e autenticarlo.

Per configurare il gioco di esempio in Google Play Console:

1. Punta il browser web su Google Play Console ed esegui l'accesso. Se non hai mai effettuato la registrazione a Google Play Console, ti verrà chiesto di farlo.
2. Segui queste istruzioni per aggiungere il tuo gioco a Google Play Console.
   1. Quando ti viene chiesto se utilizzi le API di Google nella tua app, seleziona Non utilizzo ancora le API di Google nel mio gioco.
   2. Ai fini di questa guida per gli sviluppatori, puoi compilare il modulo con i tuoi dettagli. Per comodità, puoi utilizzare le icone e gli screenshot segnaposto forniti nella pagina Download.
3. Segui queste istruzioni per generare un ID client OAuth 2.0 per la tua app Android.
   1. Quando colleghi la tua app Android, assicurati di specificare il nome esatto del pacchetto che hai utilizzato in precedenza quando rinomini il pacchetto di esempio.
   2. Puoi utilizzare la procedura guidata Genera APK firmata in Android Studio per generare un nuovo archivio chiavi e un certificato firmato, se non ne hai già uno. Per scoprire come eseguire la procedura guidata di generazione dell'APK firmato, consulta la pagina Firmare l'app in Android Studio.
4. Assicurati di registrare le seguenti informazioni per un secondo momento:
   1. Il tuo ID applicazione: è una stringa composta da sole cifre (in genere 12 o più) all'inizio dell'ID client.
   2. Il tuo certificato di firma: prendi nota del certificato che hai utilizzato durante la configurazione dell'accesso API (il certificato che ha fornito l'impronta SHA1). Devi usare lo stesso certificato per firmare la tua app quando la testi o la rilasci.
5. Configura gli obiettivi per la sfida Type-a-Number:
   1. Seleziona la scheda Obiettivi in Google Play Console.
   2. Aggiungi i seguenti obiettivi di esempio:

      Nome	Descrizione	Istruzioni speciali
      Principale	Ottieni un punteggio che è un numero primo.	Assente
      Humble	Richiedi un punteggio pari a 0.	Assente
      CANNOT TRANSLATE	Richiedi un punteggio di 9999 in entrambe le modalità.	Assente
      LEGGI GLI UTENTI	Ricevi un punteggio pari a 1337.	Rendilo un obiettivo nascosto.
      Noioso	Gioca 10 volte.	Rendilo un risultato incrementale con 10 passaggi per sbloccare.
      Molto noioso	Gioca 100 volte	Ottieni questo risultato come un risultato incrementale con 100 passi per sbloccare.

   3. Registra gli ID (stringhe alfanumeriche lunghe) per ogni obiettivo che hai creato.
   4. Configura gli obiettivi appropriati per il tuo gioco. Per saperne di più, consulta i concetti sui risultati e come implementare gli obiettivi in Android.
6. Configura le classifiche per la sfida Type-a-Number:
   1. Seleziona la scheda Classifiche in Google Play Console.
   2. Aggiungi due classifiche di esempio: una con nome "Punteggi migliori facili" e un'altra con "Punteggi alti rigidi". Entrambe le classifiche dovrebbero utilizzare la formattazione del punteggio intero con zero cifre decimali e un tipo di ordinamento di tipo Più grande è meglio.
   3. Registra gli ID (lunghe stringhe alfanumeriche) per ogni classifica creata.
   4. Configura le classifiche appropriate per il tuo gioco. Per scoprire di più, consulta i concetti sulle classifiche e come implementare le classifiche in Android.
7. Aggiungi account di prova per il tuo gioco. Questo passaggio è necessario soltanto per le app che non sono ancora state pubblicate in Google Play Console. Prima della pubblicazione dell'app, possono accedere solo gli account di prova elencati in Google Play Console. Tuttavia, una volta che un'applicazione è stata pubblicata, tutti possono accedere.

Avviso: se provi a effettuare chiamate all'SDK Play Giochi per un gioco non pubblicato utilizzando un account non elencato come account di prova, i servizi per i giochi di Google Play si comporteranno come se il gioco non esisteva e ti verrà restituito ConnectionResult.SIGN_IN_REQUIREDConnectionResult.SIGN_IN_REQUIRED il codice di ritorno. Se provi ad avviare ConnectionResult.startResolutionForResult(), tornerai GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Passaggio 3: modifica il codice

Per eseguire il gioco, devi configurare l'ID applicazione come risorsa nel tuo progetto Android. Dovrai anche aggiungere i metadati del gioco in AndroidManifest.xml.

1. Apri res/values/ids.xml e sostituisci gli ID segnaposto. Se stai creando un gioco Android da zero, dovrai prima creare il file.
   1. Specifica l'ID applicazione nella risorsa app_id.
   2. Specifica ogni ID obiettivo creato in precedenza nella risorsa achievement_* corrispondente.
   3. Specifica ogni ID leaderboard che hai creato in precedenza nella risorsa leaderboard_* corrispondente.
2. Apri AndroidManifest.xml e inserisci il nome del pacchetto nell'attributo package dell'elemento <manifest>. Se stai creando un gioco Android da zero, assicurati di aggiungere anche il seguente codice all'interno dell'elemento <application>:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

Passaggio 4: testa il gioco

Per assicurarti che i servizi per i giochi di Google Play funzionino correttamente nel tuo gioco, testa l'applicazione prima di pubblicarla su Google Play.

Nota: ti consigliamo di eseguire il test su un dispositivo Android fisico. Tuttavia, se non hai un dispositivo fisico, puoi eseguire un test con l'emulatore di Android. Per farlo, scarica l'immagine di sistema dell'emulatore che include Google Play Services, in Android 4.2.2, da SDK Manager.

Per eseguire il gioco sul tuo dispositivo di test fisico:

1. Verifica di aver configurato l'account di prova che utilizzi per accedere all'app (come descritto nel passaggio 2).
2. Esporta un APK e firmalo con lo stesso certificato che hai utilizzato per configurare il progetto in Google Play Console. Per esportare un APK firmato in Android Studio, fai clic su Crea > Genera APK firmato.
3. Installa l'APK firmato sul tuo dispositivo di test fisico utilizzando lo strumento adb. Per scoprire come installare un'applicazione, consulta Eseguire su un dispositivo.

Avviso: quando esegui un'applicazione direttamente da Android Studio, Android Studio firma la tua applicazione con il certificato di debug per impostazione predefinita. Se non hai utilizzato questo certificato di debug durante la configurazione dell'applicazione in Google Play Console, si verificheranno errori. Assicurati di eseguire un APK esportato e firmato con un certificato che corrisponda a uno dei certificati utilizzati durante la configurazione dell'applicazione in Google Play Console.