Set Sound Class Distance Scale
GameplayStaticsЧто это
Статическая функция exec-типа из UGameplayStatics. Устанавливает масштаб расстояния (Distance Scale) для заданного класса звуков (Sound Class). Влияет на то, как быстро затухает громкость звуков этого класса при удалении от слушателя. Значение 1.0 — поведение по умолчанию, меньше 1.0 — звук громче на расстоянии, больше 1.0 — тише.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- World Context Object (Object) — контекст мира (автоматически подставляется при вызове из Level Blueprint)
- Sound Class (SoundClass Object Reference) — целевой класс звука, для которого меняется масштаб
- Distance Scale (float) — новое значение масштаба расстояния
Выходы (данные):
- нет (void)
Когда используется
- Для динамической регулировки громкости фоновой музыки или диалогов в зависимости от расстояния до камеры.
- Для создания эффекта «приближения» источника звука через изменение Distance Scale отдельных Sound Mix или Sound Class.
Типичные проблемы
- Передача
nullptrв Sound Class — функция не выполнится, возможен лог-вывод ошибки. - Значение
Distance Scale≤ 0 — звук может полностью пропасть или вызвать некорректные математические расчёты в аудиомиксере. - Изменение масштаба для класса, который уже переопределён в звуковом миксе (Sound Mix), — эффект может быть незаметен из-за приоритета микса.