Record acoustic fixture results and ship source notices with game bundles (#96 #102)
build / mod (push) Failing after 18s

Co-Authored-By: Codex <noreply@openai.com>
This commit is contained in:
2026-11-02 21:33:59 +03:00
parent 5620347ffe
commit ac866d64a0
8 changed files with 758 additions and 6 deletions
+35 -6
View File
@@ -1,7 +1,7 @@
# Акустика AirDef: разбор Sound Physics Remastered и план переноса (#96, этап 1)
# Акустика AirDef: реализация, проверки и разбор Sound Physics Remastered (#96)
Это результат первого этапа: чтение исходников и план. Кода движка и мода этот этап не меняет. Если код
разойдётся с текстом, прав код.
Сначала приведён текущий статус реализации. Разбор SPR и первоначальный план ниже сохранены как
история решений; формулировки будущего времени в плане не заменяют текущий статус. При расхождении прав код.
- Изучено: https://github.com/henkelmax/sound-physics-remastered, ветка `master`, коммит
`453654ece086f40c97712d9016baa4dee7c4f6d2` (2026-10-29), лицензия GPL-3.0 (`LICENSE`). Клон лежит только в
@@ -151,6 +151,34 @@ GPL-файлы три: `acoustics/spr_occlusion.rs`, (стадия 2) `acoustics
получают относительные звуки (интерфейс, музыка) и звуки дальше 512 блоков; эхо-отводы в шину не идут. `gain_hf` слотов, `density`,
отражения слота SPR не перенесены.
### Повторная проверка на закреплённом движке (2026-11-02)
Движок `209559080` (baseline v0.2.97), macOS arm64/Apple M5. Три ignored export fixtures
действительно выполнены через Acoustics и Mixer, затем проверены `tools/acoustics_check.py`.
Это процедурные тестовые сигналы без аудиоустройства, не субъективное прослушивание игры.
- Два блока камня: изменение энергии ниже 300 Гц **−5.2 dB**, 300–1500 **−7.4 dB**,
1500–5000 **−19.7 dB**, выше 5000 **−40.0 dB**. Проверка spectral wall/open прошла.
- Echo fixture: ущелье **158.9 и 242.1 ms**, комната **39.9 ms**, поле — без отражений.
Задержки совпали с расчётными в допуске **1 ms**.
- Reverb fixture: измеренный RT60 ущелья **0.10 s**, тоннеля **0.87 s**, комнаты **1.39 s**;
в поле хвост не обнаружен. Для тоннеля/комнаты прогноз по sends **0.97/1.67 s**.
Проверка использовала текущий допуск анализатора **35%**, а не целевые 15% из раннего плана.
Экспорт echo и reverb нужно выполнять **в разные каталоги**: оба пишут field.raw/gorge.raw/room.raw,
иначе один эксперимент перезапишет сигналы другого. Пример (из horizon/):
```sh
mkdir -p /tmp/airdef-echo
HORIZON_ACOUSTICS_OUT=/tmp/airdef-echo cargo test -p horizon-client --lib audio::tests::export_echo_tracks -- --ignored
# Из корня AirDef:
python3 tools/acoustics_check.py --echo-dir /tmp/airdef-echo
```
Лицензии/атрибуция включены в `docs/licenses/`; game bundle workflows копируют GPL text,
Horizon MIT notice и THIRD_PARTY_SPR.md в архив рядом с build-identity.json.
## 1. Как SPR идёт от источника к результату
Сигнал: Minecraft вызывает `Channel.play` → `mixin/SourceMixin.play` → `SoundPhysics.onPlaySound` →
@@ -458,9 +486,10 @@ GPL-файлы три: `acoustics/spr_occlusion.rs`, (стадия 2) `acoustics
### Стадия 4 (по #96): движущиеся источники и интеграция с #95/cinema
Пересчёт по интервалам (§3.5), `acoustics=on` ⇒ мод играет близкие варианты (§3.7), категории и слушатель реплея.
Зависит от #95 (постоянные источники): ждать его слияния, `audio.rs` сейчас правит другой агент — не начинать
стадию 1 до него, чтобы не конфликтовать по `Channel`/`mix`.
Постоянные источники #95 реализованы: live и replay объявляют движущиеся engine voices;
мод передаёт их host через sound-sources, listener фильма берётся из его камеры. Общий DSP находится
в движке. Необходимая оставшаяся приёмка — массовый живой бой, прослушивание и настоящий MP4 с
проверкой смены listener/мира и бюджета; наличие общего кода не заменяет эти проверки.
## Что оказалось неверным или неточным в тексте #96