L'SDK Google Play Services, giochi v1 si basa su Accedi con Google per Android, che è stato ritirato e verrà rimosso dall'SDK Auth di Google Play Services (com.google.android.gms:play-services-auth) nel 2025.
Le nuove app di giochi possono utilizzare la versione 1 di Google Play Giochi fino al 2025. La rimozione di Accedi con Google introduce problemi di dipendenza per le app di giochi esistenti. Eseguire la migrazione delle app di giochi esistenti dall'SDK games v1 all'SDK games v2 consente di risolvere i problemi di dipendenza introdotti dalla rimozione di Accedi con Google.
Questo documento ti aiuta a comprendere le interazioni tra l'applicazione di giochi e i vari SDK. Questo documento confronta inoltre le funzionalità dell'applicazione con quelle degli SDK Play Games Services v1 e v2.
Interazioni con l'SDK
I diagrammi illustrano l'interazione tra un'applicazione di giochi su Android, Google Mobile Services (GMS) Core, Play Services per i giochi e un server di giochi di terze parti. Mette in evidenza in che modo l'applicazione utilizza i servizi di Google per l'autenticazione e le funzionalità di gioco, interagendo al contempo con un sistema di terze parti separato.
games v2 (attuale)
games v1 (legacy)
Di seguito è riportata una breve panoramica dei componenti e degli SDK:
- Applicazione di giochi.
- Rappresenta l'applicazione di gioco dell'utente in esecuzione su un dispositivo Android.
- Contiene due componenti principali:
- SDK games v1 o games v2. L'SDK lato client responsabile dell'interazione con i servizi per i giochi di Google Play.
- SDK Auth. L'SDK Google Play Services Auth è responsabile della gestione flussi di autenticazione e autorizzazione utente nei giochi v1.
- Entrambi gli SDK comunicano utilizzando AIDL (Android Interface Definition Language), indicando un pattern di comunicazione tra diversi processi o servizi.
- GMS Core, noto anche come Google Play Services.
- Si tratta del livello di proprietà di Google su Android.
- L'applicazione di giochi utilizza due moduli GMS Core:
- Modulo Giochi: fornisce funzionalità specifiche per i giochi, come classifiche, obiettivi e gestione dello stato del gioco.
- Modulo di autenticazione. Gestisce le operazioni di autenticazione e autorizzazione degli utenti.
- Gli SDK di Google Play e Auth nell'applicazione di giochi comunicano con i moduli corrispondenti utilizzando le interfacce AIDL, che indicano la comunicazione tra processi (IPC).
- Gateway di Play Services.
- Un gateway logico che media la comunicazione tra GMS Core e il server di Play Services per i giochi.
- Gestisce le richieste API, la trasformazione dei dati e l'autenticazione per la comunicazione con il server.
- Server dei servizi per i giochi di Play.
- Rappresenta i servizi di backend di Play Services per i giochi responsabili della memorizzazione dei dati di gioco, della gestione degli account utente e della facilitazione delle funzionalità multiplayer.
- Gateway per giochi di terze parti.
- Se la tua applicazione di giochi è considerata un'applicazione di terze parti, la raccolta di client comunica con i server di Play Giochi tramite i server di giochi di terze parti.
- Sottintende che l'applicazione può autenticarsi anche con un fornitore di servizi diverso.
- Server di giochi di terze parti.
- Rappresenta un server esterno facoltativo con cui l'applicazione di giochi può interagire, probabilmente per funzionalità personalizzate o gestione dei dati.
- La comunicazione con l'applicazione avviene tramite il gateway per i giochi di terze parti.
Confronto delle funzionalità
Questa tabella mostra un confronto delle funzionalità tra gli SDK v1 e v2 per i giochi:
Funzionalità |
SDK giochi v1 |
SDK games v2 |
|---|---|---|
Autenticazione |
È richiesta l'integrazione con play-services-auth. |
Semplificati e ottimizzati; non è richiesto play-services-auth. |
Autorizzazione |
Codice aggiuntivo per operazioni riuscite, non riuscite e tentativi di ripetizione. |
Gestito dall'SDK |
Token di accesso al server |
Può richiedere ulteriori ambiti OAuth 2.0 con GoogleSigninClient.Codice aggiuntivo per la gestione degli errori durante l'accesso. |
Non sono consentiti ambiti aggiuntivi. Codice aggiuntivo con un callback di errore di successo con serverAuthcode. |
Procedura di accesso |
Utilizzi GoogleSigninClient.Codice aggiuntivo per la gestione del codice boilerplate per l'accesso automatico e la gestione degli errori. |
Utilizzi GamesSignInClient.L'SDK gestisce il codice boilerplate, l'accesso automatico e la gestione degli errori. |
Popup di benvenuto |
È necessario codice aggiuntivo. Gli sviluppatori possono controllarne il posizionamento e le tempistiche. |
Nessun codice aggiuntivo richiesto Interfaccia utente coerente in tutti i giochi configurati con PGS V2. . |
Dipendenze |
Richiede play-services-auth. |
Nessuna dipendenza separata da play-services-auth. |
| Uscire |
Utilizza GoogleSignInClient.signOut. |
L'API di disconnessione non è supportata. |
Più account Play Giochi e impostazioni per singolo gioco |
La selezione e la gestione degli account non sono disponibili. |
Per ogni gioco, puoi gestire il tuo account Play Services per i giochi. In questo modo puoi selezionare l'account utilizzato da ogni gioco. |