Panoramica della migrazione

L'SDK v1 per i giochi di Google Play Games Services si basa su Accedi con Google per Android, che è stato ritirato e verrà rimosso dall' SDK di autenticazione di Google Play Services (com.google.android.gms:play-services-auth) nel 2025. Le nuove app di giochi possono utilizzare l'SDK v1 per i giochi fino al 2025. La rimozione di Accedi con Google introduce problemi di dipendenza per le app di giochi esistenti. La migrazione delle app di giochi esistenti dall'SDK v1 per i giochi all'SDK v2 per i giochi risolve 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 anche le funzionalità dell'applicazione con quelle degli SDK v1 e v2 per i giochi di Play Games Services.

Interazioni con l'SDK

I diagrammi illustrano l'interazione tra un'applicazione di giochi su Android, Google Mobile Services (GMS) Core, Play Games Services e un server di giochi di terze parti. Viene evidenziato il modo in cui 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.

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

• Applicazione di giochi.
  • Rappresenta l'applicazione di giochi dell'utente in esecuzione su un dispositivo con Android.
  • Contiene due componenti principali:
    • SDK v1 o v2 per i giochi. L'SDK lato client è responsabile dell'interazione con Play Games Services.
    • SDK di autenticazione. L'SDK di autenticazione di Google Play Services è responsabile della gestione dei flussi di autenticazione e autorizzazione degli utenti nella versione 1 per i giochi.
  • Entrambi gli SDK comunicano utilizzando AIDL (Android Interface Definition Language), che indica un pattern di comunicazione tra processi o servizi diversi.
• GMS Core, chiamato anche Google Play Services.
  • Si tratta del livello proprietario 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 Giochi e Autenticazione nell'applicazione di giochi comunicano con i moduli corrispondenti utilizzando interfacce AIDL, che indicano la comunicazione interprocesso (IPC).

• Gateway di Play Games Services.
  • Un gateway logico che media la comunicazione tra GMS Core e il server di Play Games Services.
  • Gestisce le richieste API, la trasformazione dei dati e l'autenticazione per la comunicazione con il server.
• Server di Play Games Services.
  • 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 è qualificata come applicazione di terze parti, la libreria client comunica con i server di Play Games Services tramite i server di giochi di terze parti.
  • Implica che l'applicazione può anche eseguire l'autenticazione con un altro fornitore di servizi.
• 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 di giochi di terze parti.

Confronto delle funzioni

Questa tabella fornisce un confronto delle funzionalità tra gli SDK v1 e v2 per i giochi:

Funzionalità	SDK v1 per i giochi	SDK v2 per i giochi
Autenticazione	È richiesta l'integrazione con play-services-auth.	Semplificata e ottimizzata, non è richiesto play-services-auth.
Autorizzazione	Codice aggiuntivo per procedure riuscite, non riuscite e tentativi.	Gestita dall'SDK
Token di accesso al server	Può richiedere ambiti OAuth 2.0 aggiuntivi con GoogleSigninClient. Codice aggiuntivo per la gestione degli errori durante l'autenticazione.	Può richiedere tre ambiti di identità OAuth 2.0 di base con GamesSignInClient quando richiede l'accesso lato server alle API web di Play Games Services. Per saperne di più, consulta Accesso lato server a Play Games Services e Recupera i codici di autenticazione server.
Procedura di accesso	Utilizza GoogleSigninClient. Codice aggiuntivo per la gestione del codice boilerplate per l'autenticazione automatica e la gestione degli errori.	Utilizza GamesSignInClient. L'SDK gestisce il codice boilerplate, l'autenticazione automatica e la gestione degli errori.
Popup di benvenuto	È richiesto codice aggiuntivo. Gli sviluppatori possono controllare il posizionamento e la tempistica.	Non è richiesto codice aggiuntivo. 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 dell'autorizzazione e dell'autenticazione. Non devi aggiungere altre dipendenze.
Disconnessione	Utilizza GoogleSignInClient.signOut.	L'API di disconnessione non è supportata.
Più account Play Games Services e impostazioni per gioco	La gestione degli account è possibile all'interno del gioco.	Gli utenti possono modificare il profilo Play Games Services nelle impostazioni del dispositivo mobile. Per saperne di più, consulta Come cambiare profilo Play Giochi su dispositivo mobile.