Il primo passo per integrare il tuo gioco con Google Play Games Services (PGS) è l'implementazione dell'autenticazione della piattaforma. Questo passaggio è obbligatorio per accedere a tutte le altre funzionalità, come obiettivi, classifiche ed eventi.
Poiché l'SDK di Play Games Services esegue automaticamente l'autenticazione della piattaforma all'avvio del gioco, devi integrare l'SDK PGS v2 con il tuo gioco e implementare il flusso di autenticazione consigliato, in modo che il gioco sia pronto per implementare e soddisfare le linee guida per l'esperienza utente di Google Play Games Level Up user experience guidelines.
Concetti di autenticazione
Nei Play Games Services v2, il concetto di "accesso" è suddiviso in due livelli distinti: autenticazione della piattaforma e autenticazione in-game.
Autenticazione della piattaforma
Play Games Services fornisce un livello di coinvolgimento della piattaforma. Gestisce la relazione del giocatore con l'ecosistema di Google Play Giochi utilizzando il profilo giocatore per accedere a funzionalità come obiettivi, classifiche e missioni. L'autenticazione della piattaforma ha le seguenti caratteristiche principali:
- Silenziosa e automatica: l'autenticazione avviene automaticamente in background all'avvio del gioco. Play Games Services non richiede un pulsante Accedi manuale.
- ID giocatore: dopo l'autenticazione della piattaforma, Play Games Services forniscono un ID giocatore stabile. Questo ID è coerente su tutti i dispositivi per lo stesso gioco. Utilizza questo ID principalmente per monitorare le funzionalità della piattaforma, ad esempio i progressi degli obiettivi.
- Disaccoppiata: non devi utilizzare i Play Games Services come sistema di identità principale del tuo gioco per gestire l'account in-game (IGA), i progressi di gioco o l'inventario del giocatore. Play Games Services funge da identificatore di piattaforma persistente.
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 di Play Games Services. 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 ID giocatore di nuova generazione.
Autenticazione in-game
Gestisci l'account in-game (IGA), ovvero il sistema di identità che associa i progressi, l'inventario e la valuta del giocatore all'interno del gioco.
- Identità principale: puoi utilizzare il tuo backend, Accedi con Google (SiWG) o altri provider come metodo di accesso principale.
- Indipendenza: i giocatori possono accedere a Play Games Services (identità della piattaforma) per ottenere obiettivi mentre hanno eseguito l'accesso a un IGA specifico (ad esempio, un account ospite o un account SiWG specifico).
- Gestione di più IGA: Play Games Services gestisce solo l'autenticazione della piattaforma. Il tuo gioco gestisce l'autenticazione principale dei giocatori nei loro IGA. Ciò significa che non ci sono modifiche ai flussi esistenti del gioco per consentire ai giocatori di passare da un IGA all'altro. Quando i giocatori cambiano account, rimangono autenticati alla piattaforma Play Giochi tramite PGS e tu continui a inviare i loro dati relativi agli obiettivi e ad altre funzionalità PGS in base all'ID giocatore persistente.
Continuità multipiattaforma con SiWG
Per aiutare i giocatori a trasferire i loro progressi su Android, iOS e web, utilizza Accedi con Google come metodo di autenticazione in-game principale. Tieni presente quanto segue:
- Pulsante Accedi con Google: in PGS v1, il pulsante Google Play spesso gestiva sia l'accesso alla piattaforma sia l'accesso al gioco. Nella v2, questi sono processi separati. Implementa un pulsante Accedi con Google standard per consentire ai giocatori di autenticarsi e accedere al proprio IGA.
- SDK Google Sign-in:
- Sia per Android sia per iOS, utilizza gli SDK Google Sign-in standard per autenticare i giocatori nei loro IGA.
- Utilizza Google Open ID come identificatore principale per l'account in-game di un giocatore.
- Utilizza l'ID giocatore di Play Games Services per segnalare i progressi di un giocatore nelle funzionalità di Play Giochi, ad esempio gli obiettivi.
Integrazione consigliata
Per integrare il tuo gioco con Play Games Services, segui questi passaggi consigliati:
Inizializzazione e autenticazione
Questo passaggio è necessario per inizializzare e autenticare il gioco:
Implementa l'autenticazione della piattaforma inizializzando la v2 dell'SDK di Play Games Services all'avvio. Per maggiori informazioni, consulta la sezione Autenticazione della piattaforma per i giochi per Android. Questo passaggio è obbligatorio per accedere alle funzionalità di Play Games Services, come obiettivi e classifiche.
L'autenticazione viene eseguita come processo in background silenzioso durante l'avvio del gioco. Gli utenti esistenti di Play Games Services vedono un messaggio di benvenuto dopo l'autenticazione. Agli utenti che non hanno un profilo Play Games Services viene chiesto di creare un profilo durante l'inizializzazione dell'SDK.
Creazione del profilo
I giocatori hanno bisogno di un profilo Play Games Services per interagire con la piattaforma. Alcuni giocatori potrebbero non avere un profilo Play Games Services quando iniziano a giocare al tuo gioco. A questi giocatori verrà chiesto di crearne uno. Puoi decidere l'esperienza giusta per i tuoi utenti scegliendo una delle seguenti opzioni:
Prompt di creazione del profilo attivati automaticamente
I prompt di creazione del profilo attivati automaticamente vengono visualizzati automaticamente per impostazione predefinita quando avvii un gioco senza un profilo Play Games Services.
Interrompere i prompt di creazione del profilo attivati automaticamente
Disattiva i prompt del profilo all'avvio configurando il file manifest per impedire i prompt attivati automaticamente. In questo modo, gli utenti senza un profilo Play Games Services possono continuare a caricare il gioco senza che venga chiesto loro di creare un profilo Play Games Services.
Sebbene gli utenti possano accedere con qualsiasi provider di identità, devi visualizzare un prompt di creazione del profilo per incoraggiarli ad autenticarsi con l'autenticazione della piattaforma Play Giochi. Visualizza questo prompt in base alle esigenze, ma assicurati 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 di ricompensa (ad esempio, vincere una partita, raccogliere un oggetto raro o raggiungere un traguardo).
- Al momento dell'avvio di una seconda sessione.
Per saperne di più, consulta Impedire la creazione automatica di profili (Java) e Impedire la creazione automatica di profili (Unity).
Autenticazione in-game
Una volta eseguita correttamente l'autenticazione della piattaforma, gli sviluppatori devono implementare i seguenti passaggi per consentire ai giocatori di accedere ai propri IGA, a seconda dello stato attuale del gioco:
- Se sul dispositivo esiste una sessione di gioco attiva, consenti al giocatore di riprendere la sessione corrente.
- Se non è presente alcuna sessione di gioco attiva:
- Nel caso di uno scenario di ripristino senza interruzioni in cui un IGA giocato di recente è associato all'ID giocatore PGS, procedi al ripristino automatico dell'IGA associato.
- In caso contrario, mostra al giocatore la schermata di accesso o di creazione dell'account designata dell'applicazione. I giocatori possono quindi scegliere il metodo di autenticazione preferito per creare o accedere a un IGA esistente.
Ambiti OAuth
Play Games Services si basa sul
sistema OAuth
per consentire ai giocatori di concedere al tuo gioco l'accesso al proprio account. Play Games Services ha un ambito univoco per i giochi (games-lite) e si basa su un altro ambito (drive.appdata) se il tuo gioco utilizza la funzionalità Partite salvate. La funzionalità Partite salvate consente di accedere all'account Google Drive dell'utente, in cui vengono memorizzati i dati di gioco.
Quando utilizzi la v2 dell'SDK dei servizi per i giochi di Play, puoi richiedere ambiti OAuth aggiuntivi.
Se hai bisogno di ambiti OAuth aggiuntivi, ti consigliamo di chiamare requestServerSideAccess.
Per saperne di più, consulta
Ottieni il codice di autorizzazione server o Recupera i codici di autorizzazione server.
Linee guida per l'esperienza utente per un flusso di autenticazione ideale
Le seguenti linee guida spiegano il flusso di autenticazione consigliato con l'integrazione di PGS v2. Trattano scenari per utenti nuovi, esistenti e di ritorno, nonché la modalità Ospite.
Nuovo giocatore
Questo flusso si applica a un utente che avvia il gioco per la prima volta su un dispositivo senza una cronologia di gioco precedente.
- All'avvio, l'SDK PGS viene inizializzato per autenticare l'identità della piattaforma dell'utente (ID giocatore PGS).
- Dopo questo handshake in background, il gioco mostra al giocatore le opzioni di creazione dell'IGA, ad esempio Crea nuovo account, Accedi con Google o altri metodi di accesso social.
- Una volta che il giocatore crea o seleziona un IGA, il gioco associa questo account all'identificatore principale scelto nel backend.
- Il gioco associa anche l'IGA scelto all'ID giocatore PGS, contrassegnandolo come l' IGA giocato di recente per un ripristino senza interruzioni.
Giocatori con sessioni attive
Questo scenario descrive i giocatori che avviano il gioco su un dispositivo in cui hanno già una sessione attiva. L'obiettivo è fornire un'esperienza di accesso senza interruzioni.
- Quando il giocatore avvia l'app, PGS esegue l'autenticazione in background senza interruzioni, fornendoti l'ID giocatore per monitorare i progressi rispetto agli obiettivi e ad altre funzionalità di Play Giochi.
- Contemporaneamente, se applicabile, il gioco ignora le schermate di accesso e accede immediatamente alla sessione IGA attiva del giocatore o all'IGA giocato di recente associato al suo ID giocatore, in modo che possa riprendere immediatamente il gameplay.
Giocatori che cambiano account
Questo flusso si verifica quando un giocatore con una sessione attiva passa alle impostazioni del gioco per cambiare account. Ad esempio, disconnettersi da un account principale per utilizzare un account alternativo.
- Il giocatore si disconnette dall'IGA corrente, ma la connessione alla piattaforma PGS rimane attiva.
- Quando il giocatore accede con un IGA diverso, il gioco associa questo nuovo account all'ID giocatore PGS corrente come IGA giocato di recente solo per un ripristino senza interruzioni.
Ripristino senza interruzioni per i giocatori di ritorno
Questo scenario si applica quando un giocatore avvia il gioco dopo un periodo di inattività, una reinstallazione o su un dispositivo completamente nuovo. È consigliabile che il gioco implementi il ripristino senza interruzioni.
- All'avvio, PGS autentica l'utente e fornisce l'ID giocatore PGS al gioco.
- Il gioco controlla il suo backend (o il token di richiamo recuperato se utilizzi l'API Recall) per verificare se un IGA giocato di recente è già collegato a questo ID PGS.
- Se viene trovato un link, il gioco ripristina automaticamente i progressi del giocatore e accede, saltando completamente la schermata di accesso manuale.
- In caso contrario, il gioco mostra al giocatore la schermata di accesso.
- Il giocatore sceglie un metodo di accesso e accede a un IGA.
- Il gioco associa quindi questo IGA all'ID giocatore PGS come IGA giocato di recente per un ripristino senza interruzioni.
Modalità Ospite
I giocatori possono avviare il gioco e giocare utilizzando un account ospite locale. Play Games Services autentica comunque il giocatore in background. Se il giocatore seleziona Salva progressi, il gioco converte la sessione ospite in un IGA permanente e lo associa all'ID giocatore. Per saperne di più sulla risoluzione dei conflitti, consulta Account ospite.
