Расширения темы и совместимость
Расширения принадлежат профилю устройства в 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_2m | 2 |
| relative_humidity_2m | 10 |
| pressure_msl | 5 |
| cloud_cover | 20 |
| wind_speed_10m | 3 |
| visibility | 2000 |
| precipitation | 0.5 |
| weather_code | 1 |
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.