Play
AudioComponent
0
Что это
Функция Play компонента AudioComponent запускает воспроизведение звукового файла (AudioClip) на акторе, к которому прикреплён компонент. Это exec-функция: после вызова звук начинает играть, а выполнение сразу переходит к then. Звук играет в фоне, не блокируя поток.
Пины
Exec-входы:
- execute (exec) — запуск воспроизведения.
Exec-выходы:
- then (exec) — выполнение продолжается сразу после запуска звука.
Входы (данные):
- Sound (AudioClip) — воспроизводимый звук.
- Volume (float) — громкость (1.0 = оригинал).
- Pitch (float) — высота тона (1.0 = оригинал).
- Start Time (float) — время начала в секундах.
- Fade In Time (float) — длительность затухания в начале.
- Fade Out Time (float) — длительность затухания в конце.
- Loop (bool) — зациклить звук.
- Loop Count (int) — количество повторов (0 = бесконечно).
Выходы (данные):
- нет (void).
Когда используется
- Воспроизведение звуков окружения, шагов, выстрелов, диалогов на конкретном акторе.
- Запуск музыки или звуковых эффектов, привязанных к объекту (например, звук двигателя на машине).
Типичные проблемы
- Забытый AudioClip — если не указан Sound, нода не выполнится (выдаст ошибку компиляции).
- Неправильный Loop Count — значение 0 означает бесконечный цикл, что может привести к незапланированному зацикливанию.
- Fade In / Fade Out — если задать отрицательное значение, поведение непредсказуемо; используйте только неотрицательные числа.
- Volume = 0 — звук будет воспроизводиться, но с нулевой громкостью; чтобы остановить звук, используйте Stop.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.