Get Spectral Data
MediaSoundComponentЧто это
Pure-функция компонента MediaSoundComponent, возвращающая массив спектральных данных (частотных полос) для текущего аудиопотока. Используется для визуализации звука, анализа громкости по частотам или создания аудио-реактивных эффектов.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (MediaSoundComponent Object Reference) — компонент, из которого извлекаются спектральные данные.
_Дополнительные пины не указаны, так как нет полной уверенности в их точных именах и типах (обычно присутствует параметр выбора типа спектра)._
Выходы (данные):
- ReturnValue (Array of MediaSpectralData) — массив структур, каждая из которых содержит частоту (Frequency) и амплитуду (Magnitude) для полосы спектра.
Когда используется
- Визуализация звука (эквалайзер, аудио-реактивные партиклы/материалы).
- Анализ доминирующих частот для геймплейных событий (например, реакция на низкие/высокие частоты).
- Создание аудио-микрофона с обратной связью (если MediaSoundComponent воспроизводит захваченный звук).
Типичные проблемы
- Пустой массив — функция вызывается до того, как MediaPlayer начал воспроизведение или компонент не активен. Спектральные данные доступны только во время активного аудиопотока.
- Неправильный выбор типа спектра — если не указан ожидаемый тип (например, Magnitude вместо Complex), выходные данные могут иметь неожиданный формат (пусто или комплексные числа вместо амплитуд).
- Высокая частота вызова — будучи pure-функцией, её можно поместить в Event Tick или таймер, но частый вызов может снизить производительность (особенно при большом размере FFT). Рекомендуется использовать низкий FPS опроса или буферизировать данные.