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

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

Расширения принадлежат профилю устройства в theme.json. Сборщик не выбирает поведение по имени темы. Контракт темы и состояния остаётся 0.2; существующие слоевые правила и автомат base/life сохраняются. Настройки, рисунки, календарь и правила выбора сцен поставляет тема.

{
  "render": {
    "output_format": "png",
    "activity_clock": {"mode": "timezone", "timezone": "Europe/Moscow"},
    "calendar": {
      "file": "dates/anniversaries.json",
      "timezone": "Europe/Moscow",
      "event_ids": []
    }
  }
}

Это фрагмент профиля, остальные настройки render сохраняются. Все три расширения необязательны. Нет output_format — главный кадр JPEG; нет activity_clock — прежние входы активности; нет calendar — нет календарного эпизода. derived.calendar_active равен 0 при отключённом календаре.

Основной PNG и видео

output_format="png" сохраняет полный RGB-мастер без потерь в dynamic/<theme>/devices/<device>/current.png. JPEG не используется промежуточным источником. image и верхний files[device] описывают PNG: format, размеры, число байт и SHA-256 фактических байтов. Прежний current.jpg сохраняется из того же RGB-мастера и описан отдельным compatibility_image. current-preview.jpg — малое JPEG-превью. В общем JSON files[device].compatibility_image содержит тот же полный JPEG с собственными метаданными. Веб-плеер показывает и проверяет JPEG; скачивание ведёт на исходный PNG. PNG для показа не загружается.

Для desktop_3840x2160 MP4 кодируется из основного PNG или JPEG. video.source_image_sha256 всегда совпадает с основным image.sha256. Параметры прежние: HEVC Main, 8 бит, yuv420p, BT.709 limited, SAR 1:1, 3840×2160, 24 кадра/с, 96 кадров / 4 секунды, faststart, первый ключевой кадр с отметкой 0, без звука. Full HD остаётся изображением. Адрес видео: dynamic/<theme>/devices/desktop_3840x2160/video/<sha256>.mp4.

Ключ переиспользования — SHA-256 основного изображения и ревизия энкодера/параметров; для PNG учитывается преобразование RGB → BT.709. Новая дата публикации сама по себе не требует кодирования. Все готовые медиа размещаются перед JSON, также в publish_root. Ошибка кодирования даёт состояние без video, основной кадр публикуется. Старый MP4 переживает проход замены и удаляется на следующем успешном проходе; текущий MP4 защищён. Это уточнение пользователя заменяет немедленную очистку из раздела 9 контракта Орбиты от 06.11.2026.

Независимая активность

При подключённом activity_clock производятся derived.activity_seed, activity_slot, activity_variant, activity_detail, lighting_slot, visitor_roll, scene_hour. Поля пересчитываются, переданные одноимённые значения не используются. life_slot по-прежнему создаёт прежний автомат.

Seed использует activity-seed-v1: SHA-256 канонического JSON (UTF-8, сортировка ключей, без пробелов, ensure_ascii=false, только конечные числа). Объект содержит version, theme_id, стабильный source_context, часовой пояс источника timezone, местный local_hour (YYYY-MM-DDTHH), utc_offset (±HHMM), weather с восемью значениями floor(value/step) либо null:

Поле weatherШаг
temperature_2m2
relative_humidity_2m10
pressure_msl5
cloud_cover20
wind_speed_10m3
visibility2000
precipitation0.5
weather_code1

Big-endian байты digest: [0:4] & 0x7fffffff → seed; [4:8] % 24 → slot; [8:12] % 24 → variant; [12:16] % 24 → detail; [16:20] % 8 → lighting; [20:24] % 256 → visitor. scene_hour — час inputs.at в activity_clock.timezone.

Номер устройства, секунды, коды игровых/календарных событий и системное время исполнения не входят в seed. Для пространственной темы с новыми входами оба профиля используют единый сохранённый момент внутри часа при прежних фактах источника. Новые погодные или игровые факты обновляют снимок. Камера и геометрия каждого устройства рассчитываются отдельно. Новые обычные сцены станции задаются базовыми правилами темы и не зависят от game.neutral.

Календарь внутри темы

render.calendar.file — произвольный безопасный относительный путь от корня коллекции, а не asset_root. У Орбиты это calendar/space-calendar.json, у другой темы имя и каталог могут быть другими. Общий файл включается в ZIP каждого подключённого устройства. Байты входят в SHA-256 зависимостей; изменение содержимого обновляет импорт даже при прежнем mtime. Часовой обновлятор читает только подготовленный ZIP, без поиска по исходникам, сети и LLM.

Абсолютные пути, .., обратные слеши, URL и symlink запрещены. Предельный размер календаря — 2 MiB. Каталог содержит массив events; у записи обязательны id (уникальный snake_case), month_day (MM-DD), целый reference_year, kind (historical, fictional_date, work_anniversary), priority и weight. Допустимые пары: 100/4, 80/3, 60/2, 40/1. Справочные поля допускаются. Год справочный: вымышленная дата 2063 года активна и до 2063; 29 февраля отсутствует в невисокосном году.

Кандидаты отбираются по дате inputs.at в calendar.timezone и явному event_ids. Пустой список не активирует гостей. active_ids сортируется по (-priority,id); очередь содержит каждый id weight раз; выбранный featured_id = queue[local_hour % len(queue)], либо null. inputs.calendar сохраняет date, timezone, active_ids, featured_id, revision (SHA-256 канонического каталога без собственного поля revision).

Старые calendar.* сначала удаляются. Добавляется только calendar.<featured_id> и derived.calendar_active=1; иначе флаг 0. Игровые и погодные коды сохраняются. Тема сама выбирает подготовленный PNG. Если автор темы предусматривает замещение редкого гостя календарным, соответствующее условие задаётся в правилах самой темы. Сборщик не добавляет, не изменяет и не подразумевает таких условий. Другие зоны, освещение, транспорт и игровые сцены продолжаются независимо. Пустой event_ids в текущем пакете Орбиты остаётся до подготовки исторических рисунков и правил.

Земля

Необязательные поля earth_sphere: cloud_map (RGB equirectangular), clouds (оболочка: height_km=6, opacity=1.2, coverage_exponent=0.78, ambient=0.018, direct=0.982, color_rgb=[246,247,248]) и atmosphere (height_km=80, scale_height_km=8, samples=16, rayleigh_per_km=[0.0058,0.0135,0.0331], color_rgb=[135,180,255], exposure=0.72). Рассчитываются тайлами из сохранённой геометрии; орбита и камера не меняются. Карта художественная, не текущая глобальная погода. Без расширений работает прежний earth_sphere.

Если данные недоступны

СитуацияРезультат
Нет новых настроекПрежняя тема и JPEG
Календарь отсутствует, повреждён или небезопасенПредупреждение, без календарного гостя; остальные слои собираются
Нет карты облаков или она поврежденаПредупреждение, Земля и атмосфера продолжают отрисовку без облаков
Недоступен пространственный режимПрежний слоевой рецепт темы; причина в журнале
Часть погодных чисел отсутствуетПрежнее поведение условий; отсутствующее число не заменяется нулём, seed использует null
Ошибка MP4Основной PNG/JPEG публикуется без video
Нет обязательного рисунка / не получен кадрНовая сборка не фиксируется; последняя успешная публикация сохраняется

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

Веб принимает метаданные обоих форматов и проверяет формат, адрес, размеры метаданных, bytes/SHA-256 выбранного JPEG. PNG остаётся доступен для скачивания. TV 0.5.0 жёстко ожидает JPEG: перед включением PNG на сервере нужен отдельный выпуск клиента с поддержкой PNG и связи видео с основным image.sha256.