Per integrare il tuo gioco con Google Play Games Services, implementa prima l'autenticazione della piattaforma. Questo è necessario per accedere a tutte le altre funzionalità, come obiettivi, classifiche ed eventi.
Per rispettare le linee guida per l'esperienza utente di Google Play Giochi Level Up, il tuo gioco deve essere conforme al flusso di autenticazione consigliato.
Inizializzazione e autenticazione
Questo è un passaggio obbligatorio per inizializzare e autenticare il gioco:
- Implementa l'autenticazione della piattaforma inizializzando l'SDK Play Games Services v2 all'avvio. Per maggiori informazioni, consulta la sezione Autenticazione della piattaforma per i giochi per Android. Questo passaggio è obbligatorio per accedere alle funzionalità dei servizi per i giochi di Play, come obiettivi e classifiche.
- L'autenticazione viene eseguita come processo silenzioso in background durante l'avvio del gioco.
Gli utenti esistenti dei servizi per i giochi di Play visualizzeranno un messaggio di benvenuto dopo l'autenticazione.
Opzioni di creazione del profilo
Il profilo dei servizi per i giochi di Play è necessario per consentire ai giocatori di interagire con la piattaforma. Alcuni giocatori potrebbero non avere un profilo Play Giochi quando iniziano a giocare al tuo gioco. A questi giocatori verrà chiesto di crearne uno.
Puoi decidere l'esperienza più adatta ai tuoi utenti scegliendo una delle seguenti opzioni:
Prompt di creazione del profilo attivati automaticamente I prompt di creazione del profilo vengono visualizzati automaticamente per impostazione predefinita quando avvii un gioco senza un profilo Play Giochi Services.
Prompt di creazione del profilo all'avvio di un gioco (fai clic per ingrandire). Disattivare le richieste di creazione del profilo all'avvio e aggiungere richieste manuali dopo l'inizializzazione del gioco Puoi disattivare le richieste di creazione del profilo attivate automaticamente tramite il file manifest. In questo modo, gli utenti senza un profilo dei servizi per i giochi di Play possono procedere con i metodi di autenticazione implementati senza che venga immediatamente richiesto di creare un profilo dei servizi per i giochi di Play.
Sebbene gli utenti possano accedere con qualsiasi provider di identità, consigliamo di avviare una richiesta di creazione del profilo Ottieni il risultato dell'autenticazione per incoraggiare la registrazione alla piattaforma Play Giochi. Attiva questo prompt a tua discrezione, ma verifica che venga visualizzato prima che gli utenti facciano progressi significativi in funzionalità come obiettivi e classifiche.
Valuta la possibilità di attivare il prompt del profilo durante questi momenti consigliati:
- Dopo aver completato un tutorial.
- Durante un momento premiato (ad esempio, vincere una partita, raccogliere un oggetto raro o raggiungere un traguardo).
- Al momento dell'avvio di una seconda sessione.
Flusso di autenticazione consigliato
Per rispettare le linee guida per l'esperienza utente di Google Play Giochi Level Up, verifica di rispettare i requisiti di continuità del giocatore. Per consentire ai giocatori di accedere correttamente al tuo gioco, utilizza il seguente flusso di autenticazione:
- Durante la sequenza di avvio del gioco, esamina le opzioni di creazione del profilo e scegli un'opzione.
- Se l'accesso automatico non funziona o l'utente lo rifiuta, mostra un pulsante di accesso manuale nel caso in cui l'utente voglia accedere in un secondo momento.
ID giocatore
Un ID giocatore è un identificatore per un account giocatore dei servizi per i giochi di Play. Il tuo gioco può recuperare un ID giocatore per qualsiasi giocatore che accede al tuo gioco utilizzando l'autenticazione dei servizi per i giochi di Play. L'integrazione del client di gioco, l'integrazione del server di gioco e il servizio di salvataggio nel cloud possono utilizzare l'ID per accedere in modo sicuro ai dati dei giocatori da Play Games Services.
L'ID giocatore è coerente per un utente quando gioca al tuo gioco su più dispositivi. Tuttavia, non è sempre coerente tra i giochi. Per saperne di più, consulta la sezione ID giocatore di nuova generazione.
Ambiti OAuth
Play Games Services si basa sul
sistema OAuth
per consentire ai giocatori di dare al tuo gioco l'accesso al proprio account. Servizi per i giochi di Play
hanno un ambito unico per i giochi (games-lite) e si basano su un altro ambito
(drive.appdata) se il tuo gioco utilizza la funzionalità delle partite salvate. La funzionalità
Partite salvate dà accesso all'account Google Drive dell'utente, in cui sono archiviati i dati di gioco.
Quando utilizzi l'SDK Play Games Services v2, puoi richiedere
ambiti OAuth aggiuntivi.
Se hai bisogno di ambiti OAuth aggiuntivi, ti consigliamo di chiamare il numero requestServerSideAccess.
Per maggiori informazioni, consulta Ottenere il codice di autenticazione server o Recuperare i codici di autenticazione server.
Più servizi di autenticazione
I servizi per i giochi di Play forniscono un'identità di gioco per i giocatori Android, ma non deve essere l'unica identità collegata ai tuoi utenti. Puoi autenticare i giocatori utilizzando i servizi per i giochi di Play, un ID di social network e il tuo sistema di ID in-game contemporaneamente.
API Recall
L'API Recall consente ai giochi di gestire i collegamenti tra gli utenti di PGS e i relativi account di gioco memorizzando i token di richiamo con i server di Google. Per scoprire di più su come attivare questa funzionalità, consulta Integrare l'API PGS Recall nel tuo gioco.
Integrazione del client di gioco
Quando integri l'autenticazione nel tuo progetto di gioco, ti consigliamo il seguente flusso utente:
Durante la sequenza di avvio del gioco, vengono avviate le opzioni di creazione del profilo e viene eseguito il tentativo di accesso dell'utente o la creazione di un nuovo account.
Se l'autenticazione automatica non funziona o l'utente la rifiuta, mostra un pulsante di accesso manuale nel caso in cui l'utente voglia accedere in un secondo momento.
Per informazioni sull'integrazione dell'autenticazione nel tuo progetto di gioco, consulta la guida introduttiva per il tuo tipo di progetto:
Integrazione del server di gioco
Puoi ottenere un codice di autorizzazione del server chiamando il numero requestServerSideAccess
una volta verificato che il giocatore è autenticato. Passa questo codice di autorizzazione del server al tuo server di gioco di backend per comunicare direttamente con i server dei servizi per i giochi di Play. Questa comunicazione
consente al tuo server di accedere ai dati dei giocatori, tra cui:
- ID giocatore
- Profilo
- Elenco di amici
- Avanzamento nel gioco
- Obiettivi
Il server utilizza quindi questo codice di autorizzazione con l'API REST per interagire in modo sicuro con i server dei servizi per i giochi di Play. Per maggiori informazioni, vedi Accesso lato server a Play Games Services.
Quota per le richieste di accesso
Esiste una quota giornaliera per le richieste di accesso con i servizi per i giochi di Play. Per ulteriori informazioni, consulta la pagina Gestione della quota giornaliera.