Get Hit Result Under Finger
PlayerControllerЧто это
Pure? Нет, exec-функция.
Возвращает результат трассировки луча из позиции нажатия (пальца/мыши) на экране в мир. Используется для обработки ввода на сенсорных экранах или при эмуляции клика мыши. Работает только при наличии активного PlayerController, управляющего экранной точкой касания.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения (выполняется всегда)
Входы (данные):
- Finger Index (Integer) — индекс пальца для мультитач (0 – первый палец/клик)
- Trace Channel (ETraceTypeQuery) — канал трассировки (по умолчанию Visibility)
- bTraceComplex (Boolean) — учитывать сложную геометрию коллизий (по умолчанию false)
Выходы (данные):
- Return Value (Boolean) —
true, если луч задел объект - Hit Result (Hit Result) — детали первого пересечения: точка, нормаль, кость, материал и т.д.
Когда используется
- Обработка нажатия на объекты в 3D-мире (клик по кнопке, выделение юнита).
- Определение точки прицеливания для турели или курсора в игре от первого/третьего лица.
- Реализация drag-and-drop предметов с помощью касания.
Типичные проблемы
- Неправильный Trace Channel — функция не найдёт объект, если его коллизия настроена на другой канал (например,
CameraвместоVisibility). - Игнорирование Return Value — если результат
false, тоHit Resultбудет содержать некорректные данные, что приведёт к ошибкам при попытке доступа кHit.LocationилиHit.Actor. - Забытый Finger Index при мультитач — передача индекса, которого ещё нет на экране, вернёт
false.