aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/sound.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/specs/sound.md')
-rw-r--r--docs/specs/sound.md31
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-тестов (тайминг/громкость/панорама).