Аркадный зал Школы Империи

Динамический кадр, JSON и архивы

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

Ресурсы

База: https://games.oopssre.ru/assets/arcade/views/. T — ID темы, D — устройство из её каталога.

МатериалПуть
Текущий JPEG по умолчанию / совместимый JPEGdynamic/T/devices/D/current.jpg
Основной PNG при render.output_format=pngdynamic/T/devices/D/current.png
Превьюdynamic/T/devices/D/current-preview.jpg
Текущий JSONdynamic/T/devices/D/current.json
История состоянийdynamic/T/devices/D/states.zip
Исходники устройстваdownloads/theme-T-D.zip

Для «Затонувшей чайной» профиль desktop_3456x2234 использует собственный кадр 3456 × 2234. Другие профили читаются из объявленного каталога; клиент не должен угадывать их наличие по этой строке.

Что содержит JSON

Оболочка текущего кадра описывает тему, устройство, момент, готовое изображение и превью. inputs сохраняет данные выбора, recipe — выбранные слои, asset_sha256 — использованные исходники. Контракт 0.2 добавляет life с решением автомата. image.sha256 относится к готовому основному изображению (JPEG либо PNG), а не к архиву темы. Необязательный compatibility_image описывает отдельный полный JPEG для PNG-темы.

Запись позволяет объяснить, почему выбран кадр, и воспроизвести его при наличии подходящих исходников. Воспроизведение использует сохранённые входы и рецепт; новые часы и свежий прогноз не должны менять прежнюю сцену. Побайтное равенство JPEG дополнительно зависит от объявленной реализации рендерера и JPEG-библиотеки.

История и обновление темы

На сервере хранится один текущий растровый кадр устройства с превью. states.zip содержит JSON-историю, а не накопленный альбом всех JPEG. История группируется по дням и контекстам; её полноту следует определять по фактическому содержимому, а не ожидать по одному кадру на каждый час.

Архив исходников относится к устройству. Тема обновляется под тем же адресом; старые версии рисунков не обязаны сохраняться. Поэтому старый JSON воспроизводим только пока у читателя есть именно использованные исходники. Скачанный ранее архив уже содержит их и не нуждается в обязательных сетевых ссылках на все прежние рисунки.

Поведение клиента

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

См. схемы 0.2 и правила темы.

Совместимые расширения

Необязательный astronomy общего текущего JSON и inputs.astronomy JSON устройства описывают дополнительные небесные данные. Сведения доступны в JSON; дополнительная подпись в интерфейс не добавляется. Получение JPEG не зависит от готовности астрономии. История сохраняет значения и происхождение; воспроизведение не обращается за новыми расчётами. См. астрономический контракт.

Порядок чтения: Оглавление · Назад: Спецификация динамической темы · Далее: Числовые входы: единицы, диапазоны и условия

Необязательные PNG-мастер, независимая активность, календарь темы и облака/атмосфера: расширения 1.0.90.