Skip to content

Datos

El módulo de datos permite guardar y recuperar datos en caché del juego de los usuarios que han iniciado sesión. Estos datos también se sincronizarán en todos los dispositivos desde los que el usuario juega al juego.

Si el usuario no ha iniciado sesión, el módulo de datos almacenará los datos del juego en LocalStorage. Si el usuario inicia sesión posteriormente, los datos del juego de LocalStorage se respaldarán sincrónicamente en la cuenta del usuario.

Advertencia

Si planeas usar el módulo de datos, no olvides seleccionar el uso del módulo de datos de JogosSDK en el formulario "Forma en que tu juego guarda el progreso" al enviar el juego. De lo contrario, el módulo de datos se desactivará.

Usar la sincronización en la nube para datos del juego

Después de leer la página de introducción del SDK para tu motor, sigue estos pasos para usar el módulo data.

Inicialización

Antes de usar cualquier método del módulo de datos, asegúrate de que el SDK se haya inicializado.

Uso

javascript
// Próximamente
Evitar la pérdida del progreso del usuario
En general, es una buena práctica siempre recuperar los datos antes de establecerlos, para asegurarse de que no se pierda el progreso anterior del jugador.

Comportamiento en modo invitado

Para los usuarios invitados, el módulo de datos almacenará los datos del juego en localStorage. Cuando un invitado inicia sesión, no necesitas realizar ninguna acción. Nuestro SDK cargará automáticamente los datos del juego de la cuenta (si los hay); si el usuario no ha jugado a tu juego antes, el SDK transferirá los datos del invitado a la cuenta del usuario. Cuando el usuario cierre sesión, el SDK volverá a usar los datos del juego del invitado.

Límites de guardado de datos

El SDK aplicará un procesamiento de debounce al guardado de datos en 1 segundo, lo que significa que después de múltiples llamadas al método, el guardado de datos se completará 1 segundo después. En某些 casos, pueden producirse excepciones: el guardado de datos podría necesitar un procesamiento de debounce más prolongado, con un máximo de 30 segundos. El límite de datos es de 1MB. Si estás a punto de alcanzar este límite, se mostrará una advertencia en la consola del navegador. Si los datos superan los 1MB, no se volverán a respaldar.

Ayuda con el módulo de datos

Si no estás seguro de cómo usar el módulo de datos para guardar y cargar los datos del progreso, consulta la API de localStorage, que funciona del mismo modo que el módulo de datos, para integrar el módulo de datos en el juego publicado.