L'API Recall consente ai giochi di utilizzare i servizi per i giochi di Play (PGS) come complemento del proprio meccanismi di accesso esistenti, ad esempio Accedi con Google, e giocatori le informazioni di accesso su tutti i loro dispositivi per ridurre il tasso di abbandono delle operazioni preliminari e aumentare la fidelizzazione dopo 1 giorno. L'API gestisce i collegamenti tra l'account dei servizi per i giochi di Play (PGS) di un utente e i propri account in-game memorizzando i token di richiamo sui server di Google. Ecco un uno scenario di esempio sull'utilizzo dell'API Recall:
Un utente sta giocando a un gioco in cui lo sviluppatore ha un sistema di identità da monitorare i progressi degli utenti e utilizza i servizi per i giochi di Play in parallelo con altri metodi di autenticazione per consentire agli utenti di accedere al loro gioco. In questo esempio, un utente ha eseguito l'accesso ai suoi servizi per i giochi di Play Laura e crea un account in-game con il nome chiamato Racer94. Mentre l'utente gioca, il il server di gioco dello sviluppatore sincronizza i suoi progressi.
Separatamente, lo sviluppatore salva un token di richiamo con Google, che corrisponde all'account in-game dell'utente. Google archivia automaticamente che richiamano il token rispetto al profilo dei servizi per i giochi di Play dell'utente.
Ora l'utente decide di giocare su Google Play Giochi su PC nel tempo. L'utente accede automaticamente con il proprio account dei servizi per i giochi di Play e Il client del gioco controlla se sono disponibili progressi per questa offerta dei servizi per i giochi di Play utente. Il server di gioco interroga Google per verificare se sono presenti token per per questo account dei servizi per i giochi di Play. Dato che esistono, Google restituisce il token di richiamo e il server di gioco utilizza quel token per trovare l'account associato all'utente Racer94 e ripristina i loro progressi. L'accesso con i servizi per i giochi di Play è senza interruzioni, i progressi dell'utente vengono ripristinati dall'app senza all'utente che deve inserire un nome utente o una password. Inoltre, lo sviluppatore possono utilizzare l'accesso dei servizi per i giochi di Play con il loro sistema di identità esistente e affidarsi ai servizi Google per memorizzare il collegamento tra i progressi dei giocatori e il loro account dei servizi per i giochi di Play.
Come si vede nell'esempio precedente, due azioni principali vengono eseguite l'API Recall:
- Memorizzare il token con Google quando un utente accede con uno dei token in-game .
- Recupero del token per un utente al fine di ripristinare il suo account in-game .
Oltre ai token Recall, l'API Recall richiede anche un identificatore stabile corrispondente all'account in-game, noto come persona, per applicare vincoli di cardinalità. Potresti pensare a un utente tipo come etichetta che rappresenta l'account in-game dell'utente nell'account e il token di richiamo come chiave utilizzata per ripristinare l'account in-game dell'utente al gioco. I valori di utente tipo e token non devono essere riutilizzati tra diverse Progetti dei servizi per i giochi di Play. Inoltre, anche se i token di richiamo possono essere modificati nel tempo, un utente tipo deve 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 i profili in-game account (chiamati regole di cardinalità), in cui un utente tipo può essere è collegato a un profilo dei servizi per i giochi di Play, che può essere collegato a un solo profilo utente tipo. L'utente tipo viene utilizzato come identificatore stabile per un account in-game poiché i token Recall possono cambiare nel tempo.
L'utente tipo collegato a un profilo dei servizi per i giochi di Play può anche essere modificato nel tempo (come gli account in-game sono collegati al profilo dei servizi per i giochi di Play).
Flussi tecnici dettagliati per l'archiviazione e recuperando i token Recall
Questa sezione riguarda il flusso tecnico tra il client di gioco, il server di gioco, e dai server di Google per l'archiviazione e il recupero dei token Recall:
Passaggio 1: accedi all'utente dei servizi per i giochi di Play 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 questo servizio.
Supponendo che l'utente abbia eseguito l'accesso, richiedi un ID sessione dall'SDK Games nella client di gioco e richiedi un token OAuth 2.0 dal backend OAuth di Google. La ID sessione e token OAuth 2.0 vengono utilizzati per comunicare con i giochi Google di un backend cloud.
Passaggio 2: recupera qualsiasi token di richiamo disponibile
Richiesta di qualsiasi token di richiamo associato all'account dell'utente dei servizi per i giochi di Play. Se un token è presente, vai al passaggio 3a e ripristina l'avanzamento del ripristino. In caso contrario, se si tratta di un nuovo utente e quest'ultimo non dispone di token, procedi con Passaggio 3b e archivia un nuovo token.
Passaggio 3a: se è presente un token, ripristina lo stato di avanzamento del ripristino
Se è presente un token, recuperalo, decriptalo e ripristina i dati utente.
Passaggio 3b: se non è presente alcun token, memorizzane uno
Poiché non è presente alcun token, l'avanzamento non viene ripristinato. L'utente procede all'accesso con il sistema di identità dello sviluppatore oppure crea un nuovo account se non esistono.
Creare un token di richiamo criptato che codifica l'account in-game dell'utente. lo invii 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.
Flussi per gli utenti che non hanno un profilo dei servizi per i giochi di Play
Puoi archiviare i token di richiamo per un utente che non ha ancora creato un profilo dei servizi per i giochi di Play usando la modalità senza profilo. Tuttavia, è necessario fare due importanti avvertenze:
- Non puoi recuperare i token per un utente che non ha un profilo dei servizi per i giochi di Play. Profilo la creazione viene chiesto automaticamente quando l'utente tenta di accedere al tuo gioco con i servizi per i giochi di Play su un secondo dispositivo.
- Devi seguire linee guida aggiuntive
di assicurarti di avere un avviso appropriato che descriva i seguenti elementi e
ottenere il consenso appropriato degli utenti finali:
- .
- La tua condivisione dei dati con Google per attivare l'account Play Giochi funzionalità di collegamento.
- La disponibilità delle impostazioni per gestire questa condivisione, ad esempio Play Giochi impostazioni.
- Il trattamento di questi dati ai sensi delle Norme sulla privacy di Google Norme.
Archiviare un token e una coppia di utenti tipo
- Un utente senza un profilo dei servizi per i giochi di Play apre un gioco con richiamo senza profilo in un bucket in cui è abilitato il controllo delle versioni.
- L'SDK Games attiva un accesso automatico, che non va a buon fine perché l'utente ha Nessun profilo dei servizi per i giochi di Play.
- L'SDK Games mostra una snackbar che informa l'utente che il gioco ha integrazione con Google. Questa snackbar è selezionabile e l'utente può disattivarla richiamarlo finché non viene creato un profilo.
- Il gioco richiede l'accesso per il richiamo. Tieni presente che i servizi per i giochi di Play rifiuta le richieste di accesso di richiamo. quando sul dispositivo sono presenti profili dei servizi per i giochi di Play o non sono presenti Account sul dispositivo. In questo caso, il gioco dovrebbe procedere senza utilizzare servizi per i giochi di Play
- Dopo che l'utente ha eseguito l'accesso con un account in-game, il gioco crea un token e una coppia di utenti tipo per l'utente che corrisponde all'account in-game. Il gioco memorizza la coppia con Google. Il gioco potrebbe memorizzare altri token in un secondo momento se l'utente accede ad altri account in-game.
Avviare un gioco su un nuovo dispositivo
- Un utente senza un profilo dei servizi per i giochi di Play apre un gioco in cui è attivato il richiamo senza profilo su un dispositivo.
- Il gioco registra un token di richiamo senza profilo come descritto in Memorizzare un token e coppia di utenti tipo.
- L'utente apre lo stesso gioco su un altro dispositivo con lo stesso account. configurazione.
- L'SDK Games attiva la creazione del profilo. L'utente può rivedere e rifiutare archiviati in precedenza. Al momento l'utente crea un profilo dei servizi per i giochi di Play.
- L'accesso automatico ai servizi per i giochi di Play viene completato e il gioco riceve autenticato.
- Il gioco recupera i token Recall per l'utente come al solito.
Passaggi successivi
Per integrare l'API Recall con il tuo client e il tuo server di gioco, segui questa guida all'implementazione.