Skip to content

Données

Le module de données permet de sauvegarder et de récupérer les données de cache de jeu pour les utilisateurs connectés. Ces données seront également synchronisées sur tous les appareils où l'utilisateur joue.

Si l'utilisateur n'est pas connecté, le module de données stockera les données de jeu dans le LocalStorage. Si l'utilisateur se connecte ultérieurement, les données de jeu du LocalStorage seront synchronisées et sauvegardées sur le compte utilisateur.

Avertissement

Si vous prévoyez d'utiliser le module de données, n'oubliez pas de sélectionner l'utilisation du module de données JogosSDK dans le formulaire "Comment votre jeu sauvegarde-t-il la progression" lors de la soumission de votre jeu. Sinon, le module de données sera désactivé.

Utilisation de la synchronisation cloud pour les données de jeu

Après avoir lu la page d'introduction de l'SDK pour votre moteur, suivez les étapes suivantes pour utiliser le module de données.

Initialisation

Avant d'utiliser toute méthode du module de données, assurez-vous que l'SDK est initialisé.

Utilisation

javascript
// Bientôt disponible
Éviter la perte de progression de l'utilisateur
En général, il est recommandé de toujours récupérer les données avant de les modifier pour s'assurer que la progression précédente du joueur ne soit pas perdue.

Comportement en mode invité

Pour les utilisateurs invités, le module de données stocke les données de jeu dans le localStorage. Lorsque l'invité se connecte, vous n'avez pas besoin d'effectuer aucune action. Notre SDK chargera automatiquement les données de jeu du compte (s'il en existe) ; si l'utilisateur n'a jamais joué à votre jeu auparavant, l'SDK transférera les données de l'invité vers le compte utilisateur. Lorsque l'utilisateur se déconnecte, l'SDK reprendra l'utilisation des données de jeu de l'invité.

Limites de sauvegarde des données

L'SDK applique un traitement anti-rebonds pour la sauvegarde des données sur une période de 1 seconde, ce qui signifie que après plusieurs appels à la méthode, la sauvegarde des données sera effectuée après 1 seconde. Dans certains cas, des exceptions peuvent survenir et le traitement anti-rebonds peut prendre jusqu'à 30 secondes. La limite de taille des données est de 1 Mo. Si vous approchez de cette limite, un avertissement sera affiché dans la console du navigateur. Si les données dépassent 1 Mo, aucune sauvegarde ne sera effectuée.

Aide sur le module de données

Si vous n'êtes pas sûr de savoir comment utiliser le module de données pour sauvegarder et charger les données de progression, consultez l'API localStorage, qui fonctionne sur le même principe que le module de données, pour intégrer le module de données dans votre jeu publié.