Get Components By Tag
ActorЧто это
Pure-функция (без exec-пинов), возвращающая массив компонентов указанного актора, имеющих заданный тег. Позволяет отфильтровать компоненты по классу (опционально). Не изменяет состояние.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Actor) — актор, у которого ищутся компоненты
- Component Class (ActorComponent Class Reference) — класс интересующих компонентов. По умолчанию
ActorComponent(все компоненты). Можно указать конкретный класс, напримерLightComponent - Tag (Name) — строковый тег, заданный через
Component Tagsв редакторе компонента
Выходы (данные):
- Return Value (Array of ActorComponent) — массив найденных компонентов, соответствующих классу
Component Classи тегуTag
> Примечание: Существует перегрузка без пина Component Class — тогда возвращаются все компоненты с заданным тегом, вне зависимости от класса.
Когда используется
- Поиск всех компонентов определённого типа (например,
SpotLight) с тегом"KeyLight"для динамического управления. - Получение коллизионных компонентов (
BoxComponent,SphereComponent) по тегу для проверки пересечений. - Извлечение пользовательских компонентов (наследников
ActorComponent) с заранее согласованным тегом.
Типичные проблемы
- Если забыть указать
Component Class(оставивActorComponent), функция вернёт все компоненты с данным тегом — это может привести к неожиданному поведению, если у актора есть несколько разнотипных компонентов с одинаковым тегом. - Пустой выходной массив при правильных входных данных — скорее всего тег не задан ни одному компоненту. Проверьте поле
Component Tagsв редакторе каждого компонента. - Функция не находит компоненты, если актор ещё не завершил начальную настройку (например, вызывается в конструкторе до инициализации компонентов). Используйте
Event BeginPlayили поздний вызов.