Get Current Active Montage
AnimInstanceЧто это
Pure-функция (без exec-пинов). Возвращает ссылку на текущий активный анимационный монтаж (UAnimMontage*), воспроизводимый на данном AnimInstance. Если ни один монтаж не активен, возвращает nullptr. Используется для проверки состояния монтажей или получения доступа к их свойствам.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (AnimInstance) — экземпляр анимации, у которого нужно получить активный монтаж (обычно self).
Выходы (данные):
- ReturnValue (UAnimMontage Object Reference) — активный монтаж, либо None, если монтаж не воспроизводится.
Когда используется
- Проверка, воспроизводится ли конкретный монтаж в данный момент (сравнение возвращённого объекта с нужным ассетом).
- Получение информации о текущем монтаже (например, его имя, длительность, отсечка) для дальнейшей логики.
- Совместно с другими функциями AnimInstance (например, Get Slot Montage Count) для анализа очереди монтажей.
Типичные проблемы
- Забывают проверить возвращаемое значение на nullptr перед обращением к свойствам монтажа — это приводит к крашу игры.
- Путают с Get Montage Instance (по слоту) — Get Current Active Montage возвращает только один активный монтаж (по умолчанию нативный), а не монтаж в конкретном слоте.
- Считают, что функция возвращает монтаж, который проигрывается на любом слоте — на самом деле она возвращает монтаж, установленный как «active» в системе анимаций (обычно основной слот), что может отличаться от монтажа в кастомных слотах.