Remove Geometry Collection Actor
ChaosDestructionListenerЧто это
Exec-функция класса ChaosDestructionListener. Удаляет указанный Geometry Collection Actor из внутреннего списка отслеживаемых акторов. После удаления события разрушения (damage, breaking, fracturing) для этого актора перестают обрабатываться данным слушателем. Тип — exec.
Пины
Exec-входы:
- execute (exec) — запуск удаления
Exec-выходы:
- then (exec) — выполнение продолжено
Входы (данные):
- Target (ChaosDestructionListener Object Reference) — слушатель, из которого удаляется актор
- Actor (Actor Object Reference) — Geometry Collection Actor, который нужно удалить из списка отслеживаемых
Выходы (данные):
- нет (void)
Когда используется
В динамических сценариях, когда Geometry Collection Actor больше не должен генерировать события разрушения для данного слушателя. Например, при деактивации зоны разрушения, переключении режимов разрушения или удалении самого актора из уровня.
Типичные проблемы
- Передача недействительной ссылки – если в пин
Actorподан пустой (None) или уже уничтоженный актор, возникает ошибка выполнения (Crash) в рантайме. - Удаление актора, не добавленного ранее – функция корректно отработает, но не даст ожидаемого эффекта; стоит предварительно проверять, что актор был добавлен (например, через AddGeometryCollectionActor).
- Удаление во время обработки событий – если удалить актор из слушателя внутри делегата разрушения (Break Event), может возникнуть состояние гонки (race condition); рекомендуется отложить удаление на следующий кадр.