L'API Recall consente ai giochi di utilizzare i servizi per i giochi di Play (PGS) in aggiunta ai meccanismi di accesso esistenti, ad esempio l'accesso con Google, e di sincronizzare senza problemi le informazioni di accesso dei giocatori tra i loro dispositivi per ridurre il tasso di abbandono per l'onboarding e aumentare la fidelizzazione D1. L'API gestisce i collegamenti tra l'account dei servizi per i giochi di Play (PGS) di un utente e i suoi account in-game archiviando i token di richiamo sui server di Google. Ecco uno scenario di esempio di come potrebbe essere utilizzata l'API Recall:
Un utente sta giocando a un gioco in cui lo sviluppatore ha un sistema di identità per monitorare i progressi dell'utente e utilizza PGS insieme ad altri metodi di autenticazione per far accedere gli utenti al suo gioco. In questo esempio, un utente ha eseguito l'accesso al suo account dei servizi per i giochi di Play Laura e crea un account in-game con il sistema di identità dello sviluppatore chiamato Racer94. Mentre l'utente gioca, il server di gioco dello sviluppatore sincronizza i suoi progressi.
Separatamente, lo sviluppatore salva su Google un token di richiamo, che corrisponde all'account in-game dell'utente. Google archivia automaticamente il token di richiamo nel profilo dei servizi per i giochi di Play dell'utente.
Ora l'utente decide di giocare per la prima volta su Google Play Giochi su PC. Viene eseguito automaticamente l'accesso dell'utente con il suo account dei servizi per i giochi di Play e il client di gioco controlla se sono disponibili progressi per questo utente dei servizi per i giochi di Play. Il server di gioco interroga Google per verificare se sono presenti token per l'account dei servizi per i giochi di Play. Poiché sono disponibili, Google restituisce il token Recall e il server di gioco utilizza quel token per trovare l'account associato dell'utente Racer94 e ripristinare i suoi progressi. Poiché l'accesso con i servizi per i giochi di Play è un'esperienza senza interruzioni, i progressi dell'utente vengono ripristinati dall'app senza che l'utente debba inserire un nome utente o una password. Inoltre, lo sviluppatore può utilizzare l'accesso dei servizi per i giochi di Play con il suo sistema di identità esistente e affidarsi a Google per memorizzare il collegamento tra i progressi dei giocatori e il suo account dei servizi per i giochi di Play.
Come mostrato nell'esempio precedente, l'API Recall esegue due azioni principali:
- Archiviare il token con Google quando un utente accede con uno degli account in-game.
- Recupero del token per un utente per ripristinare i suoi account in-game.
Oltre ai token Recall, l'API Recall richiede anche un identificatore stabile corrispondente all'account in-game, chiamato persona, per applicare i limiti di cardinalità. Un utente tipo potrebbe essere considerato l'etichetta che rappresenta l'account in-game dell'utente all'interno del sistema di identità dello sviluppatore e il token di richiamo come una chiave utilizzata per ripristinare l'account in-game dell'utente nel gioco. I valori dell'utente tipo e del token non devono essere riutilizzati in diversi progetti PGS. Inoltre, anche se i token Recall possono essere modificati nel tempo, un utente tipo dovrebbe essere stabile in base all'account in-game dell'utente.
Regole di cardinalità
L'API Recall applica una relazione 1:1 tra i profili dei servizi per i giochi di Play e gli account in-game (chiamati regole di cardinalità), in cui un utente tipo può essere collegato a un solo profilo dei servizi per i giochi di Play e un profilo dei servizi per i giochi di Play può essere collegato a un solo utente. L'utente tipo viene utilizzato come identificatore stabile per un account in-game, poiché i token Recall possono cambiare nel tempo.
Anche l'utente tipo collegato a un profilo dei servizi per i giochi di Play potrebbe essere modificato nel tempo (poiché diversi account in-game sono collegati al profilo dei servizi per i giochi di Play).
Flussi tecnici dettagliati per l'archiviazione e il recupero dei token Recall
Questa sezione illustra il flusso tecnico tra il client di gioco, il server di gioco e i server di Google durante l'archiviazione e il recupero dei token Recall:
Passaggio 1: accedi all'utente PGS e recupera l'ID sessione
Il gioco inizializza l'SDK dei servizi per i giochi di Play e tenta di far accedere l'utente con i servizi per i giochi di Play.
Supponendo che l'utente abbia eseguito l'accesso, richiedi un ID sessione all'SDK dei giochi sul client di gioco e richiedi un token OAuth 2.0 dal backend OAuth di Google. L'ID sessione e i token OAuth 2.0 vengono utilizzati per comunicare con il backend di Google Giochi.
Passaggio 2: recupera tutti i token Recall disponibili
Richiesta di qualsiasi token di richiamo associato con l'account dell'utente dei servizi per i giochi di Play. Se è presente un token, vai al passaggio 3a e ripristina l'avanzamento. Altrimenti, se si tratta di un nuovo utente e non è presente alcun token, vai al passaggio 3b e archivia un nuovo token.
Passaggio 3a: se è presente il token, ripristina l'avanzamento
Se è presente un token, recuperalo e decriptalo e ripristina i dati utente.
Passaggio 3b: se non è presente alcun token, archiviane uno
Poiché non è presente alcun token, non viene ripristinato nessun avanzamento. L'utente procede ad accedere con il sistema di identità dello sviluppatore o, se non ne esiste uno, crea un nuovo account.
Creare un token di richiamo criptato che codifica l'account in-game dell'utente e inviarlo a Google insieme all'ID sessione e al token OAuth 2.0. A questo punto, Google crea un'associazione tra il token Recall che è stato inviato e l'account dei servizi per i giochi di Play del giocatore.
Passaggi successivi
Per integrare l'API Recall con il tuo client e server di gioco, segui questa guida all'implementazione.