K2 Get Root Component
ActorЧто это
Pure-функция, возвращающая корневой компонент (Root Component) указанного актора. Корневой компонент — это компонент, который является вершиной иерархии компонентов данного актора (обычно сам актор, если не установлен другой). Не требует exec-соединений, может использоваться как источник данных.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (Actor) — актор, для которого нужно получить корневой компонент
Выходы (данные):
- ReturnValue (ActorComponent) — корневой компонент актора
Когда используется
- Когда нужно получить корневой компонент актора, например, чтобы затем получить его дочерние компоненты, изменить свойства или проверить тип корневого компонента.
- В ситуациях, когда требуется работать с иерархией компонентов, начиная с вершины.
Типичные проблемы
- Путаница с другими способами получения компонентов — функция возвращает именно корневой компонент, а не первый попавшийся или компонент определённого класса. Если нужно найти компонент по классу, следует использовать
GetComponentByClass. - Предположение, что корневой компонент всегда равен самому актору — на самом деле корневой компонент может быть заменён (например, через
SetRootComponent), поэтому полагаться на то, что это всегда сам актор, ошибочно. - Игнорирование возможности
null— хотя у корректно инициализированного актора корневой компонент существует, в некоторых контекстах (например, до завершения конструктора) возвращаемое значение может быть невалидным. Рекомендуется проверять полученный компонент наnullперед использованием.