1. 项目概述从“拖拽”到“手势”的交互跃迁在Unity开发尤其是AR/VR项目中旋转一个3D模型你是不是还在用鼠标拖拽或者屏幕滑动这种交互方式在移动端特别是增强现实场景下显得笨拙且不直观。用户期望的是更自然、更贴近物理世界的交互——就像用手直接拨弄一个真实物体一样。这正是“手势旋转”要解决的问题。它不仅仅是把滑动事件映射到旋转角度那么简单背后涉及到手势识别精度、旋转轴计算、多手势冲突处理以及AR环境下的空间适配等一系列技术细节。我最近在几个AR展示项目中深度使用了Unity的ARFoundation框架并实现了这套手势旋转方案。实测下来它不仅让应用的交互体验上了几个台阶用户反馈也出奇地好。很多人第一次在手机上用手指“捏住”并旋转一个虚拟的汽车模型时都会发出“哇哦”的惊叹。这背后是一套完整的从手势输入到3D变换的逻辑链。本文将抛开那些华而不实的理论直接上干货手把手带你用C#脚本实现这套系统并分享我踩过的坑和优化技巧。无论你是Unity新手还是想优化现有AR交互的开发者这篇文章都能让你直接抄作业。2. 核心思路与方案选型为什么是ARFoundation 单指旋转在动手写代码之前我们先要理清思路。实现3D模型旋转有多种路径比如基于陀螺仪、基于屏幕坐标差、或者使用更高级的手势识别插件。我们的目标是在ARFoundation构建的AR环境中实现稳定、流畅、符合直觉的单指旋转控制。2.1 为什么选择ARFoundationARFoundation是Unity官方的跨平台AR开发框架它抽象了ARKitiOS和ARCoreAndroid的底层接口。这意味着我们写一套代码就可以同时在iOS和Android设备上运行大大减少了平台适配的工作量。对于手势旋转这种需要高精度、低延迟触摸输入的功能ARFoundation提供了稳定的Input系统接入和Camera渲染管线是我们理想的开发基础。2.2 单指旋转 vs 双指旋转你可能见过双指旋转类似缩放地图的方案。但在AR场景中用户常常需要一只手持设备另一只手进行操作。双指操作需要两只手指协调容易误触为缩放或平移且对手指距离有要求体验并不完美。单指旋转则直观得多手指在屏幕上划过的轨迹直接对应模型在屏幕平面上的旋转。这更符合“用手指拨动物体”的直觉。因此我们核心选择实现单指拖拽旋转。2.3 旋转轴的计算逻辑这是最关键的一步。我们不能简单地把屏幕的X/Y移动直接对应到模型世界的Y/X旋转上那样会非常奇怪。正确的逻辑是将屏幕触摸点转换为从摄像机发出的一条射线Ray。计算这条射线与一个虚拟的、包围模型的“旋转球体”或“旋转平面”的交点。根据当前帧和上一帧交点的变化计算出一个旋转轴和旋转角度。将这个旋转应用到模型上。我们这里采用一种更高效且效果不错的方案基于屏幕坐标差计算旋转。其原理是将手指在屏幕上的二维移动映射到模型围绕其自身Y轴和X轴的旋转。Y轴旋转对应手指的水平移动X轴旋转对应手指的垂直移动。同时我们需要引入一个“旋转速度”系数来调节灵敏度。3. 环境准备与基础设置在开始写核心脚本前我们需要搭建好Unity工程和ARFoundation环境。这一步很多人会忽略导致后面脚本不工作。3.1 创建Unity项目与导入ARFoundation创建项目使用Unity Hub创建一个新的3D项目建议使用较新的LTS版本如2022.3。安装Package打开Window - Package Manager。确保“Packages”下拉菜单选择的是“Unity Registry”。在列表中搜索并安装以下包AR Foundation核心框架。ARCore XR Plugin针对Android或/和ARKit XR Plugin针对iOS。根据你的目标平台安装。如果你要发布到两个平台可以都安装。验证安装安装后在菜单栏应能看到GameObject - XR的子菜单里面有创建AR Session Origin等选项。3.2 设置AR场景清理默认场景删除默认的Main Camera。创建AR环境点击GameObject - XR - AR Session Origin。这会自动创建一个包含AR Session Origin和AR Camera的游戏对象。AR Session Origin管理AR场景的空间原点。AR Camera替代了普通摄像机负责渲染AR画面。添加AR会话点击GameObject - XR - AR Session。这是一个全局管理器控制AR会话的生命周期启动、停止、重置。3.3 准备3D模型与测试对象将你的3D模型比如一个.fbx文件导入项目的Assets文件夹。从Project面板将模型拖入Hierarchy层级视图成为AR Session Origin的子对象或放在其下。调整它的位置Position和缩放Scale使其在摄像机视野中大小合适。通常初始位置设为(0 0 0.5)或(0 0 1)表示在摄像机前方0.5米或1米处。为了方便测试你也可以直接创建一个Unity自带的3D物体如Cube或Sphere作为旋转对象。注意确保你的模型有一个Collider碰撞体如Box Collider或Mesh Collider。虽然我们核心旋转逻辑不依赖物理碰撞但良好的实践是给可交互物体添加Collider为未来可能的射线检测交互如点击选中做准备。4. 核心C#脚本实现GestureRotator.cs接下来是重头戏。我们将创建一个名为GestureRotator.cs的脚本并将其挂载到需要旋转的3D模型上。4.1 脚本框架与变量定义using UnityEngine; public class GestureRotator : MonoBehaviour { [Header(旋转控制)] [Tooltip(旋转速度系数)] public float rotationSpeed 0.5f; [Tooltip(是否启用旋转)] public bool isRotatingEnabled true; [Header(高级设置)] [Tooltip(围绕自身Y轴旋转的灵敏度)] public float yawSensitivity 1.0f; [Tooltip(围绕自身X轴旋转的灵敏度)] public float pitchSensitivity 1.0f; [Tooltip(启用惯性旋转)] public bool enableInertia true; [Tooltip(惯性阻尼系数值越大停止越快)] public float inertiaDamping 5.0f; // 内部状态变量 private bool isDragging false; private Vector2 lastTouchPosition; private Vector3 currentRotationVelocity; // 用于惯性旋转的速度向量 void Update() { HandleTouchInput(); ApplyInertia(); } }rotationSpeed: 全局旋转速度旧方案常用。我们新方案用yawSensitivity和pitchSensitivity分别控制这个变量可作为备用或整体微调。yawSensitivity/pitchSensitivity: 分别控制绕Y轴偏航和X轴俯仰旋转的灵敏度。独立控制是因为用户可能希望水平旋转更灵敏或垂直旋转更柔和。enableInertia/inertiaDamping: 实现惯性效果。当手指离开屏幕后模型会根据最后的旋转速度慢慢减速停止这能极大提升操作手感。isDragging/lastTouchPosition: 用于跟踪拖拽状态和上一帧的触摸点。currentRotationVelocity: 存储当前的角速度向量用于惯性计算。4.2 触摸输入处理逻辑在Update函数中我们调用HandleTouchInput来处理每一帧的触摸事件。private void HandleTouchInput() { if (!isRotatingEnabled) return; // 单指触摸开始 if (Input.touchCount 1 Input.GetTouch(0).phase TouchPhase.Began) { isDragging true; lastTouchPosition Input.GetTouch(0).position; currentRotationVelocity Vector3.zero; // 开始新的拖拽时重置惯性 } // 单指移动中 else if (isDragging Input.touchCount 1 Input.GetTouch(0).phase TouchPhase.Moved) { Vector2 currentTouchPosition Input.GetTouch(0).position; Vector2 deltaPosition currentTouchPosition - lastTouchPosition; // 核心计算根据移动差值计算旋转量 // deltaPosition.x 的变化导致绕世界Y轴或物体自身Y轴旋转 // deltaPosition.y 的变化导致绕物体自身X轴旋转 float yawDelta -deltaPosition.x * yawSensitivity * Time.deltaTime * 10f; // 绕Y轴旋转偏航 float pitchDelta deltaPosition.y * pitchSensitivity * Time.deltaTime * 10f; // 绕X轴旋转俯仰 // 应用旋转 // 方式一直接使用Transform.Rotate (推荐直观) transform.Rotate(Vector3.up yawDelta Space.World); // 绕世界Y轴旋转 transform.Rotate(Vector3.right pitchDelta Space.Self); // 绕自身X轴旋转 // 方式二计算并更新角速度用于惯性 // 将本次旋转变化转换为角速度近似 currentRotationVelocity new Vector3(pitchDelta / Time.deltaTime yawDelta / Time.deltaTime 0); lastTouchPosition currentTouchPosition; } // 单指触摸结束或取消 else if (Input.touchCount 0 || (Input.touchCount 1 (Input.GetTouch(0).phase TouchPhase.Ended || Input.GetTouch(0).phase TouchPhase.Canceled))) { isDragging false; // 注意这里不重置currentRotationVelocity惯性逻辑会用到它 } }关键点解析触摸阶段判断我们严格区分了Began开始、Moved移动、Ended结束和Canceled取消阶段。这是实现精准控制的基础。Delta计算deltaPosition是当前帧触摸位置与上一帧位置的差值。这个向量的大小和方向直接决定了旋转的速度和方向。旋转方向-deltaPosition.x中的负号很关键。因为屏幕坐标的X轴向右为正但我们希望手指向右滑动时模型也向右转即绕Y轴逆时针从上看是负方向。根据左手或右手坐标系以及旋转正方向定义可能需要调整这个符号-号是经过实测最符合直觉的。deltaPosition.y为正时手指向上滑动模型应绕X轴向上转即俯仰角增加。Time.deltaTime乘以Time.deltaTime是为了使旋转速度与帧率无关。无论游戏是30帧还是60帧手指移动相同距离模型旋转的角度是一致的。Space.World 与 Space.Self绕Y轴旋转使用Space.World世界空间这能保证模型的左右旋转始终以地面垂直方向为轴不会因为模型已经倾斜而变得奇怪。绕X轴旋转使用Space.Self自身空间这样模型的上下翻转是围绕它自己的前向轴进行的更符合“抬头低头”的直觉。4.3 惯性旋转实现惯性效果能显著提升操作的流畅感和质感。原理很简单在拖拽时我们计算出一个角速度当手指离开后让模型继续以此角速度旋转并每帧施加一个阻尼使其逐渐停止。private void ApplyInertia() { if (!enableInertia) return; if (isDragging) return; // 拖拽中不应用惯性 // 如果还有旋转速度 if (currentRotationVelocity.magnitude 0.01f) { // 应用旋转将角速度转换为本帧的旋转角度 transform.Rotate(Vector3.right currentRotationVelocity.x * Time.deltaTime Space.Self); transform.Rotate(Vector3.up currentRotationVelocity.y * Time.deltaTime Space.World); // 应用阻尼使速度逐渐减小 currentRotationVelocity Vector3.Lerp(currentRotationVelocity Vector3.zero inertiaDamping * Time.deltaTime); } else { // 速度足够小直接归零避免微小抖动 currentRotationVelocity Vector3.zero; } }Vector3.Lerp是线性插值函数这里用于平滑地将角速度衰减到零。inertiaDamping越大减速越快。判断currentRotationVelocity.magnitude 0.01f是一个优化避免在速度极小时还在进行不必要的计算和微小的旋转。4.4 完整的脚本代码将以上部分组合并添加一些额外的实用功能如双击重置旋转。using UnityEngine; public class GestureRotator : MonoBehaviour { [Header(旋转控制)] public float rotationSpeed 0.5f; public bool isRotatingEnabled true; [Header(灵敏度设置)] public float yawSensitivity 1.0f; public float pitchSensitivity 1.0f; [Header(惯性设置)] public bool enableInertia true; public float inertiaDamping 5.0f; [Header(重置设置)] public bool enableDoubleTapReset true; public float doubleTapTimeThreshold 0.3f; private float lastTapTime; private Quaternion originalRotation; private bool isDragging false; private Vector2 lastTouchPosition; private Vector3 currentRotationVelocity; void Start() { originalRotation transform.rotation; // 记录初始旋转状态 } void Update() { if (!isRotatingEnabled) return; HandleTouchInput(); HandleDoubleTap(); ApplyInertia(); } private void HandleTouchInput() { // ... 同上文HandleTouchInput函数内容 ... } private void ApplyInertia() { // ... 同上文ApplyInertia函数内容 ... } private void HandleDoubleTap() { if (!enableDoubleTapReset) return; if (Input.touchCount 1 Input.GetTouch(0).phase TouchPhase.Began) { float timeSinceLastTap Time.time - lastTapTime; if (timeSinceLastTap doubleTapTimeThreshold) { // 双击事件触发 ResetRotation(); currentRotationVelocity Vector3.zero; // 重置惯性 } lastTapTime Time.time; } } public void ResetRotation() { transform.rotation originalRotation; } // 提供一个公共方法方便其他脚本控制旋转开关 public void SetRotationEnabled(bool enabled) { isRotatingEnabled enabled; if (!enabled) { isDragging false; currentRotationVelocity Vector3.zero; } } }5. 参数调试与手感优化脚本写好了但直接使用默认参数可能得不到最佳手感。这部分是区分“能用”和“好用”的关键。5.1 核心参数调试指南将脚本挂载到模型后在Unity Editor的Inspector面板你会看到可调的参数。在手机上实时调试通过Unity Remote或直接Build是必须的。参数建议起始值作用调试技巧yawSensitivity0.5水平旋转灵敏度。值越大手指水平移动相同距离模型转得越快。先设小点如0.3快速滑动手指模型应能顺畅旋转至少180度。如果感觉“拖不动”或“太飘”逐步调整。pitchSensitivity0.3垂直旋转灵敏度。通常设置得比yaw小因为上下翻转容易让人眩晕。测试垂直滑动。确保向上滑动模型“抬头”向下滑动“低头”。如果方向反了检查脚本中pitchDelta计算前的正负号。enableInertiatrue惯性开关。强烈建议开启。开启后快速滑动并松手模型应继续旋转一段后平滑停止。关闭则立即停止。inertiaDamping3.0惯性阻尼。值越大惯性停止得越快。如果感觉松手后转太久调大此值如5-8。如果感觉停得太“愣”调小此值如1.5-2.5。doubleTapTimeThreshold0.3双击时间间隔秒。两次点击间隔小于此值算双击。根据用户点击习惯调整。太短容易误触太长感觉响应慢。0.2-0.4是常见范围。5.2 常见手感问题与解决方案问题旋转时模型“抖动”或“卡顿”。排查1帧率问题。在手机上运行打开Stats面板查看帧率。如果帧率过低30fps旋转计算会不连贯。需要优化模型面数、贴图、Shader或脚本效率。排查2触摸采样率。有些低端设备触摸采样率低。确保在Update函数中处理触摸Update每帧调用能获取到最新的触摸数据。排查3物理或其它脚本干扰。检查模型是否附加了Rigidbody刚体并与其它物体发生碰撞这可能会干扰Transform。如果不需要物理交互可以移除Rigidbody或将其设为Kinematic。问题旋转轴感觉“不对”不是围绕模型中心。原因模型的轴心点Pivot不在几何中心。在3D建模软件中导出时应确保轴心点在模型底部中心或几何中心。解决在Unity中可以创建一个空的GameObject作为父节点将模型作为其子对象。将旋转脚本挂在父节点上通过调整子模型的位置来“校准”旋转中心。问题在AR中模型旋转时背景摄像头画面好像也在动很晕。原因这是正常的视觉现象。因为模型在动而固定的真实背景作为参照物会产生相对运动感。缓解适当降低pitchSensitivity垂直灵敏度避免过快的大角度上下翻转。确保模型在屏幕中的位置稳定不要因为旋转脚本意外修改了模型的Position。6. 高级扩展与平台适配基础功能稳定后可以考虑以下扩展让你的交互更专业。6.1 多模型管理与选中逻辑在实际应用中场景里可能有多个可旋转的模型。我们需要一套选中机制。// 扩展思路创建一个管理类或者为每个GestureRotator添加选中状态。 public class GestureRotator : MonoBehaviour { // ... 原有变量 ... public bool isSelected false; private static GestureRotator currentlySelectedObject; void Update() { // 只有被选中的对象才响应旋转输入 if (!isRotatingEnabled || !isSelected) return; HandleTouchInput(); // ... 其他更新 ... } // 可以添加一个OnMouseDown或通过射线检测来触发此方法 public void SelectObject() { if (currentlySelectedObject ! null currentlySelectedObject ! this) { currentlySelectedObject.Deselect(); } currentlySelectedObject this; isSelected true; // 可以在这里添加高亮效果比如改变材质颜色 } public void Deselect() { isSelected false; // 取消高亮效果 } }然后你需要另一个脚本如TouchManager来处理初始的触摸射线检测判断用户点中了哪个模型并调用该模型的SelectObject()方法。6.2 与AR平面检测、锚点结合在更复杂的AR应用中模型可能被放置在检测到的真实世界平面上如桌面、地面。我们的旋转脚本需要和这些AR功能协同工作。关键点确保旋转脚本修改的是模型相对于其父级AR Anchor锚点的旋转而不是世界旋转。通常你的模型结构会是AR Session Origin - AR Anchor (在某个检测到的平面上) - Your 3D Model (带有GestureRotator脚本)。操作旋转脚本中的transform指的就是Your 3D Model它的旋转是相对于父节点AR Anchor的局部旋转。这样无论锚点在世界中如何旋转都只发生在模型本地行为是正确的。6.3 iOS与Android的细微差异ARFoundation已经处理了大部分跨平台差异但触摸处理上基本一致。需要注意的是触摸IDInput.touches数组在iOS和Android上都是可靠的。我们的代码基于Input.touchCount和Input.GetTouch(0)这在两大平台通用。性能在低端Android设备上可能需要更积极地优化。如果发现惯性不流畅可以尝试在ApplyInertia中降低Time.deltaTime的乘数或者考虑使用FixedUpdate进行物理相关的计算但我们的旋转是直接修改Transform在Update中更合适。7. 实战避坑与性能优化心得这里分享一些只有真正做过项目才会知道的细节。7.1 输入处理的坑多点触摸干扰我们的逻辑只处理单指。但当第二根手指落下时Input.touchCount变为2即使第一根手指还在移动TouchPhase对于第一指可能不会立即变为Stationary可能会有一两帧的Moved。这可能导致旋转突然跳动。更健壮的写法是在HandleTouchInput的移动判断里不仅检查isDragging还要检查当前活动的触摸点是否还是最初开始拖拽的那个手指通过Touch.fingerId判断。但对于大多数要求不极致的场景现有逻辑已足够稳定。UI穿透如果屏幕上有UI按钮手指在按钮上开始触摸即使滑动到模型区域也可能被UI系统拦截。确保你的可旋转模型所在的层不被UI事件系统EventSystem的射线检测阻挡。可以设置Graphic Raycaster的屏蔽层或者使用IPointerDownHandler等接口在UI上做更精细的控制。7.2 性能优化点减少不必要的计算在Update中如果!isRotatingEnabled且!enableInertia可以直接return避免任何计算。避免在运行时频繁查找组件我们的脚本是挂载在自身Transform上操作没有GetComponent调用这很好。对于复杂模型如果模型面数极高数十万面频繁旋转可能导致重绘开销大。可以考虑使用LOD多层次细节在旋转时显示中低模停止后切换回高模。或者确保模型的静态批处理Static Batching设置正确但旋转的物体通常是动态的无法静态批处理。7.3 一个提升体验的小技巧边界阻尼当模型旋转到接近某个极限角度比如不想让模型完全倒置时可以给旋转增加一个阻尼越接近极限越难转动就像有软边界一样。这可以通过在计算yawDelta和pitchDelta后乘以一个基于当前欧拉角的系数来实现。// 在计算完pitchDelta后可以加入边界检查示例限制俯仰角在-80度到80度之间 float currentPitch transform.localEulerAngles.x; currentPitch (currentPitch 180) ? currentPitch - 360 : currentPitch; // 转换为-180到180的范围 if ((currentPitch 75 pitchDelta 0) || (currentPitch -75 pitchDelta 0)) { // 接近边界时减小旋转增量 float dampFactor 1.0f - Mathf.Clamp01((Mathf.Abs(currentPitch) - 70f) / 10f); // 在70度到80度之间线性衰减到0 pitchDelta * dampFactor; } // 然后再应用旋转 transform.Rotate(Vector3.right pitchDelta Space.Self);实现这套手势旋转系统后你的AR应用交互质感会有质的飞跃。它不再是一个冷冰冰的演示而是一个用户可以自然地把玩、探索的数字物件。记住所有参数都没有绝对的最优值一定要在你的目标设备上和真实用户场景中反复测试、微调找到那个最“跟手”的感觉。