尧图网页设计 
简介这份资源面向使用UE4/UE5开发触屏交互的开发者聚焦触摸屏上的移动、旋转与缩放事件处理适合具备一定蓝图或C基础、希望在移动端与多触点设备上实现直观操控的中高级学习者。包内共349个文件以288个uasset资产、6个umap关卡、34个ini配置及少量png、bin、json、log、ush等辅助文件为主压缩包约610.21MB可直接导入引擎对照研究。内容围绕FTouchEvent的TouchDown、TouchMove、TouchUp三类事件展开涵盖UUserWidget重写BeginTouchDown/BeginTouchMove/EndTouchUp、AddTouchHandler注册以及UE5蓝图TouchEvent节点与WorldContextObject统一输入处理多点触控部分讲解双指中心点平移、夹角变化旋转、距离比例缩放并涉及TouchInputComponent的AddTouch/RemoveTouch与GetPinchZoomDelta等节点附带防抖动与输入刷新率优化思路。已有6432人学习下载可帮助读者快速搭建触控实验工程、理解事件分发链路并复用现成资产结构。1. 触摸屏上的 UE 交互为什么你的移动旋转缩放总在真机上翻车在 PC 上用鼠标拖拽 Actor 一切正常打包到触摸屏一体机或 Android 平板后单指移动变成了乱飞双指缩放要么没反应要么跳变——这是 UE4/UE5 触摸屏事件处理最典型的翻车现场。核心问题在于鼠标事件是单点、绝对坐标、带按键状态的输入模型而触摸事件是多点、相对位移、无按键的输入模型两者在 UE 的输入映射体系里走的是完全不同的管线。这个资源包围绕 UE4 和 UE5 两个版本拆解了触摸屏上移动、旋转、缩放三类手势事件的完整实现方案包含蓝图和 C 两条路线。适合正在做展厅大屏、工业触控面板、教育一体机这类触摸交互项目的开发者尤其是从 PC 端移植到触摸端时被输入映射坑过的人。2. 触摸事件与鼠标事件的底层差异为什么不能直接复用2.1 输入映射体系里触摸事件走的是哪条路UE 的输入系统分三层硬件层产生平台输入事件FPointerEvent、FTouchEvent引擎层通过 PlayerController 和 InputComponent 分发项目层通过 InputAction 和 InputAxis 绑定到具体逻辑。鼠标走的是 FPointerEvent触摸走的是 FTouchEvent两者在 FSlateApplication 层面被统一处理但在 PlayerController 的 InputKey 回调里触摸事件的 Key 是 EKeys::Touch1 到 EKeys::Touch10而鼠标是 EKeys::LeftMouseButton。这意味着你在 Project Settings → Input 里绑定的鼠标轴映射在触摸屏上根本不会触发。常见做法是在 PlayerController 里重写 InputTouch 事件或者用 Enhanced Input 系统里的 Touch 触发器。UE5 的 Enhanced Input 对触摸的支持比 UE4 的旧输入系统好一些但依然需要手动处理多指索引。触摸事件的关键参数有三个Handle手指索引从 0 开始、TouchLocation屏幕坐标、Force压力值大部分触摸屏不提供。移动和旋转依赖 TouchLocation 的帧间差值缩放依赖两个手指 TouchLocation 之间的距离变化率。2.2 单指移动与旋转的事件分发逻辑单指操作要同时支持移动和旋转必须做手势判定。常见做法是手指按下后记录起始位置在移动过程中计算位移向量如果位移方向以水平为主则判定为移动以垂直为主则判定为旋转。但这个判定在实操中很容易抖动更稳的方案是用时间窗口做二次确认——手指移动超过 10 像素且持续超过 0.1 秒才触发手势判定。在蓝图里的实现路径是在 PlayerController 的 InputTouch 事件里根据 TouchIndex 分支处理。TouchIndex 为 0 时记录第一指位置为 1 时记录第二指位置。移动逻辑用第一指的 DeltaLocation 驱动 Actor 的 AddActorWorldOffset旋转逻辑用第一指的 DeltaX 驱动 Actor 的 AddActorLocalRotation。C 路线需要在 PlayerController 子类里重写 InputTouch 函数// MyPlayerController.h virtual bool InputTouch(uint32 Handle, ETouchType::Type Type, const FVector2D TouchLocation, float Force, FDateTime DeviceTimestamp, uint32 TouchpadIndex) override; // MyPlayerController.cpp bool AMyPlayerController::InputTouch(uint32 Handle, ETouchType::Type Type, const FVector2D TouchLocation, float Force, FDateTime DeviceTimestamp, uint32 TouchpadIndex) { // Handle 0 是第一根手指Handle 1 是第二根 if (Handle 0) { if (Type ETouchType::Began) { // 记录起始位置用于后续计算 Delta TouchStartLocation TouchLocation; bIsTouching true; } else if (Type ETouchType::Moved bIsTouching) { // 计算帧间位移 FVector2D Delta TouchLocation - TouchStartLocation; // 水平位移驱动移动垂直位移驱动旋转 if (FMath::Abs(Delta.X) FMath::Abs(Delta.Y)) { // 移动逻辑将屏幕位移映射到世界空间 FVector WorldOffset FVector(Delta.X * MoveSpeed, Delta.Y * MoveSpeed, 0.0f); GetPawn()-AddActorWorldOffset(WorldOffset); } else { // 旋转逻辑垂直位移映射到 Yaw 旋转 FRotator DeltaRotation(0.0f, Delta.Y * RotateSpeed, 0.0f); GetPawn()-AddActorLocalRotation(DeltaRotation); } // 更新起始位置实现增量式移动 TouchStartLocation TouchLocation; } else if (Type ETouchType::Ended) { bIsTouching false; } } return Super::InputTouch(Handle, Type, TouchLocation, Force, DeviceTimestamp, TouchpadIndex); }这段代码的核心逻辑是用 TouchStartLocation 记录上一帧的手指位置每帧计算 Delta 后立即更新起始位置这样每次移动都是增量式的不会因为手指移动过快导致跳变。MoveSpeed 和 RotateSpeed 是两个可调参数前者控制移动灵敏度后者控制旋转灵敏度建议初始值分别设为 1.0 和 0.5再根据实际屏幕尺寸微调。2.3 双指缩放的距离计算与防抖处理双指缩放的核心是计算两个触摸点之间的距离变化。在 InputTouch 里当 Handle 为 0 和 1 都有有效位置时计算两指距离// 在 InputTouch 中处理双指缩放 if (Handle 0 || Handle 1) { // 存储两根手指的当前位置 TouchPositions[Handle] TouchLocation; // 当两根手指都有位置时计算缩放 if (TouchPositions.Contains(0) TouchPositions.Contains(1)) { float CurrentDistance FVector2D::Distance(TouchPositions[0], TouchPositions[1]); if (Type ETouchType::Began) { // 记录初始距离 LastPinchDistance CurrentDistance; } else if (Type ETouchType::Moved) { // 计算缩放比例 float ScaleDelta CurrentDistance / LastPinchDistance; // 防抖缩放比例变化超过阈值才触发 if (FMath::Abs(ScaleDelta - 1.0f) 0.01f) { // 将缩放应用到 Actor 的 Scale 上 FVector CurrentScale GetPawn()-GetActorScale3D(); FVector NewScale CurrentScale * ScaleDelta; // 限制缩放范围防止缩放到 0 或无限大 NewScale NewScale.GetClampedToSize(0.1f, 10.0f); GetPawn()-SetActorScale3D(NewScale); // 更新上次距离 LastPinchDistance CurrentDistance; } } } }这里的关键参数是防抖阈值 0.01f它决定了缩放的最小响应粒度。阈值太小会导致缩放抖动太大则手感迟钝。另一个关键点是缩放范围限制GetClampedToSize 把缩放限制在 0.1 到 10 倍之间防止用户把物体缩到看不见或者撑爆场景。注意UE4 的旧输入系统里触摸事件的 TouchLocation 是屏幕绝对坐标单位是像素。如果你的项目用了 DPI Scaling需要先除以 DPI Scale 再计算否则在不同分辨率的设备上灵敏度会不一致。3. 蓝图与 C 两条实现路线的选型与落地3.1 蓝图实现快速原型与参数暴露蓝图路线的优势是迭代快、参数可视化。在 PlayerController 蓝图里InputTouch 事件节点会提供 Handle、TouchType、TouchLocation 三个输出引脚。用 Switch on Int 节点根据 Handle 分支再用 Branch 节点判断 TouchType 是 Pressed、Moved 还是 Released。移动逻辑用 Get Actor Location → Add Actor World Offset 节点链旋转用 Add Actor Local Rotation缩放用 Set Actor Scale 3D。所有速度参数提升为变量并勾选 Instance Editable这样在关卡里选中 PlayerController 就能直接调参不用每次改蓝图重新编译。蓝图路线的坑在于InputTouch 事件在 PlayerController 里默认不启用需要在 Class Defaults 里勾选 Enable Touch Input。另外如果项目用了 Enhanced Input 插件InputTouch 事件会被拦截需要在 Enhanced Input 的 Mapping Context 里显式添加 Touch 相关的 Input Action。3.2 C 实现性能敏感场景的必选项C 路线的优势是性能可控、逻辑可复用。把触摸逻辑封装成一个 UActorComponent挂载到需要交互的 Actor 上这样多个物体可以共享同一套手势逻辑不用每个 Actor 都写一遍。// TouchInteractionComponent.h UCLASS(ClassGroup(Custom), meta(BlueprintSpawnableComponent)) class MYPROJECT_API UTouchInteractionComponent : public UActorComponent { GENERATED_BODY() public: UTouchInteractionComponent(); UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float MoveSpeed 1.0f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float RotateSpeed 0.5f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float MinScale 0.1f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float MaxScale 10.0f; void HandleTouch(uint32 Handle, ETouchType::Type Type, const FVector2D Location); private: TMapuint32, FVector2D TouchPositions; float LastPinchDistance 0.0f; bool bIsPinching false; };这个组件把移动、旋转、缩放三个功能的参数全部暴露到编辑器MoveSpeed 控制移动灵敏度RotateSpeed 控制旋转灵敏度MinScale 和 MaxScale 控制缩放边界。HandleTouch 函数内部根据 Handle 和 Type 分发逻辑和前面 PlayerController 里的实现一致但封装成组件后可以在任意 Actor 上复用。3.3 触摸事件与鼠标事件的兼容处理很多项目需要同时支持触摸屏和鼠标操作比如展厅设备平时用触摸调试时接鼠标。兼容方案是在 InputTouch 里判断当前是否有触摸输入如果有则忽略鼠标事件反之亦然。// 在 PlayerController 里做输入源判定 bool AMyPlayerController::InputTouch(...) { bUsingTouch true; // 触摸逻辑 return true; } bool AMyPlayerController::InputKey(FKey Key, EInputEvent EventType, float AmountDepressed, bool bGamepad) { if (bUsingTouch Key EKeys::LeftMouseButton) { // 触摸激活时忽略鼠标左键 return false; } return Super::InputKey(Key, EventType, AmountDepressed, bGamepad); }这个判定的逻辑是一旦检测到触摸输入就设置 bUsingTouch 标志后续的鼠标左键事件被拦截。反过来如果一段时间内没有触摸输入bUsingTouch 复位鼠标事件恢复。这个超时时间建议设为 2 秒避免触摸和鼠标频繁切换时误判。提示UE5 的 Enhanced Input 系统里可以用 Input Action 的 Trigger 类型来区分输入源。Touch 触发器只响应触摸事件Mouse 触发器只响应鼠标事件两者可以绑定到同一个 Input Action 上由引擎自动分发。4. 避坑与排查触摸交互项目里最常见的五个翻车点4.1 打包后触摸完全无响应现象编辑器里 Simulate 触摸正常打包到 Android 或 Windows 触摸一体机后手指点击没有任何反应。原因最常见的是 Project Settings → Input → Mobile 里的 Always Show Touch Interface 没勾选或者 Default Touch Interface 被设成了 None。另一个原因是 PlayerController 的 bShowMouseCursor 在触摸设备上默认为 false但某些平台需要显式启用触摸输入。解决在 Project Settings → Input → Mobile 里勾选 Always Show Touch Interface把 Default Touch Interface 设为 DefaultVirtualJoysticks 或自定义的 Touch Interface。同时在 PlayerController 的 BeginPlay 里加一行bEnableTouchEvents true;确保触摸事件被激活。4.2 双指缩放时物体跳变现象两根手指开始缩放时物体瞬间放大或缩小一大截然后才跟随手指正常缩放。原因LastPinchDistance 在第二根手指按下的瞬间没有正确初始化。如果第二根手指按下时 LastPinchDistance 还是 0 或者上一轮缩放结束时的旧值第一帧计算出的 ScaleDelta 就会异常大。解决在第二根手指的 TouchType 为 Began 时立即计算并存储当前两指距离作为 LastPinchDistance并且跳过这一帧的缩放计算。代码里加一个 bIsPinching 标志只有两根手指都处于 Moved 状态时才执行缩放逻辑。4.3 旋转方向与手指移动方向相反现象手指向上滑动物体却向下旋转手指向左滑动物体向右旋转。原因屏幕坐标系的 Y 轴方向与世界坐标系的 Yaw 旋转方向不一致。屏幕坐标 Y 轴向下为正而 UE 世界坐标里 Yaw 正方向是顺时针从上往下看两者叠加后方向反转。解决在计算旋转量时对 Delta.Y 取反即DeltaRotation.Yaw -Delta.Y * RotateSpeed。或者直接在项目设置里把触摸的 Y 轴反转但推荐在代码里处理因为不同平台的屏幕坐标系可能不同。4.4 多点触摸时手指索引错乱现象三根手指同时操作时移动和缩放逻辑互相干扰物体乱飞。原因UE 的触摸事件里Handle 是手指的索引但这个索引在手指抬起后会被回收。如果同时有三根手指Handle 0、1、2 分别对应三根手指但手指 0 抬起后原来手指 1 的 Handle 可能变成 0导致逻辑错位。解决不要依赖 Handle 的固定值来判断手指角色。用 TMap 存储每个 Handle 的起始位置和状态在 TouchType 为 Ended 时从 Map 里移除对应的 Handle。缩放逻辑只取 Map 里前两个有效 Handle 的距离不假设 Handle 0 和 1 一定是缩放手指。4.5 触摸移动速度在不同分辨率设备上不一致现象在 1080P 触摸屏上调好的移动速度换到 4K 触摸屏上变得飞快。原因TouchLocation 的单位是屏幕像素4K 屏幕的像素密度是 1080P 的两倍同样的手指滑动距离产生的像素差值也是两倍。解决在计算 Delta 之前先把 TouchLocation 除以屏幕的 DPI Scale。UE 里可以用GetWorld()-GetGameViewport()-GetDPIScale()获取当前 DPI 缩放系数或者用FSlateApplication::Get().GetApplicationScale()。把归一化后的 Delta 再乘以 MoveSpeed这样在不同分辨率下手感一致。5. 进阶技巧用 Enhanced Input 重构触摸手势系统UE5 的 Enhanced Input 系统给触摸交互带来了更干净的架构。核心思路是把移动、旋转、缩放分别定义为三个 Input Action用不同的 Trigger 来区分手势类型。移动用 Axis2D 类型的 Input Action绑定 Touch 的 Moved 事件输出值是归一化的屏幕位移。旋转用 Axis1D 类型只取垂直方向的位移分量。缩放用 Axis1D 类型输出值是两指距离的变化率。// 在 PlayerController 的 SetupInputComponent 里绑定 Enhanced Input void AMyPlayerController::SetupInputComponent() { Super::SetupInputComponent(); if (UEnhancedInputComponent* EIC CastUEnhancedInputComponent(InputComponent)) { // 移动Axis2D绑定到 MoveAction EIC-BindAction(MoveAction, ETriggerEvent::Triggered, this, AMyPlayerController::HandleMove); // 旋转Axis1D绑定到 RotateAction EIC-BindAction(RotateAction, ETriggerEvent::Triggered, this, AMyPlayerController::HandleRotate); // 缩放Axis1D绑定到 PinchAction EIC-BindAction(PinchAction, ETriggerEvent::Triggered, this, AMyPlayerController::HandlePinch); } } void AMyPlayerController::HandleMove(const FInputActionValue Value) { FVector2D MoveValue Value.GetFVector2D(); // MoveValue 已经是归一化后的值直接映射到世界空间 FVector WorldOffset FVector(MoveValue.X * MoveSpeed, MoveValue.Y * MoveSpeed, 0.0f); GetPawn()-AddActorWorldOffset(WorldOffset); } void AMyPlayerController::HandlePinch(const FInputActionValue Value) { float PinchValue Value.Getfloat(); // PinchValue 是两指距离的变化率1.0 表示无变化 FVector CurrentScale GetPawn()-GetActorScale3D(); FVector NewScale CurrentScale * PinchValue; NewScale NewScale.GetClampedToSize(MinScale, MaxScale); GetPawn()-SetActorScale3D(NewScale); }Enhanced Input 的优势在于输入映射和逻辑解耦同一个 Input Action 可以绑定到不同的硬件输入上触摸、鼠标、手柄共用一套逻辑。另外Enhanced Input 自带修饰器Modifier和触发器Trigger可以在不写代码的情况下调整输入的死区、缩放、反转等参数。一个实操中容易忽略的点是Enhanced Input 的 Touch 触发器需要手动在 Input Mapping Context 里配置默认的 Mapping Context 只包含键盘和鼠标映射。在 IMC 里添加 Touch 类型的 Input Action 时要把 Trigger 设为 Down 或 Pressed否则触摸事件不会触发。注意Enhanced Input 在 UE5.1 之后才完整支持触摸事件UE5.0 的触摸支持有 bug建议升级到 5.1 以上。UE4 的项目如果要用 Enhanced Input需要手动启用插件并做兼容处理成本较高建议直接用旧输入系统。从那以后我每次做触摸交互项目都会先在目标设备上跑一遍输入事件日志确认 TouchLocation 的坐标系和 DPI Scale 的实际值再动手写逻辑。这个习惯帮我省掉了至少三次打包后才发现灵敏度不对的返工。希望帮到你。本文还有配套的精品资源点击获取 UE4/UE5触摸屏手势交互：移动旋转缩放实现与避坑指南
简介这份资源面向使用UE4/UE5开发触屏交互的开发者聚焦触摸屏上的移动、旋转与缩放事件处理适合具备一定蓝图或C基础、希望在移动端与多触点设备上实现直观操控的中高级学习者。包内共349个文件以288个uasset资产、6个umap关卡、34个ini配置及少量png、bin、json、log、ush等辅助文件为主压缩包约610.21MB可直接导入引擎对照研究。内容围绕FTouchEvent的TouchDown、TouchMove、TouchUp三类事件展开涵盖UUserWidget重写BeginTouchDown/BeginTouchMove/EndTouchUp、AddTouchHandler注册以及UE5蓝图TouchEvent节点与WorldContextObject统一输入处理多点触控部分讲解双指中心点平移、夹角变化旋转、距离比例缩放并涉及TouchInputComponent的AddTouch/RemoveTouch与GetPinchZoomDelta等节点附带防抖动与输入刷新率优化思路。已有6432人学习下载可帮助读者快速搭建触控实验工程、理解事件分发链路并复用现成资产结构。1. 触摸屏上的 UE 交互为什么你的移动旋转缩放总在真机上翻车在 PC 上用鼠标拖拽 Actor 一切正常打包到触摸屏一体机或 Android 平板后单指移动变成了乱飞双指缩放要么没反应要么跳变——这是 UE4/UE5 触摸屏事件处理最典型的翻车现场。核心问题在于鼠标事件是单点、绝对坐标、带按键状态的输入模型而触摸事件是多点、相对位移、无按键的输入模型两者在 UE 的输入映射体系里走的是完全不同的管线。这个资源包围绕 UE4 和 UE5 两个版本拆解了触摸屏上移动、旋转、缩放三类手势事件的完整实现方案包含蓝图和 C 两条路线。适合正在做展厅大屏、工业触控面板、教育一体机这类触摸交互项目的开发者尤其是从 PC 端移植到触摸端时被输入映射坑过的人。2. 触摸事件与鼠标事件的底层差异为什么不能直接复用2.1 输入映射体系里触摸事件走的是哪条路UE 的输入系统分三层硬件层产生平台输入事件FPointerEvent、FTouchEvent引擎层通过 PlayerController 和 InputComponent 分发项目层通过 InputAction 和 InputAxis 绑定到具体逻辑。鼠标走的是 FPointerEvent触摸走的是 FTouchEvent两者在 FSlateApplication 层面被统一处理但在 PlayerController 的 InputKey 回调里触摸事件的 Key 是 EKeys::Touch1 到 EKeys::Touch10而鼠标是 EKeys::LeftMouseButton。这意味着你在 Project Settings → Input 里绑定的鼠标轴映射在触摸屏上根本不会触发。常见做法是在 PlayerController 里重写 InputTouch 事件或者用 Enhanced Input 系统里的 Touch 触发器。UE5 的 Enhanced Input 对触摸的支持比 UE4 的旧输入系统好一些但依然需要手动处理多指索引。触摸事件的关键参数有三个Handle手指索引从 0 开始、TouchLocation屏幕坐标、Force压力值大部分触摸屏不提供。移动和旋转依赖 TouchLocation 的帧间差值缩放依赖两个手指 TouchLocation 之间的距离变化率。2.2 单指移动与旋转的事件分发逻辑单指操作要同时支持移动和旋转必须做手势判定。常见做法是手指按下后记录起始位置在移动过程中计算位移向量如果位移方向以水平为主则判定为移动以垂直为主则判定为旋转。但这个判定在实操中很容易抖动更稳的方案是用时间窗口做二次确认——手指移动超过 10 像素且持续超过 0.1 秒才触发手势判定。在蓝图里的实现路径是在 PlayerController 的 InputTouch 事件里根据 TouchIndex 分支处理。TouchIndex 为 0 时记录第一指位置为 1 时记录第二指位置。移动逻辑用第一指的 DeltaLocation 驱动 Actor 的 AddActorWorldOffset旋转逻辑用第一指的 DeltaX 驱动 Actor 的 AddActorLocalRotation。C 路线需要在 PlayerController 子类里重写 InputTouch 函数// MyPlayerController.h virtual bool InputTouch(uint32 Handle, ETouchType::Type Type, const FVector2D TouchLocation, float Force, FDateTime DeviceTimestamp, uint32 TouchpadIndex) override; // MyPlayerController.cpp bool AMyPlayerController::InputTouch(uint32 Handle, ETouchType::Type Type, const FVector2D TouchLocation, float Force, FDateTime DeviceTimestamp, uint32 TouchpadIndex) { // Handle 0 是第一根手指Handle 1 是第二根 if (Handle 0) { if (Type ETouchType::Began) { // 记录起始位置用于后续计算 Delta TouchStartLocation TouchLocation; bIsTouching true; } else if (Type ETouchType::Moved bIsTouching) { // 计算帧间位移 FVector2D Delta TouchLocation - TouchStartLocation; // 水平位移驱动移动垂直位移驱动旋转 if (FMath::Abs(Delta.X) FMath::Abs(Delta.Y)) { // 移动逻辑将屏幕位移映射到世界空间 FVector WorldOffset FVector(Delta.X * MoveSpeed, Delta.Y * MoveSpeed, 0.0f); GetPawn()-AddActorWorldOffset(WorldOffset); } else { // 旋转逻辑垂直位移映射到 Yaw 旋转 FRotator DeltaRotation(0.0f, Delta.Y * RotateSpeed, 0.0f); GetPawn()-AddActorLocalRotation(DeltaRotation); } // 更新起始位置实现增量式移动 TouchStartLocation TouchLocation; } else if (Type ETouchType::Ended) { bIsTouching false; } } return Super::InputTouch(Handle, Type, TouchLocation, Force, DeviceTimestamp, TouchpadIndex); }这段代码的核心逻辑是用 TouchStartLocation 记录上一帧的手指位置每帧计算 Delta 后立即更新起始位置这样每次移动都是增量式的不会因为手指移动过快导致跳变。MoveSpeed 和 RotateSpeed 是两个可调参数前者控制移动灵敏度后者控制旋转灵敏度建议初始值分别设为 1.0 和 0.5再根据实际屏幕尺寸微调。2.3 双指缩放的距离计算与防抖处理双指缩放的核心是计算两个触摸点之间的距离变化。在 InputTouch 里当 Handle 为 0 和 1 都有有效位置时计算两指距离// 在 InputTouch 中处理双指缩放 if (Handle 0 || Handle 1) { // 存储两根手指的当前位置 TouchPositions[Handle] TouchLocation; // 当两根手指都有位置时计算缩放 if (TouchPositions.Contains(0) TouchPositions.Contains(1)) { float CurrentDistance FVector2D::Distance(TouchPositions[0], TouchPositions[1]); if (Type ETouchType::Began) { // 记录初始距离 LastPinchDistance CurrentDistance; } else if (Type ETouchType::Moved) { // 计算缩放比例 float ScaleDelta CurrentDistance / LastPinchDistance; // 防抖缩放比例变化超过阈值才触发 if (FMath::Abs(ScaleDelta - 1.0f) 0.01f) { // 将缩放应用到 Actor 的 Scale 上 FVector CurrentScale GetPawn()-GetActorScale3D(); FVector NewScale CurrentScale * ScaleDelta; // 限制缩放范围防止缩放到 0 或无限大 NewScale NewScale.GetClampedToSize(0.1f, 10.0f); GetPawn()-SetActorScale3D(NewScale); // 更新上次距离 LastPinchDistance CurrentDistance; } } } }这里的关键参数是防抖阈值 0.01f它决定了缩放的最小响应粒度。阈值太小会导致缩放抖动太大则手感迟钝。另一个关键点是缩放范围限制GetClampedToSize 把缩放限制在 0.1 到 10 倍之间防止用户把物体缩到看不见或者撑爆场景。注意UE4 的旧输入系统里触摸事件的 TouchLocation 是屏幕绝对坐标单位是像素。如果你的项目用了 DPI Scaling需要先除以 DPI Scale 再计算否则在不同分辨率的设备上灵敏度会不一致。3. 蓝图与 C 两条实现路线的选型与落地3.1 蓝图实现快速原型与参数暴露蓝图路线的优势是迭代快、参数可视化。在 PlayerController 蓝图里InputTouch 事件节点会提供 Handle、TouchType、TouchLocation 三个输出引脚。用 Switch on Int 节点根据 Handle 分支再用 Branch 节点判断 TouchType 是 Pressed、Moved 还是 Released。移动逻辑用 Get Actor Location → Add Actor World Offset 节点链旋转用 Add Actor Local Rotation缩放用 Set Actor Scale 3D。所有速度参数提升为变量并勾选 Instance Editable这样在关卡里选中 PlayerController 就能直接调参不用每次改蓝图重新编译。蓝图路线的坑在于InputTouch 事件在 PlayerController 里默认不启用需要在 Class Defaults 里勾选 Enable Touch Input。另外如果项目用了 Enhanced Input 插件InputTouch 事件会被拦截需要在 Enhanced Input 的 Mapping Context 里显式添加 Touch 相关的 Input Action。3.2 C 实现性能敏感场景的必选项C 路线的优势是性能可控、逻辑可复用。把触摸逻辑封装成一个 UActorComponent挂载到需要交互的 Actor 上这样多个物体可以共享同一套手势逻辑不用每个 Actor 都写一遍。// TouchInteractionComponent.h UCLASS(ClassGroup(Custom), meta(BlueprintSpawnableComponent)) class MYPROJECT_API UTouchInteractionComponent : public UActorComponent { GENERATED_BODY() public: UTouchInteractionComponent(); UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float MoveSpeed 1.0f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float RotateSpeed 0.5f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float MinScale 0.1f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category Touch) float MaxScale 10.0f; void HandleTouch(uint32 Handle, ETouchType::Type Type, const FVector2D Location); private: TMapuint32, FVector2D TouchPositions; float LastPinchDistance 0.0f; bool bIsPinching false; };这个组件把移动、旋转、缩放三个功能的参数全部暴露到编辑器MoveSpeed 控制移动灵敏度RotateSpeed 控制旋转灵敏度MinScale 和 MaxScale 控制缩放边界。HandleTouch 函数内部根据 Handle 和 Type 分发逻辑和前面 PlayerController 里的实现一致但封装成组件后可以在任意 Actor 上复用。3.3 触摸事件与鼠标事件的兼容处理很多项目需要同时支持触摸屏和鼠标操作比如展厅设备平时用触摸调试时接鼠标。兼容方案是在 InputTouch 里判断当前是否有触摸输入如果有则忽略鼠标事件反之亦然。// 在 PlayerController 里做输入源判定 bool AMyPlayerController::InputTouch(...) { bUsingTouch true; // 触摸逻辑 return true; } bool AMyPlayerController::InputKey(FKey Key, EInputEvent EventType, float AmountDepressed, bool bGamepad) { if (bUsingTouch Key EKeys::LeftMouseButton) { // 触摸激活时忽略鼠标左键 return false; } return Super::InputKey(Key, EventType, AmountDepressed, bGamepad); }这个判定的逻辑是一旦检测到触摸输入就设置 bUsingTouch 标志后续的鼠标左键事件被拦截。反过来如果一段时间内没有触摸输入bUsingTouch 复位鼠标事件恢复。这个超时时间建议设为 2 秒避免触摸和鼠标频繁切换时误判。提示UE5 的 Enhanced Input 系统里可以用 Input Action 的 Trigger 类型来区分输入源。Touch 触发器只响应触摸事件Mouse 触发器只响应鼠标事件两者可以绑定到同一个 Input Action 上由引擎自动分发。4. 避坑与排查触摸交互项目里最常见的五个翻车点4.1 打包后触摸完全无响应现象编辑器里 Simulate 触摸正常打包到 Android 或 Windows 触摸一体机后手指点击没有任何反应。原因最常见的是 Project Settings → Input → Mobile 里的 Always Show Touch Interface 没勾选或者 Default Touch Interface 被设成了 None。另一个原因是 PlayerController 的 bShowMouseCursor 在触摸设备上默认为 false但某些平台需要显式启用触摸输入。解决在 Project Settings → Input → Mobile 里勾选 Always Show Touch Interface把 Default Touch Interface 设为 DefaultVirtualJoysticks 或自定义的 Touch Interface。同时在 PlayerController 的 BeginPlay 里加一行bEnableTouchEvents true;确保触摸事件被激活。4.2 双指缩放时物体跳变现象两根手指开始缩放时物体瞬间放大或缩小一大截然后才跟随手指正常缩放。原因LastPinchDistance 在第二根手指按下的瞬间没有正确初始化。如果第二根手指按下时 LastPinchDistance 还是 0 或者上一轮缩放结束时的旧值第一帧计算出的 ScaleDelta 就会异常大。解决在第二根手指的 TouchType 为 Began 时立即计算并存储当前两指距离作为 LastPinchDistance并且跳过这一帧的缩放计算。代码里加一个 bIsPinching 标志只有两根手指都处于 Moved 状态时才执行缩放逻辑。4.3 旋转方向与手指移动方向相反现象手指向上滑动物体却向下旋转手指向左滑动物体向右旋转。原因屏幕坐标系的 Y 轴方向与世界坐标系的 Yaw 旋转方向不一致。屏幕坐标 Y 轴向下为正而 UE 世界坐标里 Yaw 正方向是顺时针从上往下看两者叠加后方向反转。解决在计算旋转量时对 Delta.Y 取反即DeltaRotation.Yaw -Delta.Y * RotateSpeed。或者直接在项目设置里把触摸的 Y 轴反转但推荐在代码里处理因为不同平台的屏幕坐标系可能不同。4.4 多点触摸时手指索引错乱现象三根手指同时操作时移动和缩放逻辑互相干扰物体乱飞。原因UE 的触摸事件里Handle 是手指的索引但这个索引在手指抬起后会被回收。如果同时有三根手指Handle 0、1、2 分别对应三根手指但手指 0 抬起后原来手指 1 的 Handle 可能变成 0导致逻辑错位。解决不要依赖 Handle 的固定值来判断手指角色。用 TMap 存储每个 Handle 的起始位置和状态在 TouchType 为 Ended 时从 Map 里移除对应的 Handle。缩放逻辑只取 Map 里前两个有效 Handle 的距离不假设 Handle 0 和 1 一定是缩放手指。4.5 触摸移动速度在不同分辨率设备上不一致现象在 1080P 触摸屏上调好的移动速度换到 4K 触摸屏上变得飞快。原因TouchLocation 的单位是屏幕像素4K 屏幕的像素密度是 1080P 的两倍同样的手指滑动距离产生的像素差值也是两倍。解决在计算 Delta 之前先把 TouchLocation 除以屏幕的 DPI Scale。UE 里可以用GetWorld()-GetGameViewport()-GetDPIScale()获取当前 DPI 缩放系数或者用FSlateApplication::Get().GetApplicationScale()。把归一化后的 Delta 再乘以 MoveSpeed这样在不同分辨率下手感一致。5. 进阶技巧用 Enhanced Input 重构触摸手势系统UE5 的 Enhanced Input 系统给触摸交互带来了更干净的架构。核心思路是把移动、旋转、缩放分别定义为三个 Input Action用不同的 Trigger 来区分手势类型。移动用 Axis2D 类型的 Input Action绑定 Touch 的 Moved 事件输出值是归一化的屏幕位移。旋转用 Axis1D 类型只取垂直方向的位移分量。缩放用 Axis1D 类型输出值是两指距离的变化率。// 在 PlayerController 的 SetupInputComponent 里绑定 Enhanced Input void AMyPlayerController::SetupInputComponent() { Super::SetupInputComponent(); if (UEnhancedInputComponent* EIC CastUEnhancedInputComponent(InputComponent)) { // 移动Axis2D绑定到 MoveAction EIC-BindAction(MoveAction, ETriggerEvent::Triggered, this, AMyPlayerController::HandleMove); // 旋转Axis1D绑定到 RotateAction EIC-BindAction(RotateAction, ETriggerEvent::Triggered, this, AMyPlayerController::HandleRotate); // 缩放Axis1D绑定到 PinchAction EIC-BindAction(PinchAction, ETriggerEvent::Triggered, this, AMyPlayerController::HandlePinch); } } void AMyPlayerController::HandleMove(const FInputActionValue Value) { FVector2D MoveValue Value.GetFVector2D(); // MoveValue 已经是归一化后的值直接映射到世界空间 FVector WorldOffset FVector(MoveValue.X * MoveSpeed, MoveValue.Y * MoveSpeed, 0.0f); GetPawn()-AddActorWorldOffset(WorldOffset); } void AMyPlayerController::HandlePinch(const FInputActionValue Value) { float PinchValue Value.Getfloat(); // PinchValue 是两指距离的变化率1.0 表示无变化 FVector CurrentScale GetPawn()-GetActorScale3D(); FVector NewScale CurrentScale * PinchValue; NewScale NewScale.GetClampedToSize(MinScale, MaxScale); GetPawn()-SetActorScale3D(NewScale); }Enhanced Input 的优势在于输入映射和逻辑解耦同一个 Input Action 可以绑定到不同的硬件输入上触摸、鼠标、手柄共用一套逻辑。另外Enhanced Input 自带修饰器Modifier和触发器Trigger可以在不写代码的情况下调整输入的死区、缩放、反转等参数。一个实操中容易忽略的点是Enhanced Input 的 Touch 触发器需要手动在 Input Mapping Context 里配置默认的 Mapping Context 只包含键盘和鼠标映射。在 IMC 里添加 Touch 类型的 Input Action 时要把 Trigger 设为 Down 或 Pressed否则触摸事件不会触发。注意Enhanced Input 在 UE5.1 之后才完整支持触摸事件UE5.0 的触摸支持有 bug建议升级到 5.1 以上。UE4 的项目如果要用 Enhanced Input需要手动启用插件并做兼容处理成本较高建议直接用旧输入系统。从那以后我每次做触摸交互项目都会先在目标设备上跑一遍输入事件日志确认 TouchLocation 的坐标系和 DPI Scale 的实际值再动手写逻辑。这个习惯帮我省掉了至少三次打包后才发现灵敏度不对的返工。希望帮到你。本文还有配套的精品资源点击获取