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

Attenzione: questa guida riguarda l'utilizzo dell'SDK dei servizi per i giochi di Play v1. Per informazioni sull'SDK più recente, consulta la documentazione del 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 fornisce servizi per i giochi multipiattaforma di Google Play che ti consentono di integrare facilmente funzionalità di gioco popolari come obiettivi, classifiche e Partite salvate nei tablet e nei giochi mobile.

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

Prima di iniziare

Per preparare l'app, completa i passaggi nelle sezioni seguenti.

Prerequisiti dell'app

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

• minSdkVersion in più di 19
• Un compileSdkVersion di 28 o superiore

Configura il tuo gioco in Google Play Console

In Google Play Console puoi gestire i servizi per i giochi di Google Play per il tuo gioco e configurare i metadati per autorizzare e autenticare il tuo gioco. Per ulteriori informazioni, consulta la sezione Configurazione dei 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 in entrambe le sezioni buildscript e allprojects:

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

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

Aggiungi la dipendenza di Google Play Services per l'SDK di 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 di esempio per Android e a iniziare rapidamente a creare il tuo gioco Android. L'app di esempio per la sfida Type-a-Number mostra come integrare obiettivi e classifiche nel tuo gioco.

Passaggio 1: scarica l'app di esempio

Per questa guida per gli sviluppatori, devi 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. Passa 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 cambia il nome del pacchetto da com.google.example.games.tanc a un 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

In Google Play Console puoi gestire i servizi per i giochi di Google Play per il tuo gioco e configurare i metadati per autorizzare e autenticare il tuo gioco.

Per configurare il gioco di esempio in Google Play Console:

1. Vai a Google Play Console con il browser web e accedi. Se non hai già 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 API di Google nel mio gioco.
   2. Ai fini di questa guida per gli sviluppatori, puoi compilare il modulo con i tuoi dettagli relativi al gioco. Per praticità, 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 la tua app per Android, assicurati di specificare il nome esatto del pacchetto utilizzato in precedenza per 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 nuovo certificato firmato, se non ne hai già uno. Per scoprire come eseguire la procedura guidata di generazione dell'APK firmato, consulta la pagina Firma dell'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 dell'ID client.
   2. Il tuo certificato di firma: prendi nota del certificato utilizzato durante la configurazione dell'accesso all'API (il certificato di cui hai fornito l'impronta SHA1). Dovresti usare lo stesso certificato per firmare la tua app quando esegui il test o il rilascio dell'app.
5. Configura i risultati per la sfida tipo-a-numero:
   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
      Metti da parte i prepotenti	Richiedi un punteggio di 9999 in entrambe le modalità.	Assente
      OMG U R TEH UBER LEET!	Ricevi un punteggio di 1337.	Rendi questo un obiettivo nascosto.
      Faccina annoiata	Gioca 10 volte.	Rendi questo un obiettivo incrementale con 10 passi da sbloccare.
      Veramente annoiato	Gioca 100 volte.	Rendi questo un obiettivo incrementale con 100 passi da sbloccare.

   3. Registra gli ID (stringhe alfanumeriche lunghe) per ogni obiettivo che hai creato.
   4. Configura gli obiettivi appropriati per il tuo gioco. Per scoprire di più, consulta i concetti alla base degli obiettivi e come implementarli in Android.
6. Configura le classifiche per la sfida tipo-a-numero:
   1. Seleziona la scheda Classifiche in Google Play Console.
   2. Aggiungi due classifiche di esempio: una chiamata "Miglior punteggio facile" e un'altra denominata "Punteggi migliori". Entrambe le classifiche devono utilizzare la formattazione del punteggio con numeri interi con zero cifre decimali e l'ordinamento Più grande è meglio.
   3. Registra gli ID (stringhe alfanumeriche lunghe) per ogni classifica che hai creato.
   4. Configura le classifiche appropriate per il tuo gioco. Per saperne di più, consulta i concetti alla base delle classifiche e scopri come implementare le classifiche in Android.
7. Aggiungi account di prova per il tuo gioco. Questo passaggio è necessario solo per le app non ancora 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 pubblicata un'applicazione, tutti possono accedere.

Avviso: se tenti di effettuare chiamate all'SDK di Play Giochi per un gioco non pubblicato utilizzando un account non indicato 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 restituzione di ConnectionResult.SIGN_IN_REQUIRED. Se tenti di avviare ConnectionResult.startResolutionForResult(), riceverai nuovamente 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 dei giochi in AndroidManifest.xml.

1. Apri res/values/ids.xml e sostituisci gli ID segnaposto. Se crei un gioco Android da zero, devi prima creare questo file.
   1. Specifica il tuo ID applicazione nella risorsa app_id.
   2. Specifica ogni ID obiettivo che hai 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 scratch, 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 disponi di un dispositivo fisico, puoi eseguire il test rispetto all'emulatore Android. Per farlo, scarica da SDK Manager l'immagine del sistema di 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 usando lo strumento adb. Per scoprire come installare un'applicazione, consulta In esecuzione su un dispositivo.

Avviso: se esegui l'applicazione direttamente da Android Studio, per impostazione predefinita Android Studio firma l'applicazione con il certificato di debug. 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 che hai usato durante la configurazione dell'applicazione in Google Play Console.