L'accesso ai servizi per i giochi di Play fornisce l'identità per un giocatore, un livello specifico della piattaforma per i giocatori Android. Questa identità consente di stabilire una relazione tra il gioco e il player. I giocatori sono più disposti a usare questa identità per accedere rispetto a quelli con sistemi centralizzati alternativi.
Inoltre, l'accesso ti fornisce un identificatore forte e coerente che puoi utilizzare come chiave per un sistema di salvataggio sul cloud. Il salvataggio sul cloud è molto importante; consente ai giocatori di:
- Riprendi da dove avevano interrotto se cambia o reimposta il dispositivo
- Giocare su più dispositivi (ad esempio, su un altro telefono o su un Chromebook)
- Disinstalla e reinstalla il gioco
Puoi utilizzare l'identità dei servizi per i giochi di Play come chiave per la tua soluzione di salvataggio sul cloud oppure utilizzare il servizio Giochi salvati senza costi.
I servizi per i giochi di Play (PGS) supportano l'accesso automatico, un modo per accedere senza problemi e l'accesso manuale, ovvero una procedura con un solo clic. Questo documento descrive questi diversi metodi di accesso.
Flusso di accesso consigliato
Per consentire l'accesso ai giocatori nel tuo gioco, utilizza la seguente procedura di accesso:
- Durante la sequenza di avvio del gioco, prova ad accedere automaticamente per accedere automaticamente al player.
- Se l'accesso automatico non funziona e il dispositivo dell'utente è online, prova ad accedere manualmente.
- Se l'accesso manuale viene rifiutato, ricorda la scelta dell'utente e non mostrare di nuovo l'accesso manuale, ma continua a provare l'opzione 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 difficoltà. È automatico! Se il gioco richiede che l'utente acceda e sia abilitata l'impostazione di accesso automatico (nell'app Google Play Giochi), riceverai le credenziali di identità PGS dell'utente e l'utente vedrà l'esperienza di accesso a 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 ogni volta una richiesta.
Accesso manuale
Se un utente non accede automaticamente al gioco, puoi chiedergli di farlo manualmente. Gli utenti possono accedere con un clic da una finestra di dialogo visualizzata sopra il gioco.
Consenti i popup di PGS per un'esperienza di accesso corretta
Quando utilizzano i servizi di vendita sui prodotti, gli utenti devono sapere di aver eseguito l'accesso. A questo scopo, mostra l'esperienza di accesso di PGS.
Per mostrare l'esperienza di accesso, chiama il metodo
setViewForPopups()
della classe GamesClient durante l'avvio del gioco. Questo è fondamentale per garantire un'esperienza utente corretta.
Ambiti OAuth e PGS
PGS si basa sul sistema OAuth per consentire agli utenti di concedere al tuo gioco l'accesso al loro account. Gli ambiti OAuth sono autorizzazioni che lo sviluppatore può richiedere. Se concesse, queste autorizzazioni consentono al tuo gioco di chiamare determinate API per conto dell'utente e ti consentono anche di accedere a determinate parti del suo Account Google.
I servizi di gioco di YouTube hanno un ambito univoco per i giochi (games-lite) e si basano su un altro ambito (drive.app_data) se il gioco utilizza la funzionalità dei giochi salvati. La funzionalità dei giochi salvati consente di accedere all'account Google Drive dell'utente, dove vengono archiviati i dati dei giochi.
Il tuo gioco può richiedere qualsiasi ambito di cui hai bisogno per creare una fantastica esperienza di gioco per i tuoi utenti. Il 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 grosso svantaggio. Se richiedi più degli ambiti specifici per PGS, l'accesso automatico non potrà riuscire. 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 PPS nella richiesta iniziale e richiedere gli altri ambiti separatamente nel momento più pertinente.
L'accesso OAuth viene concesso utilizzando uno schermo diverso per ogni ambito. Ciò consente agli utenti di decidere, in modo granulare, a quali ambiti concedere l'accesso. Utilizzando l'accesso automatico solo con gli ambiti PGS, gli utenti non dovranno interagire con alcun messaggio OAuth, riducendo le difficoltà di accesso.
Supporto di più metodi di accesso
Il servizio 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 allo stesso tempo PGS, un ID social network e il tuo sistema di ID in-game. Ogni sistema offre un valore unico sia per te che per i giocatori e può contribuire alla creazione di una fantastica esperienza per i giocatori Android.
Recupera e verifica in modo sicuro l'identità del player per l'integrazione backend
Puoi richiedere un codice di autenticazione server per consentire al tuo 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 (ad esempio, elenco di amici, se autorizzato). Se archivi nel tuo backend qualsiasi ID giocatore, ID amico o altri dati correlati, questo metodo deve essere utilizzato per rimuovere 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 che gli altri giocatori vedono quando visualizzano il giocatore nello stesso gioco. Questo è particolarmente pertinente quando viene usato l'elenco degli amici. Tuttavia, il player_id restituito nell'API REST è sempre coerente ed è sempre l'ID visualizzato dagli altri giocatori.
Per ulteriori informazioni, consulta la pagina relativa all'accesso offline e alla documentazione sull'API REST.
Implementazione client
Per scoprire come implementare il supporto di accesso su Android, consulta Accedere in Android Giochi.