Toggle Active
ActorComponent
0
Что это
Переключает состояние активности компонента (вкл/выкл). Если компонент активен – деактивирует, если неактивен – активирует. Exec-функция, void.
Пины
Exec-входы:
- execute (exec) — запускает переключение активности.
Exec-выходы:
- then (exec) — выполняется после завершения переключения.
Входы (данные):
- нет (только неявный Target, self-компонент).
Выходы (данные):
- нет (void).
Когда используется
- Когда нужно динамически включать/выключать логику компонента (например, свет, звук, коллизию) без явной установки true/false.
- В UI или игровых событиях для однокнопочного переключения режима (например, включить фонарик/выключить фонарик).
Типичные проблемы
- Отсутствие проверки текущего состояния — после ToggleActive состояние меняется на противоположное, но не всегда очевидно, стало ли оно активным. Если нужно точно знать результат, лучше использовать
IsActive()после вызова. - Путаница с SetActive — ToggleActive не принимает аргументов, в отличие от
SetActive (bool NewActive). Ошибочная подстановка пина bool в ToggleActive приведёт к ошибке компиляции. - Вызов в неподходящий момент — если компонент ещё не инициализирован (например, в BeginPlay), Toggle может дать неожиданный результат, так как начальное состояние может быть неопределённым. Рекомендуется в BeginPlay явно задавать активность через SetActive.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.