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

Attenzione: questa guida è dedicata all'utilizzo dell'SDK Play Giochi Services v1. Per informazioni sull'ultimo SDK, consulta la documentazione relativa al servizio Play Giochi v2.

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

L'SDK di Play Giochi offre servizi per i giochi Google Play multipiattaforma che ti consentono di integrare facilmente funzionalità di gioco popolari come obiettivi, classifiche e 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 creare rapidamente il tuo gioco Android. L'app di esempio Sfida "Digita un numero" mostra come integrare obiettivi e classifiche nel tuo gioco.

Prima di iniziare

Per preparare la tua app, completa i passaggi nelle sezioni seguenti.

Prerequisiti dell'app

Assicurati che il file di build dell'app utilizzi i seguenti valori:

• minSdkVersion di 19 su
• Un compileSdkVersion di 28 o più

Configura il tuo gioco in Google Play Console

Da Google Play Console gestisci i servizi per i giochi di Google Play per il tuo gioco e configura i metadati per autorizzare e autenticare il tuo gioco. Per scoprire di più, consulta l'articolo 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'
  }

Guida alle app di esempio

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

Passaggio 1: scarica l'app di esempio

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

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

1. Scaricare esempi di Android dalla pagina di download di 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 da 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 nome del 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 gestisci i servizi per i giochi di Google Play per il tuo gioco e configura i metadati per autorizzare e autenticare il tuo gioco.

Per configurare l'esempio del gioco in Google Play Console:

1. Punta il browser web su Google Play Console e accedi. Se non hai ancora 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 nessuna API di Google nel mio gioco.
   2. Ai fini di questa guida per gli sviluppatori, puoi compilare il modulo con i tuoi dettagli di gioco. Per comodità, puoi utilizzare le icone segnaposto e gli screenshot forniti nella pagina Download.
3. Segui queste istruzioni per generare un ID client OAuth 2.0 per la tua app Android.
   1. Quando colleghi l'app per Android, assicurati di specificare il nome esatto del pacchetto utilizzato in precedenza durante la ridenominazione del pacchetto di esempio.
   2. Puoi utilizzare la procedura guidata di generazione dell'APK firmato in Android Studio per generare un nuovo archivio chiavi e un certificato firmato se non ne hai già uno. Per informazioni su come eseguire la procedura guidata di generazione dell'APK firmato, consulta l'articolo Firmare l'app in Android Studio.
4. Assicurati di registrare le seguenti informazioni per un secondo momento:
   1. Il tuo ID applicazione: si tratta di una stringa composta solo da cifre (in genere 12 o più) all'inizio del tuo ID client.
   2. Il certificato di firma: prendi nota del certificato che hai utilizzato durante la configurazione dell'accesso API (il certificato di cui hai fornito l'impronta SHA1). Devi utilizzare lo stesso certificato per firmare la tua app durante il test o il rilascio dell'app.
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
      Non fare l'imbarazzo, bambino	Richiedi un punteggio di 9999 in entrambe le modalità.	Assente
      OMG U R TEH UBER LEET!	Ricevi un punteggio di 1337.	Rendi questo obiettivo nascosto.
      Annoiato	Gioca 10 volte.	Ottieni questo risultato incrementale con 10 passaggi per sbloccarlo.
      Molto annoiato	Gioca 100 volte.	Rendi questo obiettivo un risultato incrementale con 100 passi da sbloccare.

   3. Registra gli ID (stringhe alfanumeriche lunghe) per ciascun obiettivo che hai creato.
   4. Configura gli obiettivi appropriati per il gioco. Per scoprire di più, consulta i concetti dei 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 denominata "Punteggi alti facili" e un'altra denominata "Punteggi alti e rigidi". Entrambe le classifiche devono utilizzare la formattazione del punteggio intero con zero cifre decimali e un tipo di ordinamento con il formato Più grande è meglio.
   3. Registra gli ID (lunghe stringhe alfanumeriche) per ogni leaderboard che hai creato.
   4. Configura le classifiche adatte al tuo gioco. Per scoprire di più, consulta i concetti dei dietro le classifiche e come implementare le classifiche in Android.
7. Aggiungi account di prova per il tuo gioco. Questo passaggio è necessario solo per le app che non sono ancora state pubblicate in Google Play Console. Prima che l'app venga pubblicata, possono accedere solo gli account di prova elencati in Google Play Console. Tuttavia, una volta pubblicata un'applicazione, tutti possono accedere.

Avviso: se provi a effettuare chiamate all'SDK Play Giochi per un gioco non pubblicato usando un account non elencato come account di prova, i servizi per i giochi di Google Play si comporteranno come se il gioco non esistesse e riceverai il codice di reso ConnectionResult.SIGN_IN_REQUIRED. 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 progetto Android. Dovrai anche aggiungere i metadati dei giochi 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 questo 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 crei un gioco Android da scraping, 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 una verifica con l'emulatore Android. Per farlo, scarica da SDK Manager l'immagine di sistema dell'emulatore che include Google Play Services, in Android 4.2.2.

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, vedi In esecuzione su un dispositivo.

Avviso: quando esegui l'applicazione direttamente da Android Studio, Android Studio firmerà l'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 che hai esportato e firmato con un certificato che corrisponda a uno dei certificati che hai utilizzato durante la configurazione dell'applicazione in Google Play Console.