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 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 Play Giochi fornisce servizi per i giochi di Google Play multipiattaforma che ti consentono di integrare facilmente funzionalità di gioco popolari come obiettivi, classifiche e Giochi salvati nei giochi per tablet e mobile.

Questo corso di formazione ti illustrerà come installare un'applicazione di gioco di esempio per Android e come iniziare a creare rapidamente il tuo gioco per Android. L'app di esempio 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:

• A minSdkVersion di 19 di altezza
• A compileSdkVersion di 28 o superiore

Configurare 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 gioco. Per maggiori informazioni, consulta la pagina 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 Google Play Services per l'SDK Play Giochi al file di build Gradle del modulo, che in genere è app/build.gradle:

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

Guida alle app di esempio

Questo corso di formazione ti illustrerà come installare un'app di gioco di esempio per Android e come iniziare a creare rapidamente il tuo gioco per Android. L'app di esempio 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 per la sfida Type-a-Number.

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

1. Scarica gli esempi di Android dalla pagina di download degli esempi.
2. Importa il progetto android-basic-samples. Questo progetto include TypeANumber e altri esempi di giochi per 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 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 con un altro nome di pacchetto. 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 gioco.

Per configurare il gioco di esempio in Google Play Console:

1. Apri Google Play Console con il browser web e accedi. Se non hai mai eseguito 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 usi le API di Google nella tua app, seleziona Non utilizzo ancora alcuna API di Google nel mio gioco.
   2. Ai fini di questa guida per gli sviluppatori, puoi compilare il modulo con i tuoi dettagli sul 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 per Android.
   1. Quando colleghi la tua app per Android, assicurati di specificare il nome esatto del pacchetto che hai utilizzato in precedenza durante la ridenominazione del pacchetto di esempio.
   2. Puoi utilizzare la procedura guidata Genera 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 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 almeno 12 cifre) all'inizio dell'ID client.
   2. Il certificato di firma: prendi nota del certificato utilizzato durante la configurazione dell'accesso all'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 di tipo tipo un numero:
   1. Seleziona la scheda Obiettivi in Google Play Console.
   2. Aggiungi i seguenti obiettivi di esempio:

      Nome	Descrizione	Istruzioni speciali
      Primo	Ottenere un punteggio che è un numero primo.	Assente
      Humble	Richiedi un punteggio pari a 0.	Assente
      Non diventare impertinente, bambino	Richiedi un punteggio pari a 9999 in entrambe le modalità.	Assente
      OMG U R TEH UBER LEET!	Ricevi un punteggio di 1337.	Rendi questo un obiettivo nascosto.
      Annoiato	Gioca 10 volte.	Rendilo un obiettivo incrementale con 10 passaggi da sbloccare.
      Mi annoi molto	Gioca 100 volte.	Rendilo un obiettivo incrementale con 100 passi da sbloccare.

   3. Registra gli ID (lunghe stringhe alfanumeriche) 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 implementare gli obiettivi in Android.
6. Configura le classifiche per la Sfida di tipo a numero:
   1. Seleziona la scheda Classifiche in Google Play Console.
   2. Aggiungi due classifiche di esempio: una con il nome "Punteggi migliori facili" e l'altra "Punteggi migliori difficili". Entrambe le classifiche devono utilizzare la formattazione del punteggio intero con zero cifre decimali e un tipo di ordinamento Più grande è meglio.
   3. Registra gli ID (lunghe stringhe alfanumeriche) per ogni classifica che hai creato.
   4. Configura le classifiche appropriate per il tuo gioco. Per scoprire di più, consulta i concetti alla base delle 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 state ancora pubblicate in Google Play Console. Prima della pubblicazione dell'app, possono accedere soltanto gli account di prova elencati in Google Play Console. Tuttavia, una volta pubblicata l'applicazione, 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 esistesse e riceverai il codice di restituzione ConnectionResult.SIGN_IN_REQUIRED. Se tenti di avviare ConnectionResult.startResolutionForResult(), riceverai 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 aggiungere anche i metadati dei giochi nell'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 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 classifica 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 vuoi creare 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: è consigliabile eseguire il test su un dispositivo Android fisico. Tuttavia, se non hai un dispositivo fisico, puoi eseguire il test utilizzando l'emulatore 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 stai utilizzando 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 informazioni su come installare un'applicazione, vedi Esecuzione su un dispositivo.

Avviso: quando esegui l'applicazione direttamente da Android Studio, Android Studio firma 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 utilizzati durante la configurazione dell'applicazione in Google Play Console.