Данные

Модуль данных позволяет сохранять и получать кэшированные игровые данные для зарегистрированных пользователей. Эти данные также будут синхронизированы на всех устройствах, с которых пользователь играет в игру.

Если пользователь не вошел в систему, модуль данных сохраняет игровые данные в LocalStorage. При последующем входе в систему данные из LocalStorage будут автоматически синхронизированы и сохранены в учетной записи пользователя.

Предупреждение

Если вы планируете использовать модуль данных, убедитесь, что при отправке игры в магазин вы выбрали опцию "Использовать модуль данных JogosSDK" в форме "Способы сохранения прогресса игры". В противном случае модуль данных будет отключен.

Использование облачной синхронизации игровых данных

После прочтения страницы с описанием SDK для вашего игрового движка, следуйте приведенным ниже шагам для настройки и использования модуля данных.

Инициализация

Перед использованием любых методов модуля данных убедитесь, что SDK был успешно инициализирован.

Использование

// Скоро будет доступно

Предотвращение потери прогресса пользователя

Как правило, хорошей практикой является получение текущих данных перед их обновлением, чтобы избежать случайной потери прогресса игрока.

Поведение в гостевом режиме

Для пользователей, играющих в гостевом режиме, модуль данных сохраняет игровые данные в localStorage. При входе в систему вы не должны предпринимать никаких дополнительных действий - наш SDK автоматически загрузит игровые данные из учетной записи (если они существуют). Если пользователь впервые играет в вашу игру, данные из гостевого режима будут перенесены в его учетную запись. При выходе из системы SDK автоматически восстановит использование гостевых данных.

Ограничения при сохранении данных

SDK использует дебаунс (отложенную запись) для операций сохранения данных, равный 1 секунде. Это означает, что при множественных вызовах метода сохранения, реальная запись данных произойдет через 1 секунду после последнего вызова. В некоторых случаях задержка может быть увеличена до 30 секунд. Максимальный размер сохраняемых данных составляет 1 МБ. При приближении к этому лимиту в консоли браузера будет отображено предупреждение. При превышении лимита данные не будут сохранены.

Помощь по модулю данных

Если вы не уверены, как использовать модуль данных для сохранения и загрузки игрового прогресса, обратитесь к документации localStorage API, принцип работы которого аналогичен модулю данных JogosSDK. Это поможет вам интегрировать модуль данных в уже выпущенную игру.