Autenticazione della piattaforma

Il primo passaggio per integrare il tuo gioco con i servizi per i giochi di Google Play (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 con il 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 servizi per i giochi di Play 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. I servizi per i giochi di Play non richiedono un pulsante di accesso manuale.
• ID giocatore:dopo l'autenticazione della piattaforma riuscita, i servizi per i giochi di Play 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 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 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 dai servizi per i giochi di Play.

Un 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ù, 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ù IGA:i servizi per i giochi di Play gestiscono 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 agli obiettivi e ad 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 Google Sign-In 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 dei servizi per i giochi di Play per segnalare i progressi di un giocatore nelle funzionalità di Play Giochi, come gli obiettivi.

Integrazione consigliata

Per integrare il tuo gioco con i servizi per i giochi di Play, 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 dei servizi per i giochi di Play 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 di Play Games Services visualizzano un messaggio di benvenuto dopo l'autenticazione. Agli utenti che non hanno un profilo dei servizi per i giochi di Play viene chiesto di crearne uno durante l'inizializzazione dell'SDK.

Creazione del profilo

I giocatori hanno bisogno di un profilo dei servizi per i giochi di Play 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.

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.

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:

1. Se sul dispositivo esiste una sessione di gioco attiva, consenti al giocatore di riprendere la sessione corrente.
2. Se non è presente alcuna sessione di gioco attiva:
   1. In caso di ripristino senza interruzioni in cui un'IGA riprodotta di recente è associata all'ID giocatore PGS, procedi al ripristino automatico dell'IGA associata.
   2. 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

I servizi per i giochi di Play si basano sul sistema OAuth per consentire ai giocatori di dare al tuo gioco l'accesso al proprio account. I 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 consente l'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.

1. All'avvio, l'SDK PGS viene inizializzato per autenticare l'identità della piattaforma dell'utente (ID giocatore PGS).
2. 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.
3. Una volta che il giocatore crea o seleziona un IGA, il gioco lo associa all'identificatore principale scelto nel backend.
4. Il gioco associa anche questo IGA scelto all'ID giocatore PGS, contrassegnandolo come l'IGA giocato per ultimo 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.

1. 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.
2. Contemporaneamente, se applicabile, il gioco ignora le schermate di accesso e accede immediatamente alla sessione IGA attiva del giocatore o all'ultima sessione IGA 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.

1. Il giocatore esce dall'IGA corrente, ma la connessione alla piattaforma PGS rimane attiva.
2. 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.

1. Al lancio, PGS autentica l'utente e fornisce l'ID giocatore PGS al gioco.
2. Il gioco controlla il proprio backend (o il token di richiamo recuperato se utilizza l'API Recall) per verificare se l'ultima IGA giocata è già collegata a questo ID PGS.
3. Se viene trovato un collegamento, il gioco ripristina automaticamente i progressi del giocatore e lo registra, saltando completamente la schermata di accesso manuale.
4. Altrimenti, il gioco mostra al giocatore la schermata di accesso
   1. Il giocatore sceglie quindi un metodo di accesso e accede a un IGA
   2. 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 gioco e giocare utilizzando un account ospite locale. PGS esegue ancora l'autenticazione in background. Se il giocatore sceglie di Salvare i progressi, il gioco converte la sessione ospite in un IGA permanente e lo associa all'ID giocatore PGS.