docs: record the real MP4 acoustics check (#96)

Pairs of the same replay exported with acoustics on and off on the
scratch world (no HORIZON_NO_AUDIO): acoustics and capture ownership
both ready. The open field has no reverb send by design, so it shows
occlusion/air absorption only; the stone court's on-track is quieter
and darker, and its residual after a gain fit is low-passed and
stereo-decorrelated, i.e. the wet path. A clean reverb tail/RT60 in a
real MP4, echoes alone and listening remain open. No code changes.

Co-Authored-By: Kimi Code <noreply@moonshot.ai>
This commit is contained in:
2026-11-04 20:50:25 +03:00
parent e6a7000440
commit abf3d76fdb
4 changed files with 45 additions and 2 deletions
+37
View File
@@ -55,6 +55,43 @@ GPL-файлы три: `acoustics/spr_occlusion.rs`, (стадия 2) `acoustics
выстрел 1.5 с на 60 блоках, стена камня в 2 блока: ниже 300 Гц -5.2 дБ (SPR: gain 0.55), 300-1500 -7.4, 1500-5000 -19.7, выше 5000 -40.0 дБ.
Тесты: `cargo test -p horizon-client --lib acoustics` (формулы, неизвестное, щель, кеш, инвалидация, детерминизм, рабочий поток) и `audio`.
### Настоящий MP4 с включённой акустикой (4 ноября, pin `73b9d3070`, API 29)
Пары настоящих экспортов одного и того же повтора, с акустикой и без: кнопка мода «Акустика
(преграды, эхо)», затем тот же `/airdef replay export` (640×360, 30 fps, crf 20), offscreen Metal,
ffmpeg 9.0.1, scratch `HORIZON_HOME`/мир (не сохранения игрока). `HORIZON_ACOUSTICS=1` без
`HORIZON_NO_AUDIO`. В сохранённом мире значение акустики хранится в состоянии мода, поэтому env
задаёт только начальное значение: в проверке её включали и выключали кнопкой.
Статусы в игре во время и после экспорта: `Акустика: API=true, включено=true, запрос=true,
подготовлено=true, ready`; `Захват этого мода: запрос=true, подготовлено=true, ready`. Контроль
`HORIZON_ACOUSTICS=1` + `HORIZON_NO_AUDIO=1`: `включено=true, запрос=true, подготовлено=false,
awaiting-backend` — ожидаемое отсутствие offline-микшера, не замена звуковому MP4.
| Сцена | ON: кадры/с | OFF: кадры/с | RMS ON/OFF | пик ON/OFF | L/R corr ON/OFF | centroid ON/OFF | HF>4k ON/OFF |
|---|---|---|---|---|---|---|---|
| поле, 3 события, `sec=4` | 123/4.100 | 124/4.133 | −23.53/−23.26 | −7.18/−5.60 | 0.675/0.627 | 1089/1382 Гц | 0.071/0.095 |
| поле, 1 событие, весь фильм | 351/11.700 | 352/11.733 | −32.18/−16.19 | −12.41/−2.65 | 0.829/0.963 | 1157/1862 Гц | 0.075/0.138 |
| каменный двор 80×100×30 (стены), весь фильм | 430/14.333 | 430/14.333 | −22.06/−20.09 | −5.97/−5.76 | 0.915/0.985 | 232/652 Гц | 0.005/0.039 |
Все пары — `h264` + AAC 48 кГц stereo, без обрезки звука; файлы `airdef-films/{ac,one,court}_{on,off}.mp4`
в scratch. Уже это показывает, что акустика реально обрабатывает дорожку фильма: в каменном дворе
OFF почти моно (L/R 0.985–1.000), ON декоррелирован (0.915); centroid и доля >4 кГц падают, как и
ожидается от окклюзии/воздушного поглощения; в поле ON тише OFF до 16 дБ по RMS за рельефом.
Реверб/эхо: в каменном дворе отрезок 9–14 с (после склейки) описывается ON ≈ g·OFF, g = −2.03 дБ
(лучшее совмещение −32 сэмпла = 0.67 мс). Остаток −25.18 dBFS при сигнале −17.61 dBFS (на 7.6 дБ
ниже), centroid 546 Гц, доля >4 кГц 0.009, L/R corr 0.495: низкочастотный диффузный
декоррелированный компонент — это wet-путь (реверб/эхо), а не масштаб сухого сигнала. В открытом
поле send реверба равен нулю по построению (`acoustics/room.rs`: `a field has no send`), поэтому
поле показывает только окклюзию/поглощение, а реверб — только в замкнутой геометрии.
Ограничения: чистый хвост/RT60 в настоящем MP4 не выделен — в замкнутом зале ON-дорожка была на
30–40 дБ тише (сильная окклюзия), а в открытом дворе длинный сэмпл взрыва (`blast_big`, 15 с; его
21 Гц тон виден в дорожке) маскирует хвост; камеру в комнате с источником и тишиной после него в
этом проходе получить не удалось. Ранние отражения отдельно не измерены. Субъективного
прослушивания не было; 10-минутный экспорт, Windows/Linux и полный бой не проверялись.
### Стадия 2: эхо (сделано)
Что игрок получает: взрыв в ущелье или между домами отвечает настоящим эхо от тех стен, что там есть, с задержкой по