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

Спецификация динамической темы

Динамические обои — законченные статичные кадры, меняющиеся по данным и событиям. Тема содержит рисунки и JSON-правила. Сервер выбирает слои и собирает изображение для конкретного устройства; приложение получает готовый JPEG и описание сборки.

Состав темы

Коллекция объявляется как type: dynamic. Каждый профиль устройства содержит свои размеры, каталог assets и rules. schema_version: "0.2" включает базовую и бытовую фазы; прежний контракт 0.1 сохраняет свою совместимость.

ЭлементЗначение
assetИдентификатор подготовленного рисунка
layers[].idКанал композиции, а не обязательный отдельный предмет
orderЦелочисленный порядок наложения; меньшие значения ниже
opacityНепрозрачность от 0 до 1
whenТочное условие выбора
phasebase или life; при отсутствии — base

Один слой может содержать несколько предметов и их взаимные перекрытия. Сервер управляет целым слоем. Для разных устройств используются отдельные рисунки в их собственном разрешении. Неуказанный слой пуст; отсутствие входного значения не разрешает подставить случайный объект.

Отдельные рисунки устройства могут показывать собственную сцену или адаптацию общего сюжета. Художественный подход не меняет значение входных кодов. Он выражается в подготовленных рисунках и правилах профиля. Телефонный профиль не обязан повторять настольное число каналов, предметов или вариантов; описанное для одного устройства не становится обязательным для всей коллекции. См. подходы к экранам.

Условия

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

Поддерживаются =, !=, <, <=, >, >=, а также логические комбинации предусмотренной схемой. Отсутствующее числовое значение не участвует как ноль. Базовые правила не используют бытовой час. Конфликтующие правила не разрешаются догадкой о наиболее красивом варианте.

Наложение

Выбранные полноразмерные RGBA накладываются на фон по order. Альфа рисунка и opacity участвуют вместе. Для переднего края чаши, рамы или перил может потребоваться отдельный ближний слой: один объект способен занимать несколько уровней глубины.

Все правила с одинаковыми входами и одинаковым состоянием автомата должны давать одинаковый рецепт. Число возможных кадров определяется сочетаниями совместимых правил. Произведение числа вариантов — лишь верхняя оценка для независимых каналов; исключения, совместные условия и календарные связи уменьшают число достижимых состояний.

Бытовая фаза

Сначала выбирается базовый рецепт без бытовых слоёв. Он сравнивается с предыдущей успешной сборкой этой области темы и устройства. Изменением считаются состав слоёв, исходник, порядок или непрозрачность. Колебание неиспользуемого числового поля само по себе не является сменой изображения.

Условиеderived.life_slot
Первая сборкаnull
Базовый рецепт изменилсяnull, блокировка до конца местного часа
Текущий час уже заблокированnull
База стабильна, час не заблокированМестный час от 0 до 23

Пропущенные сценки не накапливаются. Возвращение базы к старому варианту в заблокированном часу не снимает блокировку. При null бытовые правила не выбираются. Смена бытовой позы не отменяет действующий игровой признак. Полные схемы — в реестре форматов, доставка — в динамическом API.

Точное разрешение каналов

Внутри каждой фазы совпавшие правила не могут выбрать два слоя с одним id. Сначала формируется base. Выбранный life-слой с тем же id целиком заменяет базовый: asset, order и opacity берутся из life; отсутствующая opacity означает 1, а не наследование. В итоговом рецепте order уникален. Коллизия является ошибкой темы, а не основанием выбрать последнее правило.

Базовый ключ учитывает выбранные исходники и их SHA-256, размеры, идентичность слоёв и рендерер. Замена рисунка под прежним именем тоже меняет базу. Область автомата включает тему, устройство, источник, ревизию места/мира и часовой пояс. При смене области прежнее состояние не переносится. Повтор идентичного запроса переиспользует сохранённое решение; устаревший момент не продвигает автомат назад. Состояние фиксируется вместе с успешной сборкой; доставка — отдельный этап.

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

Схемы 0.1/0.2 принимают новые необязательные поля и коды групп. Новые конечные числа доступны обычным условиям group.field; отсутствующие значения дают ложь, включая !=. Неизвестная форма условия или оператор пропускает всё правило, в том числе при неизвестной ветке внутри any. Известные обязательные поля, диапазоны и ограничения фаз продолжают проверяться. Дополнительная астрономия находится в inputs.astronomy, числа — в inputs.astro, признаки — в active. Подробности и космические темы: астрономия и расширения.

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

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