Il primo passaggio per integrare il tuo gioco con Google Play Games Services (PGS) è l'implementazione dell'autenticazione della piattaforma. Questo è necessario per accedere a tutte le altre funzionalità, come obiettivi, classifiche ed eventi.
Poiché l'SDK Play Games Services esegue automaticamente l'autenticazione della piattaforma all'avvio del gioco, devi integrare l'SDK PGS v2 nel tuo gioco e implementare il flusso di autenticazione consigliato, in modo che il tuo gioco sia pronto per implementare e soddisfare le linee guida per l'esperienza utente di Google Play Games Level Up.
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 il rapporto del giocatore con l'ecosistema 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 di accesso 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.
- Disaccoppiato:non devi utilizzare Play Games Services come sistema di identità principale del tuo gioco per gestire l'account di gioco (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 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.
Un ID giocatore è coerente per un utente quando gioca al tuo gioco su più dispositivi. Tuttavia, non è sempre coerente tra i giochi. Per ulteriori informazioni, vedi ID giocatore di nuova generazione.
Autenticazione in-game
Gestisci l'account in-game (IGA), ovvero il sistema di identità che lega 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 ai servizi per i giochi di Play (identità della piattaforma) per ottenere obiettivi mentre sono connessi a qualsiasi IGA specifico (ad esempio, un account ospite o un account SiWG specifico).
- Gestione di più intent di gioco integrati:Play Games Services gestisce solo l'autenticazione della piattaforma. Il tuo gioco gestisce l'autenticazione principale dei giocatori nelle loro IGA. Ciò significa che non sono previste modifiche ai flussi esistenti del tuo gioco per consentire ai giocatori di passare da un'IGA all'altra. Quando i giocatori cambiano account, rimangono autenticati sulla piattaforma Play Giochi tramite PGS e tu continui a inviare i loro dati relativi a obiettivi e altre funzionalità di PGS in base all'ID giocatore persistente.
Continuità multipiattaforma con Accedi con Google
Per aiutare i giocatori a trasferire i loro progressi su Android, iOS e web, utilizza Accedi con Google come metodo di autenticazione principale nel gioco. Considera quanto segue:
- Pulsante Accedi con Google:in PGS v1, il pulsante Google Play spesso gestiva l'accesso sia alla piattaforma che al gioco. Nella v2, questi sono processi separati. Implementa un pulsante standard Accedi con Google per consentire ai giocatori di autenticarsi e accedere al proprio ID giocatore.
- SDK Google Sign-in:
- Per Android e iOS, utilizza gli SDK di accesso con Google standard per autenticare i giocatori nelle 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 Games, come 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 silenzioso in background durante l'avvio del gioco. Gli utenti esistenti di Play Games Services visualizzano 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. 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 attivati automaticamente vengono visualizzati automaticamente per impostazione predefinita quando avvii un gioco senza un profilo dei servizi per i giochi di Play.
Interrompere i prompt di creazione del profilo attivati automaticamente
Disattiva le richieste di profilo all'avvio configurando il file manifest per impedire le richieste attivate 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 mostrare un prompt di creazione del profilo per incoraggiarli a eseguire l'autenticazione con l'autenticazione della piattaforma Play Giochi. Mostra questo messaggio quando necessario, ma assicurati che venga visualizzato prima che gli utenti facciano progressi significativi in funzionalità come gli obiettivi e le 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.
Per maggiori informazioni, 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 acquisti in-app, 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:
- In caso di ripristino senza interruzioni in cui l'ultimo IGA giocato è 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 della tua 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 dare al tuo gioco l'accesso al proprio account. Play Games Services
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 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 autenticazione server o Recupera i codici di autenticazione server.
Linee guida per l'esperienza utente per il flusso di autenticazione ideale
Le seguenti linee guida spiegano il flusso di autenticazione consigliato con l'integrazione di PGS v2. Coprono scenari per utenti nuovi, esistenti e di ritorno e 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.
- Al lancio, 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 lo associa all'identificatore principale scelto nel backend.
- Il gioco associa anche questo IGA scelto all'ID giocatore PGS, contrassegnandolo come ultimo IGA giocato per il ripristino senza problemi.
Giocatori con sessioni attive
Questo scenario descrive i giocatori che avviano il gioco su un dispositivo su 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 modo invisibile in background, 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'ultima IGA giocata associata al suo ID giocatore, in modo che possa riprendere a giocare immediatamente.
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, uscire da un account principale per utilizzare un account alternativo.
- Il giocatore esce dall'IGA corrente, ma la connessione alla piattaforma PGS rimane attiva.
- Quando il giocatore esegue l'accesso con un altro IGA, il gioco associa questo nuovo account all'ID giocatore PGS corrente come ultimo IGA giocato solo per un ripristino senza interruzioni.
Ripristino senza interruzioni per i giocatori di ritorno
Questo scenario si verifica 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.
- Al lancio, PGS autentica l'utente e fornisce l'ID giocatore PGS al gioco.
- Il gioco controlla il proprio backend (o il token di richiamo recuperato se utilizza l'API Recall) per verificare se l'ultimo IGA giocato è già collegato a questo ID PGS.
- Se viene trovato un collegamento, il gioco ripristina automaticamente i progressi del giocatore e lo registra, saltando completamente la schermata di accesso manuale.
- Altrimenti, il gioco mostra al giocatore la schermata di accesso
- Il giocatore sceglie quindi un metodo di accesso e accede a un IGA
- Il gioco associa quindi questo IGA all'ID giocatore PGS come ultimo IGA giocato per un ripristino senza problemi.
Modalità Ospite
I giocatori possono avviare il tuo 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.
