Partite salvate

Il servizio Giochi salvati ti offre un metodo pratico per salvare i progressi dei tuoi giocatori nei server di Google. Il gioco può recuperare i dati dei giochi salvati per consentire ai giocatori di ritorno di continuare una partita all'ultimo punto di salvataggio da qualsiasi dispositivo.

Il servizio Giochi salvati consente di sincronizzare i dati dei giochi di un giocatore su più dispositivi. Ad esempio, se hai un gioco eseguito su Android, puoi utilizzare il servizio Giochi salvati per consentire a un giocatore di avviare un gioco sul suo telefono Android e continuare a giocare su un tablet senza perdere i suoi progressi. Questo servizio può essere utilizzato anche per garantire che il gameplay di un giocatore continui dal punto in cui è stato interrotto, anche se il dispositivo viene smarrito, distrutto o permutato per un modello più recente.

Per scoprire come implementare i giochi salvati per la tua piattaforma, consulta Implementazioni del client.

Nozioni di base sui giochi salvati

Un gioco salvato è costituito da due parti:

  • Un blob binario non strutturato: questi dati possono rappresentare ciò che scegli tu e il tuo gioco è responsabile della relativa analisi e scrittura.
  • Metadati strutturati: proprietà aggiuntive associate ai dati binari che consentono ai servizi per i giochi di Google Play di presentare visivamente i giochi salvati nell'interfaccia utente predefinita dell'elenco Giochi salvati e di presentare informazioni utili nell'app Google Play Giochi (ad esempio, timestamp dell'ultimo aggiornamento).

Un gioco può scrivere un numero arbitrario di Giochi salvati per un singolo giocatore, soggetto alla quota di utenti, quindi non è richiesto un limite per i giocatori a un singolo file di salvataggio.

Immagini di copertina

Il servizio Giochi salvati offre un'esperienza utente visiva oltre alle funzionalità di persistenza. Ti consigliamo vivamente di associare le immagini rappresentanti ai file di salvataggio corrispondenti. Se utilizzi l'interfaccia utente (UI) salvata dell'elenco dei giochi salvati nell'SDK Play Giochi nel tuo gioco, nella UI verranno visualizzate queste immagini di copertina. Le immagini di copertina potrebbero essere visualizzate anche nell'app Google Play Giochi.

Descrizioni

Puoi fornire una breve descrizione testuale dei contenuti di un determinato gioco salvato. La descrizione viene mostrata direttamente ai giocatori e deve riepilogare lo stato rappresentato dal gioco salvato, ad esempio "Lotta ai Goblin nei boschi scuri".

Quota

Agli sviluppatori non viene addebitato alcun costo per i dati dei giochi salvati archiviati nel cloud. Questi dati vengono conteggiati nella quota di Google Drive del player, pertanto non devi mai preoccuparti di questo aspetto. L'unica quota a cui gli sviluppatori di giochi devono preoccuparsi è la quota dell'API Google Drive.

Isolamento lettura/scrittura

Tutti i giochi salvati vengono memorizzati nella cartella Dati applicazioni di Google Drive dei tuoi giocatori. Questa cartella può essere letta e scritta solo dal tuo gioco, non può essere visualizzata né modificata dai giochi di altri sviluppatori, pertanto è presente una protezione aggiuntiva contro i danni causati dai dati. Inoltre, i giochi salvati vengono isolati dalle manomissione diretta dei giocatori, pertanto non possono modificare i singoli giochi salvati.

Assistenza offline

Il gioco può comunque leggere e scrivere in un gioco salvato quando il dispositivo del giocatore è offline, ma non potrà sincronizzarsi con i servizi per i giochi di Google Play finché non verrà stabilita la connettività di rete. Dopo la riconnessione, i servizi per i giochi di Google Play aggiornano in modo asincrono i dati dei giochi salvati sui server di Google.

Risoluzione dei conflitti

Se utilizzi il servizio Giochi salvati, il gioco potrebbe riscontrare conflitti quando tenti di risparmiare dati. Questi conflitti possono verificarsi quando un utente esegue più di un'istanza della tua applicazione su dispositivi o computer diversi. L'applicazione deve essere in grado di risolvere questi conflitti in modo da offrire la migliore esperienza utente.

In genere i conflitti di dati si verificano quando un'istanza della tua applicazione non è in grado di raggiungere il servizio Giochi salvati durante il tentativo di caricamento o di salvataggio dei dati. In generale, il modo migliore per evitare conflitti di dati è caricare sempre i dati più recenti dal servizio all'avvio o al ripristino dell'applicazione e salvare i dati nel servizio con una frequenza ragionevole. Tuttavia, non è sempre possibile evitare conflitti di dati. L'applicazione deve fare il possibile per gestire i conflitti in modo che i dati degli utenti vengano conservati e che abbiano un'esperienza positiva.

Limiti

I servizi per i giochi di Google Play attualmente applicano limiti di dimensioni per i dati binari e le dimensioni delle immagini di copertina rispettivamente di 3 MB e 800 kB.

Metadati dei giochi salvati

I metadati strutturati per un gioco salvato contengono queste proprietà:

Proprietà Descrizione
ID Una stringa univoca generata dai servizi per i giochi di Google Play per questo gioco salvato. Utilizza questo ID per fare riferimento al gioco salvato nei client di gioco.
funzionalità Un nome breve fornito dallo sviluppatore per il gioco salvato, ad esempio "Salva slot 1" o "PlayerName_Save1". Non viene mostrato ai giocatori.
Description (Descrizione) Una descrizione del gioco salvata fornita dallo sviluppatore.
Ultima modifica Timestamp in millisecondi generato dai servizi per i giochi di Google Play relativi all'ultimo aggiornamento del gioco salvato.
Tempo di gioco Un tempo fornito dallo sviluppatore (in millisecondi) da mostrare nel gioco salvato. Questo valore dovrebbe rappresentare il tempo di riproduzione del gioco salvato corrispondente. Ad esempio, un valore di 3600000 tempo di riproduzione verrà visualizzato nei servizi per i giochi di Google Play come "1 h".
Immagine di copertina Si tratta di una proprietà facoltativa fornita dallo sviluppatore che contiene informazioni sull'immagine di copertina.

Implementazioni client

Per scoprire come implementare i Giochi salvati per la tua piattaforma, consulta le seguenti risorse: