Unity ARFoundation手势旋转3D模型：从原理到C#实现与优化

1. 项目概述：从“拖拽”到“手势”的交互跃迁

在Unity开发，尤其是AR/VR项目中，旋转一个3D模型，你是不是还在用鼠标拖拽或者屏幕滑动？这种交互方式在移动端，特别是增强现实场景下，显得笨拙且不直观。用户期望的是更自然、更贴近物理世界的交互——就像用手直接拨弄一个真实物体一样。这正是“手势旋转”要解决的问题。它不仅仅是把滑动事件映射到旋转角度那么简单，背后涉及到手势识别精度、旋转轴计算、多手势冲突处理以及AR环境下的空间适配等一系列技术细节。

我最近在几个AR展示项目中深度使用了Unity的ARFoundation框架，并实现了这套手势旋转方案。实测下来，它不仅让应用的交互体验上了几个台阶，用户反馈也出奇地好。很多人第一次在手机上用手指“捏住”并旋转一个虚拟的汽车模型时，都会发出“哇哦”的惊叹。这背后，是一套完整的从手势输入到3D变换的逻辑链。本文将抛开那些华而不实的理论，直接上干货，手把手带你用C#脚本实现这套系统，并分享我踩过的坑和优化技巧。无论你是Unity新手还是想优化现有AR交互的开发者，这篇文章都能让你直接抄作业。

2. 核心思路与方案选型：为什么是ARFoundation + 单指旋转？

在动手写代码之前，我们先要理清思路。实现3D模型旋转有多种路径，比如基于陀螺仪、基于屏幕坐标差、或者使用更高级的手势识别插件。我们的目标是：在ARFoundation构建的AR环境中，实现稳定、流畅、符合直觉的单指旋转控制。

2.1 为什么选择ARFoundation？

ARFoundation是Unity官方的跨平台AR开发框架，它抽象了ARKit（iOS）和ARCore（Android）的底层接口。这意味着我们写一套代码，就可以同时在iOS和Android设备上运行，大大减少了平台适配的工作量。对于手势旋转这种需要高精度、低延迟触摸输入的功能，ARFoundation提供了稳定的Input系统接入和Camera渲染管线，是我们理想的开发基础。

2.2 单指旋转 vs 双指旋转

你可能见过双指旋转（类似缩放地图）的方案。但在AR场景中，用户常常需要一只手持设备，另一只手进行操作。双指操作需要两只手指协调，容易误触为缩放或平移，且对手指距离有要求，体验并不完美。单指旋转则直观得多：手指在屏幕上划过的轨迹，直接对应模型在屏幕平面上的旋转。这更符合“用手指拨动物体”的直觉。因此，我们核心选择实现单指拖拽旋转。

2.3 旋转轴的计算逻辑

这是最关键的一步。我们不能简单地把屏幕的X/Y移动直接对应到模型世界的Y/X旋转上，那样会非常奇怪。正确的逻辑是：

1. 将屏幕触摸点转换为从摄像机发出的一条射线（Ray）。
2. 计算这条射线与一个虚拟的、包围模型的“旋转球体”或“旋转平面”的交点。
3. 根据当前帧和上一帧交点的变化，计算出一个旋转轴和旋转角度。
4. 将这个旋转应用到模型上。

我们这里采用一种更高效且效果不错的方案：基于屏幕坐标差计算旋转。其原理是将手指在屏幕上的二维移动，映射到模型围绕其自身Y轴和X轴的旋转。Y轴旋转对应手指的水平移动，X轴旋转对应手指的垂直移动。同时，我们需要引入一个“旋转速度”系数来调节灵敏度。

3. 环境准备与基础设置

在开始写核心脚本前，我们需要搭建好Unity工程和ARFoundation环境。这一步很多人会忽略，导致后面脚本不工作。

3.1 创建Unity项目与导入ARFoundation

1. 创建项目：使用Unity Hub创建一个新的3D项目（建议使用较新的LTS版本，如2022.3）。
2. 安装Package：打开Window -> Package Manager。确保“Packages”下拉菜单选择的是“Unity Registry”。在列表中搜索并安装以下包：
   • AR Foundation：核心框架。
   • ARCore XR Plugin（针对Android）或/和ARKit XR Plugin（针对iOS）。根据你的目标平台安装。如果你要发布到两个平台，可以都安装。
3. 验证安装：安装后，在菜单栏应能看到GameObject -> XR的子菜单，里面有创建AR Session Origin等选项。

3.2 设置AR场景

1. 清理默认场景：删除默认的Main Camera。
2. 创建AR环境：点击GameObject -> XR -> AR Session Origin。这会自动创建一个包含AR Session Origin和AR Camera的游戏对象。
   • AR Session Origin：管理AR场景的空间原点。
   • AR Camera：替代了普通摄像机，负责渲染AR画面。
3. 添加AR会话：点击GameObject -> XR -> AR Session。这是一个全局管理器，控制AR会话的生命周期（启动、停止、重置）。

3.3 准备3D模型与测试对象

1. 将你的3D模型（比如一个.fbx文件）导入项目的Assets文件夹。
2. 从Project面板将模型拖入Hierarchy（层级视图），成为AR Session Origin的子对象或放在其下。调整它的位置（Position）和缩放（Scale），使其在摄像机视野中大小合适。通常初始位置设为(0， 0， 0.5)或(0， 0， 1)，表示在摄像机前方0.5米或1米处。
3. 为了方便测试，你也可以直接创建一个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，惯性逻辑会用到它 } }

关键点解析：

1. 触摸阶段判断：我们严格区分了Began（开始）、Moved（移动）、Ended（结束）和Canceled（取消）阶段。这是实现精准控制的基础。
2. Delta计算：deltaPosition是当前帧触摸位置与上一帧位置的差值。这个向量的大小和方向直接决定了旋转的速度和方向。
3. 旋转方向：-deltaPosition.x中的负号很关键。因为屏幕坐标的X轴向右为正，但我们希望手指向右滑动时，模型也向右转（即绕Y轴逆时针，从上看是负方向）。根据左手或右手坐标系以及旋转正方向定义，可能需要调整这个符号，-号是经过实测最符合直觉的。deltaPosition.y为正时，手指向上滑动，模型应绕X轴向上转（即俯仰角增加）。
4. Time.deltaTime：乘以Time.deltaTime是为了使旋转速度与帧率无关。无论游戏是30帧还是60帧，手指移动相同距离，模型旋转的角度是一致的。
5. 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）是必须的。

5.2 常见手感问题与解决方案

1. 问题：旋转时模型“抖动”或“卡顿”。

   • 排查1：帧率问题。在手机上运行，打开Stats面板查看帧率。如果帧率过低（<30fps），旋转计算会不连贯。需要优化模型面数、贴图、Shader或脚本效率。
   • 排查2：触摸采样率。有些低端设备触摸采样率低。确保在Update函数中处理触摸，Update每帧调用，能获取到最新的触摸数据。
   • 排查3：物理或其它脚本干扰。检查模型是否附加了Rigidbody（刚体）并与其它物体发生碰撞，这可能会干扰Transform。如果不需要物理交互，可以移除Rigidbody或将其设为Kinematic。

2. 问题：旋转轴感觉“不对”，不是围绕模型中心。

   • 原因：模型的轴心点（Pivot）不在几何中心。在3D建模软件中导出时，应确保轴心点在模型底部中心或几何中心。
   • 解决：在Unity中，可以创建一个空的GameObject作为父节点，将模型作为其子对象。将旋转脚本挂在父节点上，通过调整子模型的位置来“校准”旋转中心。

3. 问题：在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已经处理了大部分跨平台差异，但触摸处理上基本一致。需要注意的是：

• 触摸ID：Input.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 性能优化点

1. 减少不必要的计算：在Update中，如果!isRotatingEnabled且!enableInertia，可以直接return，避免任何计算。
2. 避免在运行时频繁查找组件：我们的脚本是挂载在自身Transform上操作，没有GetComponent调用，这很好。
3. 对于复杂模型：如果模型面数极高（数十万面），频繁旋转可能导致重绘开销大。可以考虑使用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应用交互质感会有质的飞跃。它不再是一个冷冰冰的演示，而是一个用户可以自然地把玩、探索的数字物件。记住，所有参数都没有绝对的最优值，一定要在你的目标设备上和真实用户场景中反复测试、微调，找到那个最“跟手”的感觉。