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

Информация о старой версии хранилища Cloud Storage

Cloud Storage V2 позволяет сохранять, синхронизировать и загружать данные между устройствами и установками из приложений Meta Quest. При включении Cloud Storage V2 локальный каталог по умолчанию синхронизируется с облаком при запуске и выходе из приложения для каждого приложения или группы приложений. Вы также можете настроить выборочную синхронизацию файлов или каталогов относительно расположения по умолчанию, указав пути выборочной синхронизации.

В число поддерживаемых Cloud Storage V2 вариантов использования входят:

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

Обмен информацией о прогрессе между устройствами. Пользователи могут синхронизировать данные между устройствами.

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

Cloud Storage V2 заменяет функцию облачного хранения, которая поддерживалась только в приложениях Rift.

This is a Platform SDK feature requiring Data Use Checkup

Чтобы воспользоваться этой или любой другой функцией Platform SDK, пройдите проверку использования данных. Такая проверка позволяет убедиться, что вы соблюдаете правила для разработчиков. Для этого администратор вашей команды должен подтвердить, что вы используете данные пользователей в соответствии с правилами платформы. Пока специалисты по проверке приложений не рассмотрят и не одобрят результаты проверки использования данных, функции платформы будут доступны только для тестовых пользователей.

Примечание. Cloud Storage доступно на устройстве Meta Quest. Не используйте облачные хранилища для хранения персональных данных, позволяющих установить личность.

Краткая справка о Cloud Storage V2

Краткое описание возможностей и требований для Cloud Storage V2:

Разрешения: поскольку по умолчанию используется внешнее хранилище, приложениям для Android, использующим Cloud Storage V2, потребуются разрешения WRITE_EXTERNAL_STORAGE. Подробнее см. в статьях Обзор разрешений⁠ и WRITE_EXTERNAL_STORAGE⁠ в документации по Android.

Примечание. Начиная с версии 19 программного обеспечения Meta Quest, разрешение WRITE_EXTERNAL_STORAGE в Android больше не требуется.

Разрешение конфликтов. Если во время запуска приложения существует конфликт файлов между облаком и локальным устройством, пользователю будет предложено выбрать данные устройства или облака, либо отменить запуск приложения.

Ограничения для пути и имени файла. Чтобы обеспечить совместимость со всеми платформами, необходимо ограничивать длину имени файла 260 символами, а имена файлов — 255 символами.

Типы файлов. В облачном хранилище можно хранить файлы любого типа.

Количество и размер файлов. Для каждого приложения или группы приложений можно синхронизировать 100 файлов размером до 10 МБ каждый.

Выборочная синхронизация. При желании можно указать определенные папки и (или) файлы для синхронизации. Пути к файлам выборочной синхронизации должны начинаться с прямой косой черты и могут содержать символы подстановки (*) в каталоге, имени файла или расширении файла. Другие специальные символы и некоторые имена файлов не допускаются. Подробнее о требованиях см. в разделе Выборочная синхронизация.

Получение местоположения локального хранилища в коде: для получения каталога, в котором хранятся файлы на пользовательском устройстве, используйте метод Platform.CloudStorage2.GetUserDirectoryPath().

Включение сохранения в облако на панели разработчика

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

Войдите в Панель разработчика Meta Horizon⁠.

Выберите приложение.

В левой части навигации выберите Разработка > Облачное хранилище.

На странице Облачное хранилище установите для параметра Включить автоматическое резервное копирование из облака значение Вкл..

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

Обратите внимание: из соображений совместимости платформ не будут синхронизироваться с облаком файлы с именами CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM0, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, LPT0. Подробнее см. в статье Настольный компьютер с ОС Windows — именование файлов⁠.

Выборочная синхронизация

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

Процесс настройки пути

В пункте Выборочная синхронизация нажмите Добавить новый путь.

Примечание. Если вы не видите возможности настроить место синхронизации, убедитесь, что вы сохранили это место после включения Cloud Storage V2.

Введите путь. Путь:

должен начинаться с прямой косой черты;

может содержать один набор символов подстановки (**) в имени каталога;

может содержать несколько символов подстановки (*) для имени и расширения файла;

не должен содержать никаких других специальных символов (\ : ? “ < > | & ), иначе путь будет игнорироваться;

не должен содержать более 260 символов. Ограничение на длину имен файлов: 255 символов.

Например, /scores/*.dat — действительный путь выборочной синхронизации.

Нажмите Отправить.

Изменение или удаление пути выборочной синхронизации

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

На панели разработчика найдите свое приложение или группу приложений и перейдите в раздел Облачное хранилище.

На странице Облачное хранилище в разделе Cloud Storage v2, найдите путь, который нужно изменить, в таблице Выборочная синхронизация.

Нажмите кнопку с многоточием (...) в этой строке и выберите Редактировать или Удалить.

После завершения редактирования пути или для подтверждения удаления нажмите Отправить.

Доступ к местоположению синхронизации устройства в коде

После включения облачного хранилища каталог устройства по умолчанию или выборочные файлы/каталог синхронизации будут автоматически синхронизироваться при запуске или выходе пользователя из приложения.

Чтобы получить место сохранения устройства, вызовите метод Platform.CloudStorage2.GetUserDirectoryPath().

Затем обработайте результат этого вызова с помощью Message_GetString.

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

Правильный выход из приложения

Для корректной синхронизации файлов с облаком необходимо правильно выйти из приложения. Если вы разрабатываете мобильные приложения Meta Quest с помощью Unity, то для выхода из приложения обязательно используйте метод OVRManager.PlatformUIConfirmQuit.

Тестирование Cloud Storage V2

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