Is Any Rigid Body Awake
PrimitiveComponentЧто это
Pure-функция для класса PrimitiveComponent. Возвращает true, если хотя бы одно твердое тело (rigid body) внутри этого компонента находится в пробуждённом (awake) состоянии. Используется для проверки активности физического симуляции компонента.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Выхотоды (данные):
- Target (PrimitiveComponent) — ссылка на проверяемый компонент
Выходы (данные):
- ReturnValue (bool) —
true, если есть активное твердое тело; иначеfalse
Примимание: функция не имеет debug-пинов.
Когда используются
- Для оптимизация скриптов, когда нужно убедиться, что физический объект остановился (заснул) передвыполнением действий (например, телепортация или анимация).
- Для отладки: проверка, симулируется ли объект в данный момент (особенно при смешанных физических/анимационных сценариях).
Типичные проблемы
- Неверное понимание «awake» — функция вернёт
falseдля заснувших (sleeping) тел, даже если у объекта включена симуляция физики. Это нормальное поведение движка, а не ошибка. - Компонент без симуляции (Simulate Physics = false) — возврат всегда
false. Перед вызовом функции нужно проверить, чтоSimulate Physicsвключён, иначе вызов бессмыслен. - Статическая геометрия — на статических (non-simulated) компонентах (например,
UStaticMeshComponentс выключеной физикой) функция корректно вернётfalse, но начинающим это может сбить с толку.