Skip to content

Dati

Il modulo dati consente di salvare e recuperare i dati della cache del gioco per l'utente connesso. Questi dati saranno inoltre sincronizzati su tutti i dispositivi su cui l'utente gioca.

Se l'utente non è connesso, il modulo dati memorizzerà i dati del gioco in LocalStorage. Se l'utente si connette successivamente, i dati del gioco in LocalStorage saranno sincronizzati e backup sul account utente.

Attenzione

Se prevedi di utilizzare il modulo dati, non dimenticare di selezionare l'utilizzo del modulo dati di JogosSDK nel modulo "Modalità di salvataggio del progresso del tuo gioco" quando carichi il gioco. In caso contrario, il modulo dati sarà disabilitato.

Utilizzare la sincronizzazione cloud per i dati del gioco

Dopo aver letto la pagina di introduzione dell'SDK per il tuo motore, segui i passaggi seguenti per utilizzare il modulo data.

Inizializzazione

Prima di utilizzare qualsiasi metodo del modulo dati, assicurati che l'SDK sia inizializzato.

Utilizzo

javascript
// Prossimamente
Evitare la perdita del progresso utente

In generale, è una buona pratica ottenere sempre i dati prima di impostarli, per garantire che il progresso precedente del giocatore non venga perso.

Comportamento in modalità ospite

Per gli utenti ospiti, il modulo dati memorizzerà i dati del gioco in localStorage. Quando un ospite si connette, non devi eseguire alcuna azione. Il nostro SDK caricherà automaticamente i dati del gioco dell'account (se presenti); se l'utente non ha giocato al tuo gioco in precedenza, l'SDK trasferirà i dati dell'ospite all'account utente. Quando l'utente si disconnette, l'SDK riprenderà ad utilizzare i dati del gioco dell'ospite.

Limiti per il salvataggio dei dati

L'SDK applica un anti-ritardo al salvataggio dei dati entro 1 secondo, il che significa che dopo più chiamate al metodo, il salvataggio dei dati verrà completato dopo 1 secondo. In alcuni casi, possono esserci eccezioni e il salvataggio dei dati potrebbe richiedere un anti-ritardo più lungo, fino a 30 secondi. Il limite di dati è 1MB. Se stai per raggiungere questo limite, verrà visualizzato un avviso nella console del browser. Se i dati superano 1MB, non verranno più effettuati backup.

Aiuto per il modulo dati

Se non sei sicuro di come utilizzare il modulo dati per salvare e caricare i dati di progresso, consulta l'localStorage API, che funziona allo stesso modo del modulo dati, per integrare il modulo dati nel gioco pubblicato.