Analyze Audio
AudioAnalyzerNRTЧто это
Функция Analyze Audio класса AudioAnalyzerNRT (Non-Real-Time) — exec-функция для запуска анализа аудиофайла. Используется для извлечения метаданных (например, громкости, спектра) из заранее загруженного звукового ассета. Работает не в реальном времени, а по завершении загрузки и обработки.
Пины
Exec-входы:
- execute (exec) — запуск анализа
Exec-выходы:
- then (exec) — продолжение выполнения после завершения анализа
Входы (данные):
- Target (AudioAnalyzerNRT Object Reference) — объект анализатора, который будет выполнять анализ
- Audio To Analyze (Sound Wave Object Reference) — звуковой ассет для анализа
Выходы (данные):
- Return Value (Boolean) — true, если анализ успешно завершён; false — если произошла ошибка (например, неверный формат аудио)
Когда используется
- Для извлечения данных о громкости, спектре или других характеристик из звукового файла перед его использованием в игре (например, для автоматической настройки громкости или визуализации).
- В редакторе или при загрузке уровней, когда анализ не требует реального времени.
Типичные проблемы
- Неверный тип аудиоассета: функция ожидает
Sound Wave, а неSound Cueили другой тип. Если передать неподдерживаемый тип, анализ не выполнится. - Анализ до загрузки аудио: если
Audio To Analyzeне загружен или не готов, функция вернётfalse. Убедитесь, что ассет полностью загружен перед вызовом. - Игнорирование возвращаемого значения: функция возвращает
Boolean, но его часто не проверяют. Если анализ не удался, последующие операции с результатами (например, чтение спектра) приведут к ошибкам.