docs/specs/sound.md

# Sound system

`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-тестов (тайминг/громкость/панорама).
-												Добавлены спецификации для сетевой подсистемы, системы звука, загрузки ландшафта, интерфейса пользователя и пайплайна выполнения. Обновлен файл навигации mkdocs.yml для включения новых документов.

											
										
										
											2026-02-11 21:12:05 +00:00
+								# Sound system
-												Документирование и обновление спецификаций

- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`.
- Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности.
- Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы.
- Уточнены форматы данных и правила взаимодействия между компонентами системы.

											
										
										
											2026-02-19 11:07:04 +04:00
+								`Sound` — подсистема аудио:
-												Добавлены спецификации для сетевой подсистемы, системы звука, загрузки ландшафта, интерфейса пользователя и пайплайна выполнения. Обновлен файл навигации mkdocs.yml для включения новых документов.

											
										
										
											2026-02-11 21:12:05 +00:00
-												Документирование и обновление спецификаций

- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`.
- Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности.
- Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы.
- Уточнены форматы данных и правила взаимодействия между компонентами системы.

											
										
										
											2026-02-19 11:07:04 +04:00
+								- загрузка и кеширование звуковых ресурсов;
 								- воспроизведение SFX/voice/music;
 								- пространственное позиционирование и микширование.
 								## 1. Архитектурная роль
 . Получает события от gameplay/FX/mission/UI.
 . Резолвит аудиоресурсы через архивные библиотеки.
 . Управляет каналами, приоритетами и жизненным циклом источников звука.
 								## 2. Минимальный runtime-контракт
 . Стабильный выбор источника и fallback при отсутствии ресурса.
 . Детерминированные правила приоритета при переполнении каналов.
 . Согласованная модель пространственного затухания и панорамирования.
 								## 3. Статус покрытия и что осталось до 100%
 								Закрыто:
 								- место аудио-подсистемы в общем runtime-контуре.
 								Осталось:
 . Полная спецификация форматов аудио-ресурсов и lookup-таблиц.
 . Полный контракт 2D/3D микширования и лимитов каналов.
 . Правила взаимодействия с FXID-командами, которые инициируют звук.
 . Набор audio parity-тестов (тайминг/громкость/панорама).