Set Enable Envelope Following
MediaSoundComponentЧто это
Exec-функция компонента MediaSoundComponent. Включает или отключает режим отслеживания огибающей аудиосигнала (Envelope Following). Режим позволяет в реальном времени получать уровень громкости (огибающую) воспроизводимого медиа, что удобно для визуализации звука или анимаций по ритму.
Пины
Exec-входы:
- execute (exec) — запуск изменения режима
Exec-выходы:
- then (exec) — продолжение выполнения после применения настройки
Входы (данные):
- Target (MediaSoundComponent Object Reference) — компонент, для которого устанавливается режим
- Enable Envelope Following (bool) —
true– включить отслеживание огибающей,false– выключить
Выходы (данные):
- нет (void)
Когда используется
- Привязка анимации или визуальных эффектов к громкости воспроизводимого медиа (например, пульсация спрайта, изменение цвета).
- Сбор данных об огибающей через другие функции компонента (
GetEnvelopeValue,GetEnvelopePeaksи т.п.) —SetEnableEnvelopeFollowingнужно вызвать перед началом чтения этих значений.
Типичные проблемы
- Вызов
SetEnableEnvelopeFollowingпосле начала воспроизведения может не дать мгновенного эффекта — включение лучше произвести до вызоваPlayили сразу после, но до первого запроса огибающей. - Путаница с аудиоспектром (
SetEnableAudioSpectrum): огибающая даёт только общий уровень громкости, а не частотный разрез. - Забывают вызывать
SetEnableEnvelopeFollowing(true)при старте и полагаются на дефолтное состояние (обычноfalse), из-за чего функции получения огибающей всегда возвращают 0.