Get Attenuation Settings
MovieSceneAudioSectionЧто это
Возвращает настройки затухания (attenuation), заданные для данной аудиосекции в MovieScene. Exec-функция, не pure. Позволяет получить структуру AttenuationSettings из секции, если она была установлена.
Пины
Exec-входы:
- execute (exec) — запуск выполнения
Exec-выходы:
- then (exec) — продолжение после получения данных
Входы (данные):
- Target (MovieScene Audio Section Object Reference) — сама секция аудио, из которой читаются настройки
Выходы (данные):
- Return Value (Boolean) —
true, если настройки затухания заданы и были успешно получены - Attenuation Settings (AttenuationSettings Structure) — структура с параметрами затухания (расстояние, кривая и т.д.)
Когда используется
При необходимости программно прочитать или сверить настройки затухания звука, заданные в конкретной аудиосекции MovieScene. Например, для динамической подстройки громкости в зависимости от расстояния до камеры внутри секвенции.
Типичные проблемы
- Игнорирование Return Value — если функция вернула
false, возвращённая структураAttenuation Settingsможет быть невалидной. Всегда проверяйте булево значение перед использованием данных. - Попытка изменить полученную структуру напрямую — возвращается копия (структура передаётся по значению или по константной ссылке в BP). Изменение копии не повлияет на оригинальные настройки секции.
- Путаница с аттенюацией на уровне трека — настройки затухания могут быть заданы как на Audio Track, так и на Audio Section. Данная функция читает только настройки секции, не трека.