Questa pagina è stata tradotta dall'API Cloud Translation.

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

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 di Google Play multipiattaforma che ti consentono di integrare funzionalità di gioco popolari come obiettivi, classifiche e Partite salvate nei giochi per tablet e mobile.

Questo corso di formazione ti guiderà nell'installazione di un'applicazione di gioco di esempio per Android e iniziare subito a creare il tuo gioco Android. Il tipo di numero L'app di esempio della sfida dimostra 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 i tuoi nel gioco e configurare i metadati per autorizzare e autenticare il gioco. Per ulteriori informazioni, vedi Configurazione dei servizi per i giochi di Google Play.

Configura la tua app

Nel file build.gradle a livello di progetto, includi Repository Maven di Google e 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 tuo file di build Gradle del modulo, che solitamente è 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 guiderà nell'installazione di un'app di gioco di esempio per Android e iniziare subito a creare il tuo gioco Android. Il tipo di numero L'app di esempio della sfida dimostra come integrare obiettivi e classifiche nel tuo gioco.

Passaggio 1: scarica l'app di esempio

Per questa guida per gli sviluppatori devi scaricare l'esempio di Sfida di tipo Type-a-Number app per Android.

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

Scarica gli esempi di Android dal esempi di pagina di download.
Importa il progetto android-basic-samples. Questo progetto include TypeANumber e un altro gioco Android i campioni. Per farlo in Android Studio:
1. Fai clic su File > Importa progetto.
2. Vai alla directory in cui hai scaricato android-basic-samples nel tuo percorso di sviluppo in una macchina virtuale. 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. Il nuovo nome del pacchetto deve non 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:

Nel browser web, apri la Google Play Console e accedi. Se non hai mai eseguito la registrazione a Google Play Console, ti verrà chiesto di farlo.
Segui queste istruzioni per aggiungi 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 il tuo dettagli del gioco. Per praticità, puoi utilizzare le icone segnaposto e gli screenshot fornita nella pagina Download.
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 pacchetto esatto il nome usato in precedenza durante la ridenominazione del pacchetto di esempio.
2. Puoi usare 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 Genera APK firmato, Firma dell'app in Android Studio.
Assicurati di registrare le seguenti informazioni per un secondo momento:
1. Il tuo ID applicazione: questa è una stringa costituito solo da cifre (in genere 12 o più), all'inizio dell'ID cliente.
2. Il tuo certificato di firma: annota il certificato che hai utilizzato durante la configurazione l'accesso all'API (il certificato per il quale hai fornito l'impronta SHA1). Tu Devi usare lo stesso certificato per firmare la tua app durante il test o il rilascio del tuo dell'app.

Configura gli obiettivi per la Sfida di tipo tipo un numero:

Seleziona la scheda Obiettivi in Google Play Console.

Aggiungi i seguenti obiettivi di esempio:

Nome	Descrizione	Istruzioni speciali
Primo	Ottenere un punteggio che è un numero primo.	Nessuna
Humble	Richiedi un punteggio pari a 0.	Nessuna
Non diventare impertinente, bambino	Richiedi un punteggio pari a 9999 in entrambe le modalità.	Nessuna
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.

Registra gli ID (lunghe stringhe alfanumeriche) di ciascun risultato che è stato creato.
Configura gli obiettivi appropriati per il tuo gioco. Per saperne di più, Scopri i concetti alla base dei risultati e come implementare gli obiettivi su Android.

Configura le classifiche per la Sfida di tipo Type-a-Number:
1. Seleziona la scheda Classifiche in Google Play Console.
2. Aggiungi due classifiche di esempio: una chiamata "Punteggi migliori facili" e un'altra "Hard High Score". Entrambe le classifiche devono utilizzare il formato del punteggio intero con 0 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 saperne di più, scopri i concetti alla base delle classifiche e come implementare le classifiche in Android.
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, solo gli account di prova 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 progetto Android. Dovrai aggiungere anche i metadati dei giochi nell'AndroidManifest.xml.

Apri res/values/ids.xml e sostituisci gli ID segnaposto. Se 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 creato in precedenza nella achievement_* risorsa.
3. Specifica ogni ID classifica che hai creato in precedenza nella leaderboard_* risorsa.
Apri AndroidManifest.xml e inserisci il nome del pacchetto nel campo package dell'attributo <manifest> . Se crei un gioco Android da da zero, assicurati di aggiungere anche il seguente codice all'interno di <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 la dell'applicazione prima di pubblicarla su Google Play.

Per eseguire il gioco sul tuo dispositivo di test fisico:

Verifica di aver configurato l'account di prova che utilizzi per accedere. all'app (come descritto nel Passaggio 2).
Esporta un APK e firmalo con lo stesso certificato che hai utilizzato per la configurazione il progetto in Google Play Console. Per esportare un APK firmato in Android Studio, fai clic su Crea > Genera l'APK firmato.
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.