Get Normalized Spectral Data
MediaSoundComponent
0
Что это
Pure-функция компонента MediaSoundComponent. Возвращает массив нормализованных спектральных данных (амплитуды в диапазоне 0–1) для текущего аудиопотока. Используется для визуализации частотного спектра в реальном времени.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (MediaSoundComponent Object Reference) — компонент, из которого извлекаются спектральные данные.
Выходы (данные):
- ReturnValue (Array of Media Sound Spectral Data) — массив нормализованных спектральных данных (каждый элемент содержит частоту и нормализованную амплитуду).
Когда используется
- Визуализация аудиоспектра (эквалайзер, «танцующие» полосы).
- Реакция игровых объектов на громкость определённых частот.
- Анализ аудиопотока для процедурной генерации.
Типичные проблемы
- Отсутствие предварительной настройки FFT — перед вызовом функции необходимо задать размер окна FFT через
SetSpectralAnalysisSettings, иначе спектральные данные могут быть невалидными или отличаться от ожидаемых. - Вызов до начала воспроизведения — если MediaPlayer не активен или аудиопоток не поступает, функция вернёт пустой массив или нулевые значения.
- Путаница с ненормализованной версией —
GetSpectralDataвозвращает сырые амплитуды, аGetNormalizedSpectralData— значения, приведённые к диапазону 0–1. Использование не той функции ломает визуализацию.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.