ComputeFloorDistance
CharacterMovementComponentЧто это
Функция компонента движения персонажа (CharacterMovementComponent), выполняющая трассировку (sweep) для определения расстояния до пола под персонажем. Используется для проверки, стоит ли персонаж на земле, и получения детальной информации о поверхности. Это exec-функция (не pure).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (CharacterMovementComponent) — ссылка на компонент движения
- Capsule (CapsuleComponent) — капсула, используемая для трассировки (обычно капсула персонажа)
- Trace Distance (float) — дистанция трассировки вниз
- Sweep Direction (Vector) — направление трассировки (обычно вниз,
(0,0,-1)) - bTestWalkableFloor (bool) — проверять ли поверхность на проходимость (walkable)
- bProjectedTest (bool) — выполнять ли проекционную проверку
Выходы (данные):
- bFloorHit (bool) —
true, если трассировка обнаружила пол - Floor Hit Result (HitResult) — подробная информация о попадании
- Floor Distance (float) — расстояние до пола
- Floor Normal (Vector) — нормаль поверхности пола
- Floor Point (Vector) — точка попадания на полу
- bIsWalkableFloor (bool) — является ли пол проходимым
- bIsValidFloor (bool) — является ли пол валидным для стояния
Когда используется
Для реализации кастомной логики определения земли: системы паркура, двойные прыжки, проверка возможности приземления на поверхность, отладка движения.
Типичные проблемы
- Слишком маленькое значение Trace Distance — персонаж может не обнаруживать пол при быстром падении.
- Неправильное направление Sweep Direction (например, не вниз) — функция не найдёт пол.
- Игнорирование выхода bFloorHit перед использованием остальных данных — если пол не найден, значения других выходов могут быть некорректными.
- Передача чужой капсулы в Capsule — функция будет использовать её вместо капсулы персонажа, что может привести к неожиданным результатам.