Интеграция облачных сохранений и достижений

Интеграция облачных сохранений и достижений

Игрок прошёл 40 уровней на iPhone, переставил игру на iPad — прогресс обнулился. Это не «мелкая недоработка». По данным нескольких мобильных студий, потеря прогресса при переустановке входит в топ-3 причин негативных отзывов и отказа от игры. iCloud или Google Play Games Services решают проблему — но их корректная интеграция требует больше, чем вызов одного метода.

Сложности, которые не видны до продакшена

Конфликты при merge сохранений. Пользователь играл офлайн на двух устройствах. Когда оба подключились — у вас два несовместимых снапшота прогресса. Apple Game Center и Google Play Games не решают за вас конфликты: они отдают оба снапшота и ждут, пока клиент выберет победителя. Без реализованного conflict resolution с понятным UI («Ваш прогресс на этом устройстве: 43 уровня / В облаке: 38 уровней — что оставить?») пользователь получит потерю данных.

Размер и частота записей. Google Play Saved Games ограничивает снапшот размером 3 МБ, а общий объём сохранений на аккаунт — 10 МБ (по умолчанию). Если сохранение включает данные инвентаря с несколькими тысячами записей — нужно сериализовать только дельту или оптимизировать формат. Частые автосохранения (после каждого действия) создают очередь записей, которая при плохом соединении накапливается и вызывает GooglePlayGames.SavedGame.ISavedGameClient timeout.

Apple iCloud Keychain vs CloudKit. Для простых игр достаточно NSUbiquitousKeyValueStore — синхронизирует до 1 МБ пар ключ-значение. Для сложного прогресса нужен CloudKit с CKContainer и CKRecord. Unity не имеет нативного CloudKit binding — интеграция требует написания Objective-C/Swift плагина или использования стороннего решения типа CloudSave от Unity Gaming Services.

Unity Gaming Services Cloud Save

Для кроссплатформенных проектов (iOS + Android + PC) оптимальный путь — Unity Cloud Save из пакета com.unity.services.cloudsave. Хранит JSON-документы до 1 МБ, работает через Unity Authentication (анонимные аккаунты или federated identity), поддерживает server-side validation через Cloud Code.

Ключевой момент: CloudSaveService.Instance.Data.Player.SaveAsync() — асинхронный, бросает CloudSaveValidationException при превышении квот и CloudSaveException при сетевых ошибках. Обработка этих исключений в продакшене обязательна — без неё потеря соединения в момент сохранения ломает локальный кеш без диагностики.

Архитектура: локальное сохранение (PlayerPrefs или кастомный JSON-файл в Application.persistentDataPath) + облачное как зеркало с version tag. При загрузке — сравниваем updatedAt из метаданных облачного снапшота с локальным timestamp. Если расхождение — инициируем conflict resolution flow.

Достижения

Google Play Games Achievements и Apple Game Center Achievements — разные API, разные ограничения, разная логика unlock. Правильная абстракция: IAchievementService с методами Unlock(achievementId), Increment(achievementId, steps), Report(achievementId, percent) — платформо-специфичная реализация скрыта за интерфейсом.

Важная деталь: incremental achievements в Google Play требуют предварительной настройки totalSteps в Play Console. Если шаги изменились (например, достижение «убей 100 врагов» переделали в «убей 50») — нельзя изменить total steps без сброса всего прогресса у существующих пользователей. Это архитектурное решение, которое нужно принимать до релиза.

Для Game Center на iOS — обработка GKLocalPlayer.localPlayer.authenticateHandler с разветвлением логики под случаи: аутентификация успешна, пользователь отказался, Game Center недоступен. Последний сценарий часто игнорируют — а он случается у пользователей с ограниченными Family Sharing настройками.

Сроки

Стоимость рассчитывается индивидуально после аудита игровой архитектуры и требований к синхронизации прогресса.