Accesso

A seguito del ritiro dell'API Google Sign-In, nel 2026 rimuoveremo l'SDK v1 per i giochi. 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.

L'accesso ai servizi per i giochi di Play ti fornisce l'identità di gioco di un giocatore, ovvero un'identità specifica per i giochi a livello di piattaforma per i giocatori Android. Questa identità contribuisce a creare un rapporto tra il tuo gioco e il giocatore. I giocatori sono più disposti a utilizzare questa identità per accedere rispetto a sistemi centralizzati alternativi.

Inoltre, l'accesso ti fornisce un identificatore solido e coerente che puoi utilizzare come chiave per un sistema di salvataggio nel cloud. Il salvataggio nel cloud è molto apprezzato perché consente ai giocatori di fare quanto segue:

• Riprendere da dove aveva interrotto se cambia o ripristina il dispositivo
• Giocare su più dispositivi (ad esempio, su un altro smartphone o un Chromebook)
• Disinstallare e reinstallare il gioco in un secondo momento

Puoi utilizzare l'identità di Play Games Services come chiave per la tua soluzione di salvataggio sul cloud oppure puoi utilizzare il servizio Giochi salvati senza costi.

I servizi per i giochi di Play (PGS) supportano l'accesso automatico, un modo semplice per far accedere i giocatori, nonché l'accesso manuale, che è un processo con un solo clic. Questo documento descrive questi diversi metodi di accesso.

Flusso di accesso consigliato

Per consentire ai giocatori di accedere correttamente al tuo gioco, utilizza il seguente flusso di accesso:

1. Durante la sequenza di avvio del gioco, prova l'accesso automatico per accedere automaticamente al giocatore.
2. Se l'accesso automatico non funziona e il dispositivo dell'utente è online, prova l'accesso manuale.
3. Se l'accesso manuale viene rifiutato, ricorda la scelta dell'utente e non mostrare di nuovo l'accesso manuale, ma continua a provare l'accesso automatico all'avvio.

Inoltre, devi assicurarti che gli utenti possano accedere al tuo gioco con il proprio account dei servizi per i giochi di Play con un pulsante dedicato e facile da trovare.

Accesso automatico

L'accesso automatico consente agli utenti di accedere al tuo gioco senza problemi, in modo automatico. Se il tuo gioco richiede all'utente di accedere e l'impostazione di accesso automatico è attivata (nell'app Google Play Giochi), riceverai le credenziali di identità PGS dell'utente e quest'ultimo vedrà l'esperienza di accesso PGS.

L'accesso automatico è un'impostazione che gli utenti possono controllare. Gli utenti possono scegliere di accedere automaticamente a tutti i giochi o di ricevere una richiesta ogni volta.

Accesso manuale

Se un utente non accede automaticamente al gioco, puoi chiedergli di accedere manualmente. Gli utenti possono accedere con un clic da una finestra di dialogo visualizzata nella parte superiore del gioco.

Consenti i popup di PGS per un'esperienza di accesso corretta

Quando utilizzano PGS, gli utenti devono sapere di aver eseguito l'accesso. A questo scopo, viene mostrata l'esperienza di accesso a PGS.

Per mostrare l'esperienza di accesso, chiama il metodo setViewForPopups() della classe GamesClient all'avvio del gioco. Questo è fondamentale per consentire la corretta esperienza utente.

Ambiti OAuth e servizi per i giochi di Play

PGS si basa sul sistema OAuth per consentire agli utenti di dare al tuo gioco l'accesso al proprio account. Gli ambiti OAuth sono autorizzazioni che puoi richiedere in qualità di sviluppatore. Se concesse, queste autorizzazioni consentono al tuo gioco di chiamare determinate API per conto dell'utente e ti danno anche accesso a determinate parti del suo Account Google.

PGS ha un ambito unico per i giochi (games-lite) e si basa su un altro ambito (drive.appdata) se il tuo gioco utilizza la funzionalità dei giochi salvati. La funzionalità Partite salvate consente l'accesso all'account Google Drive dell'utente, in cui sono archiviati i dati di gioco.

Il tuo gioco può richiedere qualsiasi ambito necessario per creare un'esperienza di gioco ottimale per i tuoi utenti. Il tuo gioco può richiedere tutti gli ambiti di cui ha bisogno in un unico bundle, limitando il numero di richieste di accesso all'Account Google. Tuttavia, questo approccio presenta un grave svantaggio. Se richiedi più ambiti specifici di PGS, l'accesso automatico non può essere eseguito. L'accesso automatico è il modo migliore per far accedere i giocatori al tuo gioco.

La best practice prevede l'utilizzo di richieste di ambito incrementali. Il gioco deve richiedere gli ambiti solo PGS nella richiesta iniziale e richiedere altri ambiti separatamente in un momento più pertinente.

L'accesso OAuth viene concesso utilizzando una schermata diversa per ogni ambito. Ciò consente agli utenti di decidere, in modo granulare, a quali ambiti concedere l'accesso. Utilizzando l'accesso automatico con solo ambiti PGS, gli utenti non dovranno interagire con alcuni prompt OAuth, riducendo le difficoltà di accesso.

Supporto di più metodi di accesso

PGS fornisce un'identità di gioco per i giocatori Android, ma non deve essere l'unica identità collegata ai tuoi utenti. Puoi accedere ai giocatori utilizzando PGS, un ID di social network e il tuo sistema di ID in-game contemporaneamente. Ogni sistema offre un valore unico sia per te che per i tuoi giocatori e tutti possono collaborare per offrire un'esperienza fantastica ai giocatori Android.

Recuperare e verificare in modo sicuro l'identità del giocatore per l'integrazione del backend

Puoi richiedere un codice di autenticazione del server per consentire al server di comunicare direttamente con i server dei servizi per i giochi di Play tramite l'API REST con l'autorità del giocatore che ha eseguito l'accesso. Ciò consente l'accesso diretto all'ID, al profilo e ad altre informazioni del giocatore (come l'elenco amici, se autorizzato). Se memorizzi ID giocatore, ID amico o altri dati correlati nel backend, questo metodo deve essere utilizzato per eliminare la possibilità di manipolazione lato dispositivo di questi campi.

Inoltre, per alcuni giochi e giocatori meno recenti, l'ID giocatore restituito dall'SDK Android per un giocatore potrebbe non essere lo stesso ID che altri giocatori vedono quando visualizzano quel giocatore nello stesso gioco. Ciò è particolarmente importante quando si utilizza l'elenco degli amici. Tuttavia, l'player_id restituito all'interno dell'API REST è sempre coerente ed è sempre l'ID visualizzato dagli altri giocatori.

Per saperne di più, consulta Accesso offline e la documentazione dell'API REST.

Implementazione client

Per scoprire come implementare il supporto per l'accesso su Android, consulta Accesso nei giochi per Android.