数据

数据模块允许保存和检索已登录用户的游戏缓存数据。这些数据还将同步到用户玩游戏的所有设备上。

若用户未登录，数据模块会将游戏数据存储在 LocalStorage 中。若用户后续登录，LocalStorage 的游戏数据会同步备份到用户账号上。

警告

如果您打算使用数据模块，请不要忘记在提交游戏时在 “您的游戏保存进度的方式” 表单中选择使用JogosSDK的数据模块。否则，数据模块将被禁用。

使用云同步游戏数据

阅读完我们针对您的引擎的SDK 介绍页面后，请按照以下步骤使用该data模块。

初始化

在使用数据模块的任何方法之前，请确保 SDK 已初始化。

用法

await window.JOGOS_SDK.game.synchronizeToCloud();

避免丢失用户进度

一般来说，在设置数据之前先获取数据是一种很好的做法，以确保玩家之前的进度不会丢失。另外，云同步需要传输时间，所以尽量避免短时间内进行同步，建议不要在1分钟使用超过1次。

游客模式行为

对于游客用户，数据模块将游戏数据存储在 中localStorage。游客登录时，您无需执行任何操作。我们的 SDK 会自动加载该账户的游戏数据（如果有）；如果该用户之前没有玩过您的游戏，SDK 会将访客数据传输到用户账户。当用户退出时，SDK 将恢复使用访客游戏数据。

数据保存限制

SDK 会在 1 秒内对数据保存进行去抖动处理，这意味着多次调用该方法后，数据保存将在 1 秒后完成。在某些情况下，可能会出现例外情况，数据保存可能需要更长的时间去抖动，最长可达 30 秒。数据限制为 1MB。如果您即将达到该限制，浏览器控制台中会显示警告。如果数据超过 1MB，将不再备份。

数据模块帮助

如果您不确定如何使用数据模块保存和加载进度数据，请参阅与数据模块工作原理相同的 localStorage API 将数据模块集成到已发布的游戏中。