Звук Voxwing · от записи до боя

1. Путь звука

Каждый звук в игре проходит одну и ту же цепочку. Нажмите на блок — что он делает и где живёт.

Коротко: запись режется по рецепту в сэмпл. Реестр говорит, какой звук играет какие сэмплы и как они следуют за числами игры. Игра сообщает событие («выстрел», «обороты 2100»), ядро ставит голос в пространство и отправляет в канал → шину → мастер.

Где что лежит

2. Словарь

Одно слово — одно значение. Дальше на странице слова только в этих смыслах.

Запись source

Исходный файл из банка: WAV или FLAC, часто стерео, 96 кГц. Лежит только у вас.

Сэмпл sample

Набор коротких файлов id-01.ogg, id-02.ogg… — варианты одного события. Mono, 48 кГц, Opus.

Вариант

Один файл сэмпла. Выстрелы чередуются по вариантам без повтора подряд — очередь не звучит как «пулемётная дробь» из одного файла.

Рецепт recipe

Несколько чисел в реестре: откуда и как резать. Одни числа — побайтно один файл.

Звук sound

То, что игра просит сыграть: engine, mg, hit. Играет один или несколько сэмплов.

Роль

Свой (own) или чужой (enemy): одно событие звучит по-разному. Свой пулемёт — в голове, чужой — из точки в небе.

One-shot · луп · поток

One-shot — голос на событие (выстрел). Луп играет всё время и следует за числами (мотор). Поток — длинный файл (музыка).

Слой layer

Один сэмпл внутри звука со своими кривыми. Мотор — 4 слоя: холостой, low, mid, high.

Терм, кривая

Правило «число игры → множитель»: обороты → громкость слоя, обороты → высота. Громкость слоя — произведение термов.

Канал · шина · мастер

Канал — полоса пульта для группы звуков (guns, own). Каналы сходятся в шину sfx, она и музыка — в мастер.

Уровень

Громкость одного звука в его канале (строка маршрутизации, ⇧F11).

Trim

Поправка громкости одного сэмпла, дБ. Выравнивает новую запись под старую, не трогая файл.

Атака

Начало удара: окно 5 мс громче порога. По атакам режутся выстрелы.

LUFS

Громкость «на слух», а не по пику. Два звука с одинаковым LUFS кажутся одинаково громкими.

3. Кейс: мотор Spitfire XIV вместо Cessna

Шаг 1. Найти запись

Банки — тысячи файлов на десятки гигабайт. Глазами по папкам не ищем: каталог знает слова из имён, папок и метаданных каждого файла.

npm run sound -- catalog scan                   # один раз, ~3 с: индекс 2672 файлов
npm run sound -- catalog search spitfire         # 7 записей
npm run sound -- catalog measure spitfire        # громкость и атаки только у найденных

Шаг 2. Где в записи ровные обороты

Мотор в записи гоняют ступенями: холостой, прогазовка, снова холостой. Для лупа нужен отрезок, где обороты стоят. График — громкость записи по 5 с; полосы — плато, из которых нарезаны лупы.

Как узнать обороты по звуку. У V12 каждый ряд из 6 цилиндров даёт 3 вспышки за оборот вала. Микрофон в кабине ближе к выхлопу одного ряда, поэтому основной тон f0 = обороты / 20. В спектре видно гармоники f0, 2·f0, 3·f0 и боковые полосы вокруг каждой — на половину частоты вала. Две независимые меры сходятся — значит, обороты верные.

Шаг 3. Нарезать лупы

Черновик рецепта пишет команда, плато выбираем сами — в рецепте два числа:

npm run sound -- add "sonniss/…/Spitfire_Mk_XIV_t1_onbrd_…_DPA4061.R.wav" --as engine-low --loop --length 6 --force

"engine-low": {
  "recipe": {
    "source": "sonniss/…/Spitfire_Mk_XIV_…R.wav",
    "channels": 1,
    "loop": { "start": 324.5, "end": 330.5,
              "crossfade": 0.5 },
    "peak": -1,
    "kbps": 64
  }
}

σ — разброс уровня по блокам 100 мс внутри лупа. Чем меньше, тем меньше «качается» луп по кругу.

Шаг 4. Кривые: газ → обороты → слои

Игра сообщает газ и скорость; адаптер считает обороты и нагрузку. Реестр решает, сколько звучит каждый слой и с какой высотой: высота = обороты / recorded. Двигайте газ — слушайте, как слои передают друг другу звук.

Как это записано в реестре — слой engine-low:

{ "sample": "engine-low",
  "gain": [ { "by": "alive", "from": 0, "to": 1 },
            { "code": "engineLevel" },
            { "by": "rpm", "segments": [ { "from": 1150, "to": 1400, "shape": "equalPowerIn" },
                                         { "from": 1400, "to": 1950, "shape": "equalPowerOut" } ] } ],
  "rate": { "follow": "rpm", "recorded": 1241, "clamp": [0.75, 1.58] } }

Пары equalPowerIn/equalPowerOut (синус и косинус) держат сумму мощностей = 1: на переходе громкость не проседает. Все слои следуют за одними оборотами, поэтому в зоне кроссфейда звучат на одной высоте.

Шаг 5. Громкость: trim вместо перекодирования

Новые лупы нормированы по пику (−1 dBFS), а слышим мы LUFS. Чтобы мотор в бою не стал громче или тише, разница уходит в trim сэмпла — в mix.json, файл не трогаем.

Шаг 6. Проверить

npm run sound -- verify engine-idle engine-low engine-mid engine-high   # same as in place ×4
npm run typecheck && npm test                                           # 821 тест

verify заново режет во временную папку и сравнивает с файлами в репозитории: длительность точно, пик ±0.1 дБ. Тест мотора проверяет, что слои, звучащие вместе, никогда не расходятся по высоте.

4. Кейс: пулемёт Warfare Library вместо G36

Шаг 1. Выбрать на слух — в темпе игры

Отдельный выстрел обманывает: важно, как звучит очередь в темпе игры — 13 выстрелов в секунду. Для каждого кандидата собрана очередь из 24 выстрелов по 1/13 с, громкость выровнена.

Проверка на клиппинг. Запись, упёршаяся в 0 dBFS, срезает вершины волны — на слух «рваный» щелчок. Перед выбором меряем: сколько сэмплов на максимуме и flat factor (длина плоских участков).

ffmpeg -i запись.wav -af astats=measure_overall=Peak_count+Flat_factor:measure_perchannel=none -f null -

клиппинг — решение на слух, а не запрет. Но знать о нём нужно до выбора, а не после.

Шаг 2. Нарезка по атакам

npm run sound -- onsets "sonniss/…/warfare_t2_mg_firing_close_projectile_tail_large_field_….wav"
npm run sound -- add "…" --as mg-shot --slices 8 --force

add --slices 8 ищет 8 атак подряд с самыми ровными пиками и режет каждую: за 2 мс до атаки, длина — 92 % шага между атаками, 10 мс затухания в конце.

"recipe": { "source": "sonniss/…/warfare_t2_mg_firing_close_….wav", "channels": 1,
  "starts": [13.778, 13.868, 13.953, 14.043, 14.133, 14.228, 14.313, 14.398],
  "length": 0.082, "fadeOut": 0.01, "peak": -1, "kbps": 96 }

Шаг 3. Хвост очереди

После последнего выстрела поле ещё звучит секунды: эхо и шелест уходящих пуль. Это отдельный сэмпл mg-tail: он стартует с каждым выстрелом с отступом tail.at, а следующий выстрел его гасит. Слышен только после последнего.

Шаг 4. Очередь как в игре

Так играет ядро: вариант без повтора подряд, у каждого выстрела высота ±3 % и громкость ±1.5 дБ (spread), хвост после последнего.

trim одинаковый у выстрела и хвоста — соотношение из записи сохраняется. Хвост стал заметнее на ~10 дБ: так звучит поле. Тише — trim mg-tail в окне «Сэмплы».

5. Сделай сам: замена сэмпла по шагам

Порядок, по которому прошли оба кейса. Каждая команда — из корня репозитория.

1. Записи на местоПоложите банк в assets-src/audio/ или сделайте ссылку — копировать гигабайты не нужно.

   ln -s ~/Downloads/"Sonniss GDC 2019" assets-src/audio/sonniss-gdc-2019
   npm run sound -- catalog scan

2. Найти и измерить кандидатов

   npm run sound -- catalog search machine gun --max 60
   npm run sound -- catalog measure machine gun --max 60

   Слушайте в темпе игры. Проверьте клиппинг (astats, раздел 4).
3. Посмотреть атаки или платоВыстрелы — onsets; луп — ровный по уровню отрезок.

   npm run sound -- onsets "путь/к/записи.wav"

4. Черновик и нарезка

   npm run sound -- add "путь/к/записи.wav" --as mg-shot --slices 8 --force   # выстрелы
   npm run sound -- add "путь/к/записи.wav" --as engine-low --loop --length 6 --force   # луп

   Или мышью: микшер → «Сэмплы» → вкладка «Исходник», маркеры на волне, Save.
5. Поправить числа и перенарезатьВ src/data/sounds.json → samples.<id>.recipe: starts, length, loop, peak.

   npm run sound -- cut mg-shot

6. ОписатьВ samples.<id>: description, sources (банк и файл), cut — словами, как нарезано.
7. Подключить и подстроитьСэмпл в samples звука; у лупа — recorded под обороты записи. Под npm run dev игра подхватывает правку без перезагрузки: в консоли Sound: registry reloaded.
8. СвестиГромкость старого и нового — LUFS; разницу — trim в окне «Сэмплы» (не перекодированием). Уровень звука — ⇧F11. Ctrl+S.
9. Проверить и закоммитить

   npm run sound -- verify mg-shot mg-tail
   npm run typecheck && npm test

   В коммит: файлы public/assets/audio/, sounds.json, sounds.gen.ts, mix.json.

6. Микшер в игре

Сводим прямо в бою: правка слышна сразу, Ctrl+S пишет её в src/data/mix.json.

npm run dev     # затем http://localhost:5173/?duel&demo&mixer

Какую ручку крутить

Несохранённые правки — «● не сохранено» в тулбаре; они же в браузере, вкладку можно закрыть. «К файлу» — отбросить, A/B — сравнить с файлом на слух.

7. Шпаргалка

Подробнее — docs/guide/sound/ в репозитории: README, сэмплы, реестр, микшер, API. Почему всё так — DESIGN.md §11.31.