04 · Бессерверные двухпутные облачные сохранения
Превращает одиночную игру в проект с облачной синхронизацией и роумингом между устройствами без создания собственной базы данных.
1. Глобальное управление жизненным циклом (Обязательно)
- Создайте новый пустой
GameObjectв первой загружаемой сцене (назовите егоSaveManager). - Нажмите Add Component →
TelegramCloudSaveManager. - Включите Sync On Start:
- На первом кадре запуска автоматически сопоставляются временные метки локального и облачного сейвов
- При сворачивании в фон измененные данные автоматически отправляются в облако
Нулевой код
С включённым Sync On Start облачные сохранения и загрузки не требуют ни одной строки кода.
2. Привязка к UI без кода
Отображение данных
Добавьте TelegramCloudDataText на текстовое поле с монетами/уровнем:
| Поле | Пример |
|---|---|
| Data Key | GoldCoins |
| Format | Монеты: {value} |
Значение обновляется автоматически при любых изменениях.
Инкремент / изменение данных
Добавьте TelegramCloudDataButton на кнопку завершения уровня или начисления наград:
| Поле | Значение |
|---|---|
| Action Type | AddInt |
| Data Key | GoldCoins |
| Value | 100 |
| Auto Save To Cloud | ✅ Включено |
3. Мгновенная замена кода в C#
В существующих C#-скриптах выполните глобальный поиск и замену:
csharp
// До
PlayerPrefs.SetInt("GoldCoins", value);
PlayerPrefs.GetInt("GoldCoins");
// После
TelegramPlayerPrefs.SetInt("GoldCoins", value);
TelegramPlayerPrefs.GetInt("GoldCoins");Локальное чтение и запись данных мгновенно превращаются в кэширование в памяти с бесплатным хранилищем Telegram и синхронизацией между устройствами.
Справка по демо
Ознакомьтесь с реализацией демо в Packages/com.fasttma.core/Samples/04_CloudSave.