Get Owning Actor
AnimInstanceЧто это
Чистая (pure) функция, возвращающая владельца (Actor) данного экземпляра анимации (AnimInstance). Позволяет из анимационного блюпринта получить ссылку на персонажа или объект, которому принадлежит анимация. Не требует exec-пинов, может использоваться как источник данных в любом месте графа.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (AnimInstance Object Reference) — экземпляр анимации, для которого требуется получить владельца.
Выходы (данные):
- Return Value (Actor Object Reference) — владелец данного AnimInstance. Может быть nullptr, если анимация не привязана к актору (например, в редакторе без превью).
Когда используется
- Получение ссылки на персонажа (Character) или любого другого Actor из анимационного блюпринта.
- Доступ к переменным и компонентам владельца (например, скорость, здоровье, оружие) для управления анимацией.
- Передача данных из анимационного графа в логику персонажа через интерфейсы или касты.
Типичные проблемы
- Null-ссылка при отсутствии владельца — если AnimInstance не привязан к актору (например, в редакторе при просмотре анимации без скелета), возвращается nullptr. Попытка использовать его без проверки приведёт к крашу.
- Каст к неправильному классу — разработчики часто сразу приводят возвращаемый Actor к ожидаемому типу (например, Cast To MyCharacter), не проверяя, что он действительно является экземпляром этого класса. В случае ошибки каст вернёт null, что может остаться незамеченным.
- Использование в конструктивном скрипте (Construction Script) — функция доступна только во время игры (runtime), вызов в Construction Script приведёт к предупреждению или возврату null.