Is Virtualized
AudioComponentЧто это
Pure-функция (не требует exec-пинов). Возвращает true, если данный AudioComponent в данный момент виртуализирован — то есть его звук не воспроизводится (обычно из-за превышения дистанции слышимости или других условий), но компонент продолжает отслеживаться движком. Позволяет проверить, активен ли реально звук или он «заморожен».
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные): нет (pure)
Выходы (данные):
- Return Value (bool) —
true, если компонент виртуализирован,false— если звук воспроизводится.
Когда используется
- Для оптимизации: перед выполнением действий, имеющих смысл только для реально играющего звука (например, смена громкости, позиции), проверяют
IsVirtualized, чтобы пропустить обработку для «спящих» компонентов. - В системах управления звуком: чтобы логировать или визуализировать, какие звуки сейчас активны, а какие виртуализированы.
Типичные проблемы
- Забывают, что виртуализированный компонент всё ещё существует и может быть «разбужен» при изменении условий (например, приближении слушателя). Проверка
IsVirtualized— это мгновенный снимок, а не постоянное состояние. - Путают с
IsPlaying:IsVirtualizedможет бытьtrueдаже еслиIsPlayingтожеtrue(в некоторых конфигурациях виртуализации звук может считаться играющим, но не выводиться). Лучше проверять обе функции для полной картины.