Set Settings
SubmixEffectSubmixEQPresetЧто это
Pure-функция (не имеет exec-пинов). Устанавливает настройки эквалайзера для SubmixEffectSubmixEQPreset. Используется для конфигурации частотных полос (bands) сабмикса — их количества, типа фильтра, частоты среза, gain и добротности (Q).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (SubmixEffectSubmixEQPreset Object Reference) — пресет, к которому применяются настройки
- Settings (SubmixEffectSubmixEQSettings Structure) — структура с массивом полос эквалайзера (FSubmixEffectEQBand)
Выходы (данные): нет (void)
Когда используется
При динамической настройке эквалайзера сабмикса в runtime — например, для адаптивной фильтрации звука под игровые условия (смена локации, состояние персонажа). Также применяется при инициализации пресета перед его активацией на аудиоэффекте.
Типичные проблемы
- Неправильная структура Settings — забывают заполнить массив Bands или указывают пустой массив, из-за чего эквалайзер не применяется.
- Неверные параметры полос — часто путают тип фильтра (LowPass, HighPass, BandPass, Notch, ParamEQ) или задают частоту среза вне допустимого диапазона (20–20 000 Гц), что приводит к артефактам или отсутствию эффекта.
- Забывают вызвать SetSettings после изменения структуры — структура Settings передаётся по значению, поэтому её нужно заново собирать и передавать в функцию при каждом изменении параметров полос.