diff options
| author | Valentin Popov <valentin@popov.link> | 2026-02-19 10:07:04 +0300 |
|---|---|---|
| committer | Valentin Popov <valentin@popov.link> | 2026-02-19 10:07:04 +0300 |
| commit | 0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d (patch) | |
| tree | 6398ba4a13d22656af75395db6de2e4f84d6c875 /docs/specs/sound.md | |
| parent | a281ffa32ea615670d369503692f057b2dc60e6f (diff) | |
| download | fparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.tar.xz fparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.zip | |
Документирование и обновление спецификаций
- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`.
- Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности.
- Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы.
- Уточнены форматы данных и правила взаимодействия между компонентами системы.
Diffstat (limited to 'docs/specs/sound.md')
| -rw-r--r-- | docs/specs/sound.md | 31 |
1 files changed, 29 insertions, 2 deletions
diff --git a/docs/specs/sound.md b/docs/specs/sound.md index da2a6ee..360f590 100644 --- a/docs/specs/sound.md +++ b/docs/specs/sound.md @@ -1,5 +1,32 @@ # Sound system -Документ описывает аудиоподсистему: форматы звуковых ресурсов, воспроизведение эффектов и голосов, а также интеграцию со звуковым API. +`Sound` — подсистема аудио: -> Статус: в работе. Спецификация будет дополняться по мере реверс-инжиниринга звуковых модулей движка. +- загрузка и кеширование звуковых ресурсов; +- воспроизведение SFX/voice/music; +- пространственное позиционирование и микширование. + +## 1. Архитектурная роль + +1. Получает события от gameplay/FX/mission/UI. +2. Резолвит аудиоресурсы через архивные библиотеки. +3. Управляет каналами, приоритетами и жизненным циклом источников звука. + +## 2. Минимальный runtime-контракт + +1. Стабильный выбор источника и fallback при отсутствии ресурса. +2. Детерминированные правила приоритета при переполнении каналов. +3. Согласованная модель пространственного затухания и панорамирования. + +## 3. Статус покрытия и что осталось до 100% + +Закрыто: + +- место аудио-подсистемы в общем runtime-контуре. + +Осталось: + +1. Полная спецификация форматов аудио-ресурсов и lookup-таблиц. +2. Полный контракт 2D/3D микширования и лимитов каналов. +3. Правила взаимодействия с FXID-командами, которые инициируют звук. +4. Набор audio parity-тестов (тайминг/громкость/панорама). |
