Play Dialogue At Location
GameplayStaticsЧто это
Exec-функция класса GameplayStatics. Воспроизводит реплику диалога (озвучку и субтитры) из указанного DialogueWave в заданной точке 3D-мира с возможностью настройки громкости, высоты тона и затухания. Полезна для кат-сцен, NPC-взаимодействий и проигрывания диалогов у источников звука.
Пины
Exec-входы:
- execute (exec) — запуск воспроизведения
Exec-выходы:
- then (exec) — продолжение выполнения после запуска
Входы (данные):
- WorldContextObject (Object) — контекстный объект (обычно GameInstance или Level Blueprint)
- Dialogue (DialogueWave) — ассет диалога с репликами
- Context (DialogueContext) — контекст диалога (кто говорит, с кем)
- Location (Vector) — позиция в мире, откуда исходит звук
- Rotation (Rotator) — ориентация источника звука
- VolumeMultiplier (float, default=1.0) — множитель громкости
- PitchMultiplier (float, default=1.0) — множитель высоты тона
- StartTime (float, default=0.0) — время начала проигрывания (сек.)
- AttenuationSettings (SoundAttenuation, optional) — настройки пространственного затухания
Выходы (данные):
- нет (void)
Когда используется
- Проигрывание диалогов NPC в определённой точке с учётом расстояния до слушателя (через AttenuationSettings).
- Кат-сцены, где нужно привязать реплику к локации (например, голос из радиоприёмника или закадровая речь).
Типичные проблемы
- Null-ссылка на Dialogue или Context — диалог не начнётся. Убедитесь, что оба ассета заданы и валидны.
- Несовпадение контекста — если в DialogueContext указаны неправильные говорящие (Speakers, Targets), диалог может не воспроизвестись или воспроизвестись с ошибкой.
- Забытый AttenuationSettings — без настроек затухания звук будет слышен на всей карте с одинаковой громкостью, что ломает погружение.