Panoramica della migrazione

L'SDK Google Play Games Services, games v1 si basa su Google Sign-In per Android, che è ritirato e verrà rimosso dall'SDK Google Play Services Auth (com.google.android.gms:play-services-auth) nel 2025. Le nuove app di giochi possono utilizzare la v1 dei giochi fino al 2025. La rimozione dell'accesso con Google introduce problemi di dipendenza per le app di giochi esistenti. La migrazione delle app di giochi esistenti dall'SDK games v1 all'SDK games v2 risolve i problemi di dipendenza introdotti dalla rimozione di Google Sign-In.

Questo documento ti aiuta a comprendere le interazioni tra l'applicazione di giochi e vari SDK. Questo documento confronta anche le funzionalità dell'applicazione con quelle degli SDK games v1 e games v2 dei servizi per i giochi di Play.

Interazioni SDK

I diagrammi illustrano l'interazione tra un'applicazione di gioco su Android, Google Mobile Services (GMS) Core, Play Games Services e un server di giochi di terze parti. Viene evidenziato come l'applicazione utilizzi i servizi di Google per l'autenticazione e le funzionalità di gioco, interagendo al contempo con un sistema di terze parti separato.

Di seguito è riportata una breve panoramica dei componenti e degli SDK:

• Applicazione 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 Play.
    • SDK Auth. L'SDK Google Play Services Auth è responsabile della gestione dei flussi di autenticazione e autorizzazione degli utenti nei giochi v1.
  • Entrambi gli SDK comunicano utilizzando AIDL (Android Interface Definition Language), che indica un modello di comunicazione tra processi o servizi diversi.
• GMS Core, noto anche come Google Play Services.
  • Questo è il livello proprietario di Google su Android.
  • L'applicazione di giochi utilizza due moduli GMS Core:
    • Il modulo Giochi fornisce funzionalità specifiche per i giochi, come classifiche, obiettivi e gestione dello stato del gioco.
    • Auth Module. Gestisce le operazioni di autenticazione e autorizzazione degli utenti.
  • Gli SDK Games e Auth nell'applicazione di giochi comunicano con i moduli corrispondenti utilizzando le interfacce AIDL, indicando la comunicazione tra processi (IPC).

• Gateway dei servizi per i giochi di Play.
  • Un gateway logico che media la comunicazione tra GMS Core e il server dei servizi per i giochi di Play.
  • 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 Games Services responsabili dell'archiviazione dei dati di gioco, della gestione degli account utente e della facilitazione delle funzionalità multiplayer.
• Gateway di giochi di terze parti.
  • Se la tua applicazione di giochi è considerata un'applicazione di terze parti (3P), la libreria client comunica con i server dei servizi per i giochi di Play tramite i server di giochi di terze parti.
  • Implica che l'applicazione può autenticarsi anche con un altro fornitore di servizi.
• Server di gioco 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 dei giochi di terze parti.

Confronto tra le funzionalità

Questa tabella offre un confronto delle funzionalità tra gli SDK games v1 e games v2:

Funzionalità	SDK games v1	SDK games v2
Autenticazione	Integrazione con play-services-auth richiesta.	Semplificato e ottimizzato; non è richiesto play-services-auth.
Autorizzazione	Codice aggiuntivo per operazioni riuscite, non riuscite e tentativi.	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.	Può richiedere tre ambiti di identità OAuth 2.0 di base con GamesSignInClient quando richiede l'accesso lato server alle API web dei servizi per i giochi di Play. Per maggiori informazioni, consulta Accesso lato server a Play Games Services e Recuperare i codici di autenticazione server.
Procedura di accesso	Utilizza GoogleSigninClient. Codice aggiuntivo per la gestione del codice boilerplate per l'accesso automatico e la gestione degli errori.	Utilizza GamesSignInClient. L'SDK gestisce il codice boilerplate, l'accesso automatico e la gestione degli errori.
Popup di benvenuto	È necessario un codice aggiuntivo. Gli sviluppatori possono controllare il posizionamento e la tempistica.	Nessun codice aggiuntivo richiesto. Interfaccia utente coerente in tutti i giochi configurati con l'SDK v2 per i giochi.
Dipendenze	Richiede play-services-auth.	Il modulo Giochi si occupa di autorizzazione e autenticazione. Non devi aggiungere altre dipendenze.
Uscita	Utilizza GoogleSignInClient.signOut.	L'API di disconnessione non è supportata.
Più account dei servizi per i giochi di Play e impostazioni per gioco	La gestione dell'account è possibile all'interno del gioco.	Gli utenti possono modificare il profilo dei servizi per i giochi di Play nelle impostazioni del dispositivo mobile. Per maggiori informazioni, vedi come cambiare profilo Play Giochi su dispositivo mobile.