Are Any Listeners Within Range
GameplayStaticsЧто это
Pure-функция из библиотеки GameplayStatics. Проверяет, находится ли хотя бы один активный аудиослушатель (Audio Listener) в заданном радиусе от указанной точки. Возвращает true, если слушатель обнаружен, иначе false. Полезна для оптимизации звуковой логики — например, чтобы не запускать звуки, если их никто не услышит.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- WorldContextObject (Object) — контекст мира (обычно self или GameInstance)
- Location (Vector) — центральная точка проверки
- MaxRange (float) — максимальное расстояние от Location, в котором ищутся слушатели
Выходы (данные):
- ReturnValue (bool) —
true, если хотя бы один слушатель находится в радиусе MaxRange от Location
Когда используется
- Оптимизация звуковых событий: не проигрывать звук, если рядом нет слушателя.
- Условное включение/отключение аудио-эмиттеров в больших открытых мирах.
- Триггеры диалогов или кат-сцен, которые должны срабатывать только при наличии игрока (слушателя) поблизости.
Типичные проблемы
- Забытый WorldContextObject — если передать
null, функция не сработает (выдаст warning в логе). - Слишком маленький MaxRange — функция может вернуть
false, даже если слушатель рядом, но чуть дальше указанного радиуса. - Неучтённые несколько слушателей — функция проверяет только наличие хотя бы одного; если нужно точное количество, используйте
GetNumListeners.