Сохраненные игры

Служба «Сохраненные игры» предоставляет удобный способ сохранять игровой прогресс ваших игроков на серверах Google. Ваша игра может извлекать сохраненные игровые данные, чтобы позволить вернувшимся игрокам продолжить игру с их последней точки сохранения с любого устройства.

Служба сохраненных игр позволяет синхронизировать игровые данные игрока на нескольких устройствах. Например, если у вас есть игра, работающая на Android, вы можете использовать службу «Сохраненные игры», чтобы позволить игроку начать игру на своем телефоне Android, а затем продолжить играть на планшете без потери своего прогресса. Эту услугу также можно использовать для обеспечения того, чтобы игра игрока продолжалась с того места, где она была остановлена, даже если его устройство потеряно, уничтожено или обменяно на более новую модель.

Чтобы узнать, как реализовать сохраненные игры для вашей платформы, см. Реализации клиентов .

Основы сохраненных игр

Сохраненная игра состоит из двух частей:

  • Неструктурированный бинарный блоб — эти данные могут представлять все, что вы выберете, и ваша игра отвечает за их разбор и запись в них.
  • Структурированные метаданные — дополнительные свойства , связанные с двоичными данными, которые позволяют игровым сервисам Google Play визуально представлять сохраненные игры в пользовательском интерфейсе списка сохраненных игр по умолчанию, а также отображать полезную информацию в приложении Google Play Games (например, последнее обновление). метка времени).

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

Изображения на обложке

Служба сохраненных игр предоставляет визуальный пользовательский интерфейс в дополнение к функциям сохранения. Настоятельно рекомендуется связать репрезентативные изображения с соответствующими файлами сохранения. Если вы используете пользовательский интерфейс списка сохраненных игр по умолчанию, предоставленный Play Games SDK в вашей игре, пользовательский интерфейс будет отображать эти обложки. Обложки также могут отображаться в приложении Google Play Games .

Описания

Вы можете предоставить краткое текстовое описание содержания конкретной сохраненной игры. Это описание отображается непосредственно для игроков и должно обобщать состояние, которое представляет сохраненная игра; например, «Борьба с гоблинами в темном лесу».

квота

С разработчиков не взимается плата за сохраненные игровые данные, хранящиеся в облаке. Вместо этого эти данные учитываются в квоте Google Диска игрока — вам не о чем беспокоиться. Единственная квота, о которой должны заботиться разработчики игр, — это их квота API Google Диска.

Изоляция чтения/записи

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

Офлайн-поддержка

Ваша игра по-прежнему может читать и записывать сохраненную игру, когда устройство игрока находится в автономном режиме, но не сможет синхронизироваться с игровыми сервисами Google Play, пока не будет установлено подключение к сети. После повторного подключения игровые сервисы Google Play асинхронно обновляют сохраненные игровые данные на серверах Google.

Решение конфликта

При использовании сервиса «Сохраненные игры» ваша игра может столкнуться с конфликтами при попытке сохранить данные. Эти конфликты могут возникать, когда пользователь запускает более одного экземпляра вашего приложения на разных устройствах или компьютерах. Ваше приложение должно иметь возможность разрешать эти конфликты таким образом, чтобы обеспечить наилучшее взаимодействие с пользователем.

Как правило, конфликты данных возникают, когда экземпляр вашего приложения не может получить доступ к службе «Сохраненные игры» при попытке загрузить данные или сохранить их. Как правило, лучший способ избежать конфликтов данных — всегда загружать последние данные из службы при запуске или возобновлении работы приложения и сохранять данные в службу с разумной частотой. Однако не всегда удается избежать конфликтов данных. Ваше приложение должно приложить все усилия для разрешения конфликтов, чтобы данные ваших пользователей были сохранены и чтобы они имели хороший опыт.

Ограничения

Игровые сервисы Google Play в настоящее время применяют ограничения на размер двоичных данных и охватывают размеры изображений 3 МБ и 800 КБ соответственно.

Сохраненные метаданные игры

Структурированные метаданные сохраненной игры содержат следующие свойства:

Свойство Описание
ИДЕНТИФИКАТОР Уникальная строка, созданная игровыми сервисами Google Play для этой сохраненной игры. Используйте этот идентификатор для ссылки на сохраненную игру в ваших игровых клиентах.
Имя Краткое название сохраненной игры, предоставленное разработчиком, например «Save slot 1» или «PlayerName_Save1». Это не показывается игрокам.
Описание Описание сохраненной игры, предоставленное разработчиком.
Последнее изменение Временная метка в миллисекундах, созданная игровыми сервисами Google Play для последнего обновления сохраненной игры.
Время игры Предоставленное разработчиком время (в миллисекундах) для отображения в сохраненной игре. Это значение должно представлять, как долго игрок играл в соответствующую сохраненную игру. Например, значение игрового времени 3600000 будет отображаться игровыми сервисами Google Play как «1 час».
Изображение обложки Это необязательное свойство, предоставляемое разработчиком, которое содержит информацию об изображении обложки .

Клиентские реализации

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