Параметры: громкость и сетка карты

Подготовлено 2026-10-28 после публикации 0.9.0. Публикация и браузерная проверка этого изменения выполняются интегратором отдельно; агент не пересобирал общий dist и не размещал изменения.

Пользовательское поведение

В шапке остаётся кнопка «Параметры». Прежний переключатель звука и кнопка сетки перенесены в бумажное модальное окно; ссылка «Ход разработки» убирается из шапки отдельной правкой интегратора. Окно содержит два независимых ползунка 0–100% с числовыми подписями, чекбокс сетки и крестик справа сверху. Оно не запрещено на ходу ИИ; клавиши ползунков не доходят до управления юнитами.

Громкость звуков управляет единственным master gain существующего Web Audio проигрывателя. Громкость музыки меняет HTMLAudio.volume одного уже созданного проигрывателя. Значение применяется сразу; изменение положительной громкости не создаёт другой AudioContext, не меняет src и не сбрасывает позицию музыки. Исходная относительная громкость отдельного эффекта/события сохраняется и не умножается на пользовательский уровень повторно. Шкала линейная; совпадение с кривой громкости Windows-оригинала не заявляется.

0% отключает только соответствующий канал. Музыка ставится на паузу; последующее включение жестом продолжает ту же запись. Эффекты останавливаются и контекст приостанавливается; уже завершённые эффекты не повторяются при включении. Ненулевые эффекты и музыка могут использоваться по отдельности.

Настройки хранятся в браузере отдельно от партии, не меняют ядро, команды, RNG и экспорт/импорт сохранения. Сетка применяется и после перезагрузки. Ctrl+G по-прежнему вызывает .click() того же чекбокса, даже когда окно закрыто; его change обрабатывает исключительно сетку и сохранение. Владелец отрисовки карты больше не привязывает обработчик к прежней кнопке.

Хранение и миграция

civilization-audio-preferences содержит {schemaVersion:1,effects:27,music:9}. Уровни представлены целыми процентами. Конечные числовые значения 0–100 округляются, неправильное поле, строка, null, отрицательное или превышающее 100 значение становится 0 независимо от второго поля. Повреждённый JSON/неизвестная схема дают 0/0. Отказ localStorage не прерывает работу текущей страницы.

Если нового ключа ещё нет, прежнее civilization-sound-enabled=true переводится в 35% звуков / 12% музыки, то есть прежние реальные уровни обоих master-каналов. Выключенное/отсутствующее/неправильное прежнее предпочтение даёт 0% / 0%. Новый формат сохраняется отдельно; старый ключ не удаляется и не переписывается. После миграции именно новый ключ определяет поведение. Сетка использует отдельный civilization-map-grid; только точная строка true включает её.

Даже сохранённый ненулевой уровень не создаёт Audio/AudioContext и не запускает проигрывание до нового pointerdown/keydown. Настоящий input ползунка активирует свой канал непосредственно в том же жесте; это покрывает переход 0→положительное, когда capture pointerdown ещё видел старый нулевой уровень. Программный input/setAudioVolume меняет/сохраняет уровень, но не вызывает play/resume. Программный клик сетки не используется как аудиожест.

Для обоих каналов закрыта гонка pending play/resume → 0 → программное положительное значение: поздний результат старого запроса не отменяет выключение и не возобновляет звук без следующего разрешённого жеста. Музыкальные ошибки, ленивые MP3 и autoplay rejection обрабатываются прежним проигрывателем.

Области реализации и проверка

media/audio-preferences.mjs отвечает за формат и валидацию; runtime/resources.mjs — применение, сохранение и активацию; ui/preferences.mjs/preferences.css — окно/ползунки/сетку. media/audio-player.mjs и background-music.mjs изменяют только громкость/жизненный цикл проигрывателей. Правки общего app/index/hud/atlants передаются интегратору патчем; исходные версии и схема партии агентом не повышаются.

Изолированно прошли 11 проверок tests/audio-preferences.test.mjs: миграция, независимая валидация и хранилище, единственный master gain, отсутствие повторного умножения событий, один контекст, обе гонки громкости, независимые ресурсы/жесты, UI и сетка. Прежние семь проверок музыкального проигрывателя также прошли. Команды:

python3 scripts/run-limited.py -- node tests/audio-preferences.test.mjs
python3 scripts/run-limited.py -- node tests/background-music.test.mjs

Браузерные драйверы подготовлены, но агент их не запускал. browser-preferences.cjs проверяет видимые настройки, настоящий trusted 0→positive, программное изменение без autoplay, число AudioContext, live gain, сохранность текущей музыки, оба независимых mute, сохранение уровней/сетки после reload, Ctrl+G, неизменность игры/PRNG настройками, узкое окно 390px и настоящий эффект конца хода при выключенной музыке. browser-native-music.cjs адаптирован к ползунку музыки, сохранив проверки исходного ICO/MP3, ленивой загрузки, времени и повторной активации после reload. Отчёты: data/browser-preferences-verification.json, data/browser-native-music-verification.json.

python3 scripts/run-limited.py -- node tests/browser-preferences.cjs
python3 scripts/run-limited.py -- node tests/browser-native-music.cjs

Для публичного сайта используется CIV3_BROWSER_URL=https://vm.ya-erm.ru/civilization/. Прежние browser-media/interturn-performance/golden-age/visual-feedback переключены на ползунок эффектов через tests/helpers/preferences-controls.cjs, classic-controls проверяет .checked сетки. Общие сборка, DOM, полный прогон и отметки в пользовательских заметках выполняются интегратором после freeze.

Публичная интеграцияv0.10.0

Опубликовано28.10.2026 в05:13 МСК, кодf1d04cdd4cd1b1be. Сценарий реально выполнен вChromium локально и на основном HTTPS-сайте. Текущий отчёт. Общая сверка146 файлов кода/данных/ресурсов не нашла расхождений; независимые служебные страницы сохранены. Полный Windows-оригинал этими проверками не объявлен воспроизведённым.