Play Sound At Location
GameplayStaticsЧто это
Воспроизводит звук (Sound Base) в заданной точке мира с возможностью регулировки громкости, высоты тона и времени старта. Результат — компонент Audio Component, который можно сохранить для последующего управления (остановка, изменение параметров). Функция exec (не pure, не latent) — выполнение продолжается сразу после запуска звука.
Пины
Exec-входы:
- Execute (exec) — запуск воспроизведения
Exec-выходы:
- Then (exec) — продолжение выполнения (звук уже запущен)
Входы (данные):
- Sound (Sound Base) — звуковой ассет
- Location (Vector) — позиция источника в мире
- Volume Multiplier (float) — множитель громкости (1.0 = оригинальная)
- Pitch Multiplier (float) — множитель высоты/скорости (1.0 = оригинальная)
- Start Time (float) — время начала проигрывания в секундах (0.0 = с начала)
- Attenuation Settings (Sound Attenuation) — настройки затухания (опционально, можно оставить None)
- Concurrency Settings (Sound Concurrency) — правила конкурентности (опционально)
Выходы (данные):
- ReturnValue (Audio Component) — компонент, управляющий этим звуком (может быть nil, если воспроизведение не удалось)
Когда используется
Для воспроизведения звуков в определённой точке уровня, не привязанных к конкретному актору: выстрелы, взрывы, звуки окружения, озвучка событий в пространстве.
Типичные проблемы
- Не указан Sound — звук не играет (нода не выполнит ничего полезного).
- Обнулён Volume Multiplier — звук будет беззвучным, хотя формально проигрывается.
- Пропущены Attenuation Settings, когда они нужны — звук будет слышен на всей карте (без затухания), что неестественно.
- Location вне игрового пространства — звук не будет слышен, но ошибки не возникнет; сложно отладить.
- Игнорирование ReturnValue — если требуется остановить звук или менять громкость в процессе, компонент нужно сохранить (иначе управление потеряно).