Questa pagina è stata tradotta dall'API Cloud Translation.

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

A seguito del ritiro dell'API Google Sign-In, rimuoveremo l'SDK v1 per i giochi nel 2026. Dopo febbraio 2025, non potrai pubblicare su Google Play titoli che sono stati integrati di recente con l'SDK v1 per i giochi. Ti consigliamo di utilizzare l'SDK v2 per i giochi.
Anche se i titoli esistenti con le precedenti integrazioni di giochi v1 continueranno a funzionare per un paio di anni, ti consigliamo di eseguire la migrazione alla v2 a partire da giugno 2025.
Questa guida riguarda l'utilizzo dell'SDK v1 dei servizi per i giochi di Play. Per informazioni sull'ultima versione dell'SDK, consulta la documentazione della versione 2.

Ti diamo il benvenuto nello sviluppo di giochi per 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 tuoi giochi per tablet e dispositivi mobili.

Questo training ti guiderà nell'installazione di un'applicazione di gioco di esempio per Android e ti aiuterà a iniziare rapidamente a creare il tuo gioco per Android. L'app di esempio Type-a-Number Challenge mostra come integrare obiettivi e classifiche nel tuo gioco.

Prima di iniziare

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

Prerequisiti per le app

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

Un minSdkVersion di 19 o superiore
Un compileSdkVersion di 28 o superiore

Configurare il gioco in Google Play Console

Google Play Console è la piattaforma in cui gestisci i servizi per i giochi di Google Play per il tuo gioco e configuri i metadati per autorizzare e autenticare il gioco. Per maggiori informazioni, consulta 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 nelle sezioni buildscript e allprojects:

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

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

Aggiungi la dipendenza Google Play Services per l'SDK Play Games 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 all'app di esempio

Questo training ti guiderà nell'installazione di un'app di gioco di esempio per Android e ti aiuterà a iniziare rapidamente a creare il tuo gioco per Android. L'app di esempio Type-a-Number Challenge mostra come integrare obiettivi e classifiche nel tuo gioco.

Passaggio 1: scarica l'app di esempio

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

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

Scarica i campioni Android dalla pagina di download dei campioni.
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 tua macchina di sviluppo. Seleziona il file android-basic-samples/build.gradle e fai clic su Ok.
Nel modulo TypeANumber, apri AndroidManifest.xml e modifica il nome del pacchetto da com.google.example.games.tanc a un altro nome di pacchetto di tua scelta. 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

Google Play Console è la piattaforma in cui gestisci i servizi per i giochi di Google Play per il tuo gioco e configuri i metadati per autorizzare e autenticare il tuo gioco.

Per configurare il gioco di esempio in Google Play Console:

Punta il browser web su Google Play Console e accedi. Se non ti sei ancora registrato a Google Play Console, ti verrà chiesto di farlo.
Segui queste istruzioni per aggiungere il tuo gioco a Google Play Console.
1. Quando ti viene chiesto se utilizzi 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 dettagli del tuo gioco. Per comodità, puoi utilizzare le icone segnaposto e gli screenshot forniti nella pagina Download.
Segui queste istruzioni per generare un ID client OAuth 2.0 per la tua app per Android.
1. Quando colleghi l'app per Android, assicurati di specificare il nome esatto del pacchetto che hai utilizzato in precedenza quando hai rinominato il pacchetto di esempio.
2. Puoi utilizzare la procedura guidata Genera APK firmato 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 Genera APK firmato, consulta Firma dell'app in Android Studio.
Assicurati di registrare le seguenti informazioni per un secondo momento:
1. Il tuo ID applicazione: una stringa composta solo da cifre (in genere 12 o più), all'inizio dell'ID client.
2. Il certificato di firma: annota il certificato che hai utilizzato durante la configurazione dell'accesso all'API (il certificato di cui hai fornito l'impronta SHA1). Devi utilizzare lo stesso certificato per firmare l'app durante il test o il rilascio.

Configura gli obiettivi per la sfida Inserisci un numero:

Seleziona la scheda Obiettivi in Google Play Console.

Aggiungi i seguenti obiettivi di esempio:

Nome	Descrizione	Istruzioni speciali
Primo	Ottieni un punteggio che sia un numero primo.	Assente
Umile	Richiedere un punteggio di 0.	Assente
Non montarti la testa, ragazzo.	Richiedi un punteggio di 9999 in una delle due modalità.	Assente
OMG U R TEH UBER LEET!	Ricevi un punteggio di 1337.	Rendi questo obiettivo nascosto.
Noia	Gioca 10 volte.	Rendi questo obiettivo incrementale con 10 passaggi per sbloccarlo.
Really Really Bored	Gioca 100 volte.	Rendi l'obiettivo incrementale con 100 passaggi da sbloccare.

Prendi nota degli ID (stringhe alfanumeriche lunghe) di ogni obiettivo che hai creato.
Configura gli obiettivi adatti al tuo gioco. Per saperne di più, consulta i concetti alla base degli obiettivi e come implementare gli obiettivi in Android.

Configura le classifiche per la sfida Inserisci un numero:
1. Seleziona la scheda Classifiche in Google Play Console.
2. Aggiungi due classifiche di esempio: una denominata "Punteggi più alti facili" e un'altra denominata "Punteggi più alti difficili". Entrambe le classifiche devono utilizzare la formattazione del punteggio Integer con 0 cifre decimali e un tipo di ordinamento Maggiore è meglio.
3. Prendi nota degli ID (stringhe alfanumeriche lunghe) di ogni classifica che hai creato.
4. Configura le classifiche adatte al tuo gioco. Per saperne di più, consulta i concetti alla base delle classifiche e come implementare le classifiche in Android.
Aggiungere account di test per il gioco. Questo passaggio è necessario solo per le app che non sono ancora state pubblicate in Google Play Console. Prima della pubblicazione dell'app, solo gli account di test elencati in Google Play Console possono accedere. Tuttavia, una volta pubblicata un'applicazione, tutti possono accedere.

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.

Apri res/values/ids.xml e sostituisci gli ID segnaposto. Se stai creando un gioco per Android da zero, devi prima creare questo file.
1. Specifica l'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.
Apri AndroidManifest.xml e inserisci il nome del pacchetto nell'attributo package dell'elemento <manifest>. Se stai creando un gioco per 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.

Per eseguire il gioco sul dispositivo di test fisico:

Verifica di aver configurato l'account di test che utilizzi per accedere all'app (come descritto nel passaggio 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 Build > Generate Signed APK.
Installa l'APK firmato sul dispositivo di test fisico utilizzando lo strumento adb. Per scoprire come installare un'applicazione, vedi Esecuzione su un dispositivo.