Документация
Docs/ru/reference/audio/delivery.md
Доставка аудиоресурсов
Сгенерированный справочник. Не редактируйте его источник напрямую. Обновите
BuildTools/AudioInterface.json, затем выполнитеpython BuildTools/docs_audio.py --write.
| Индекс | Форматы | Доставка | Декодирование | Воспроизведение | Проверка | Канонический JSON | Руководство |
| Стабильный ID | Правило | Требование | Причина | Источник |
|---|---|---|---|---|
audio.delivery.raw-copy |
Доставка через AudioBaker | Включайте Audio baker в каждый ресурсный пакет, владеющий runtime-аудио: он принимает настроенные входы wav и ogg и записывает проверенный payload Ogg Vorbis. | Аудиоресурсы больше не используют RawCopy: WAV нормализуется и кодируется, а уже нативный Ogg проверяется и копируется без дополнительного прохода с потерями. | Source/Tools/AudioBaker.h, Source/Tools/AudioBaker.cpp |
audio.delivery.client-index |
Клиентский индекс звуков | Вызывайте AudioManager.IndexFiles после появления клиентских ресурсов; он записывает каждый путь, чей суффикс присутствует в Audio.SoundFileExtensions. | Менеджер предоставляет этот каталог путей, сформированный по исходникам, а Game.PlaySound получает точный путь выбранного ресурса и не разрешает понятия или варианты. | Source/Client/AudioManager.cpp |
audio.delivery.effect-identity |
Точный авторский путь как идентификатор | Передавайте в Game.PlaySound и Game.PlayMusic точный путь запечённого ресурса, включая авторское расширение. | AudioBaker сохраняет авторский путь, заменяя байты WAV на Vorbis, а AudioManager читает этот путь напрямую, не меняя регистр и не заменяя расширение. | Source/Tools/AudioBaker.cpp, Source/Client/AudioManager.cpp |
audio.delivery.extension-precedence |
Разделение исходного расширения и payload | Считайте суффикс .wav в запечённых ресурсах идентификатором исходника, а не runtime-кодека: все runtime-байты имеют формат Ogg Vorbis, а исходники .ogg сохраняют расширение .ogg. | Сохранение авторских путей не требует переписывать ссылки проекта, а единый runtime-декодер и единый формат package payload устраняют платформенно-зависимое поведение форматов. | Source/Tools/AudioBaker.h |
audio.delivery.music-path |
Владение путём музыки | Передавайте музыку по точному пути ресурса; в отличие от эффектов, она не разрешается через нормализованный индекс имён звуков. | PlayMusic передаёт указанное имя файла непосредственно в AudioManager.Load. | Source/Client/AudioManager.cpp |