SetSubmixOutputVolume (linear gain)
SoundSubmix
0
Что это
Устанавливает выходную громкость (линейное усиление) звукового субмикса (SoundSubmix). Используется для динамического изменения громкости целой группы звуков (например, эффектов, музыки, диалогов) во время игры. Тип: exec (не pure).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после установки громкости
Входы (данные):
- Target (SoundSubmix Object Reference) — субмикс, для которого устанавливается громкость (обычно подставляется автоматически, если нода подключена к ссылке на субмикс)
- Volume (float) — выходная громкость в линейном масштабе (1.0 = исходная громкость, 0.5 = вдвое тише, 2.0 = вдвое громче)
Выходы (данные):
- нет (void)
Когда используется
- Плавное затухание музыки или звуков окружения при переходе между локациями.
- Временное приглушение эффектов (например, реверберации) во время диалога.
- Управление громкостью каналов (музыка, SFX, диалоги) через UI-слайдер.
Типичные проблемы
- Отрицательное значение в пине Volume: движок обрезает до 0, но это может быть неочевидно. Передавайте только неотрицательные числа.
- Путаница с линейным и логарифмическим (dB) масштабом: функция ожидает линейное усиление, а не децибелы. Для работы в dB используйте отдельную ноду (если есть).
- Забытый Target: если вход не подключён к конкретному субмиксу, изменений не произойдёт (нода не выдаст ошибку, но громкость не изменится).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.