1. 项目概述：为什么Easy Touch 5依然是移动开发的“瑞士军刀”
在Unity移动端开发里，输入处理是个绕不开的坎。尤其是多点触控，从简单的点击、拖拽到复杂的双指缩放、旋转，如果自己从零开始写，不仅要处理不同平台（iOS/Android）的输入差异，还得考虑性能、手势识别精度和代码的维护性，一套下来少说也得折腾个把星期。所以，一个成熟、稳定的第三方触摸控制插件就成了项目里的“标配”。Easy Touch 5，特别是我们这次要深挖的5.0.8版本，就是这样一个在社区里经久不衰的经典选择。它不是什么新鲜出炉的酷炫框架，但胜在稳定、全面、上手快，就像一个工具箱里的“瑞士军刀”，你可能不会天天炫耀它，但真遇到触摸交互的需求，拿起来就能用，而且大概率能解决问题。
我最初接触Easy Touch也是在几年前的一个AR项目里，需要在手机屏幕上实现物体的旋转和缩放。当时试过几种方案，要么识别不灵敏，要么代码写得臃肿。后来用了Easy Touch 5，基本上就是“拖拖组件，写写回调”的事，项目进度一下子就提上来了。虽然现在Unity自己的Input System也在不断完善，但对于需要快速原型开发、或者项目历史包袱较重（比如还在用旧的Input Manager）的团队来说，Easy Touch 5凭借其极低的接入成本和丰富的预设功能，依然有很强的实用价值。5.0.8这个版本是一个经过多次迭代后的稳定版，修复了不少早期版本的bug，文档和社区资源也相对丰富，是投入学习性价比很高的一个节点。
简单来说，Easy Touch 5.0.8的核心价值在于，它把复杂的、底层的手势识别和事件分发机制封装成了直观的组件和事件监听器。开发者不需要关心手指按下时TouchPhase是怎么变化的，也不需要自己去计算两指间的向量和角度差，只需要关注“当用户做了一个捏合手势时，我的游戏对象应该缩放多少”这样的业务逻辑。这对于独立开发者、小团队或者开发周期紧张的商业项目来说，能节省大量时间和精力。
2. 核心架构与组件深度解析
Easy Touch 5的架构设计遵循了“事件驱动”和“组件化”的思想，整个系统可以看作是由几个核心的“管理器”组件和一系列“监听器”组件构成的。理解这个结构，是灵活使用它的关键。
2.1 EasyTouch核心管理器：引擎的心脏
EasyTouch组件是整个插件的中枢神经系统，它是一个单例（Singleton），通常你只需要在场景中放置一个GameObject并挂上这个组件即可。它的配置面板看起来选项很多，但主要分为几大块：
1. 通用设置（General）这里定义了插件的全局行为。比如Enable Remote选项，它允许你通过Unity Remote应用在编辑器里模拟触摸，这对于调试移动端手势至关重要，我强烈建议在开发阶段一直开启。Enable twist和Enable pinch是控制是否启用旋转和捏合手势识别的总开关，如果你的游戏只需要点击和拖拽，可以关闭它们以节省一点点性能。Enable 2 fingers gesture这个选项需要注意，它决定了双指手势（如缩放、旋转）是否需要在两根手指都触摸屏幕后才触发。如果关闭，即使用户先放下一根手指，只要另一根还在屏幕上，手势也会持续计算，这能带来更流畅的连续操作体验，但逻辑上会稍微复杂一点。
2. 手势识别设置（Gestures）这是配置手势识别灵敏度的核心区域。Long tap time定义了多长时间按住算“长按”；Min swipe distance决定了手指滑动多长的距离才会被判定为“滑动手势”而非误触。这里的参数需要根据你的项目类型来调整。比如，一个快节奏的射击游戏，Min swipe distance可以设得小一些，让玩家能更快地做出闪避反应；而一个策略游戏，为了防止误操作，这个值可以设得大一些。Pinch precision和Twist precision分别控制缩放和旋转手势的识别精度，值越小越敏感。我的经验是，不要使用默认值，一定要在真机上反复测试，找到最适合你应用场景的“手感”。
2.2 三大监听器：将输入转化为游戏逻辑
Easy Touch 5提供了三种主要的监听器组件，它们负责将EasyTouch管理器识别出的原始手势，转化为具体的游戏事件。
1. Quick Touch & Quick Swipe这是最简单直接的监听器，用于处理基础的点击、按下、抬起和滑动事件。你把它挂到任何一个UI或3D物体上，它就能响应对该物体的触摸。它的工作原理是通过射线检测（Raycasting）来判断触摸点是否落在目标物体的碰撞体或RectTransform上。这里有个常见的坑：对于UI元素，确保它的Canvas渲染模式和射线投射（Raycast Target）设置正确；对于3D物体，确保它有碰撞体（Collider）。Quick Swipe是Quick Touch的扩展，专门用于处理滑动手势，你可以定义向上、下、左、右四个方向的滑动阈值。
2. Quick Drag拖拽监听器，用于实现物体的跟随手指移动。它内部处理了拖拽开始、进行中和结束的全生命周期事件。一个关键属性是Is restrict to area，如果勾选，你可以限制物体只能在一个特定的2D矩形区域内或被一个3D碰撞体范围内拖拽，这对于制作拼图、滑块UI等功能非常有用。在拖拽3D物体时，记得在On_Drag事件中，将获取到的屏幕位置（gesture.position）通过Camera.ScreenToWorldPoint或射线检测转换为世界坐标。
3. Quick Pinch & Quick Twist这两个是高级手势监听器，分别处理双指捏合（缩放）和双指旋转。它们是全局监听器，通常不挂载在特定物体上，而是放在一个全局管理器物体上。Quick Pinch会在每帧计算两指间距的变化，并输出一个float类型的缩放增量（pinch.deltaPinch）。Quick Twist则计算两指连线的角度变化，输出一个旋转增量（twist.angle）。使用它们的关键在于，在你的回调函数中，将这些增量值应用到目标物体的Transform上。例如：
void On_Pinch(Gesture gesture) { float scaleFactor = gesture.deltaPinch * pinchSensitivity; // pinchSensitivity是一个调节系数 targetTransform.localScale += Vector3.one * scaleFactor; }2.3 事件系统：通信的桥梁
所有监听器都通过C#事件（C# Events）或UnityEvent来触发回调。我强烈推荐使用C#事件的方式，因为它在性能和解耦方面更有优势。在代码中，你需要订阅（Subscribe）特定的事件：
void OnEnable() { EasyTouch.On_TouchStart += MyTouchStartMethod; QuickPinch.On_Pinch += MyPinchMethod; } void OnDisable() { EasyTouch.On_TouchStart -= MyTouchStartMethod; // 务必取消订阅，防止内存泄漏 QuickPinch.On_Pinch -= MyPinchMethod; }传递给回调方法的Gesture对象是一个信息宝库，它包含了当前所有触摸点的位置（gesture.position，gesture.touchCount）、手势开始的屏幕位置（gesture.startPosition）、滑动向量（gesture.swipe）、甚至是被触摸的物体（gesture.pickedObject）。熟练掌握从Gesture对象中提取信息，是编写复杂交互逻辑的基础。
3. 实战应用：从零构建一个可操控的3D模型查看器
理论讲得再多，不如动手做一遍。我们用一个常见的需求——在手机屏幕上通过触摸来旋转、缩放、平移查看一个3D模型——来串联Easy Touch 5的大部分核心功能。这个例子涵盖了单指拖拽旋转、双指缩放和双指平移（在Easy Touch中可通过拖拽实现），非常具有代表性。
3.1 场景与基础设置
首先，在Unity中创建一个新场景，导入你的3D模型（比如一个角色或一辆车），把它放在场景中央。然后，我们需要设置输入：
- 从Asset Store导入Easy Touch 5.0.8，并将其添加到项目中。
- 在场景中创建一个空GameObject，命名为“TouchManager”。
- 给“TouchManager”添加
EasyTouch组件。在Inspector中，确保勾选了Enable Remote、Enable Pinch和Enable Twist。根据你的模型大小，可以适当调整Pinch precision和Twist precision，比如都设为0.1。 - 继续在“TouchManager”上添加
Quick Pinch和Quick Twist组件。这两个组件我们用来接收全局的手势事件。 - 再创建一个空GameObject作为模型的容器，比如叫“ModelContainer”，将你的3D模型作为它的子对象。这样我们可以通过控制容器的Transform来整体操作模型，而不影响模型自身的层级关系。
3.2 核心控制脚本编写
接下来，我们创建一个名为ModelViewerController的C#脚本，挂载到“ModelContainer”上。这个脚本将处理所有交互逻辑。
using UnityEngine; using HedgehogTeam.EasyTouch; // 引入Easy Touch命名空间 public class ModelViewerController : MonoBehaviour { [Header("旋转控制")] public float rotationSpeed = 0.5f; // 旋转灵敏度 private bool isRotating = false; private Vector2 lastTouchPos; [Header("缩放控制")] public float zoomSpeed = 0.01f; public float minScale = 0.5f; public float maxScale = 3.0f; [Header("平移控制")] public float dragSpeed = 0.005f; private bool isDragging = false; private Vector3 dragStartPos; void OnEnable() { // 订阅单指触摸开始事件，用于旋转 EasyTouch.On_TouchStart += OnTouchStartForRotate; EasyTouch.On_TouchUp += OnTouchEnd; // 订阅拖拽事件，用于平移 EasyTouch.On_DragStart += OnDragStart; EasyTouch.On_Drag += OnDrag; EasyTouch.On_DragEnd += OnDragEnd; // 订阅捏合事件，用于缩放 QuickPinch.On_Pinch += OnPinch; // 订阅旋转事件（本例中暂不使用，但保留接口） // QuickTwist.On_Twist += OnTwist; } void OnDisable() { // 务必取消订阅！ EasyTouch.On_TouchStart -= OnTouchStartForRotate; EasyTouch.On_TouchUp -= OnTouchEnd; EasyTouch.On_DragStart -= OnDragStart; EasyTouch.On_Drag -= OnDrag; EasyTouch.On_DragEnd -= OnDragEnd; QuickPinch.On_Pinch -= OnPinch; // QuickTwist.On_Twist -= OnTwist; } // 方法1：单指触摸旋转 void OnTouchStartForRotate(Gesture gesture) { // 如果当前是双指手势或正在拖拽，则不触发旋转 if (gesture.touchCount > 1 || isDragging) return; isRotating = true; lastTouchPos = gesture.position; } void OnTouchEnd(Gesture gesture) { isRotating = false; } void Update() { if (isRotating && Input.touchCount == 1) { // 计算当前帧与上一帧的触摸位移 Touch currentTouch = Input.GetTouch(0); Vector2 deltaPos = currentTouch.deltaPosition; // 将屏幕位移转换为模型的旋转角度 float rotateX = deltaPos.y * rotationSpeed; float rotateY = -deltaPos.x * rotationSpeed; // 注意方向，通常水平移动对应Y轴旋转 // 应用旋转（绕世界坐标的Y轴和物体自身的X轴） transform.Rotate(Vector3.up, rotateY, Space.World); transform.Rotate(Vector3.right, rotateX, Space.Self); lastTouchPos = currentTouch.position; } } // 方法2：双指捏合缩放 void OnPinch(Gesture gesture) { float pinchDelta = gesture.deltaPinch * zoomSpeed; Vector3 newScale = transform.localScale + Vector3.one * pinchDelta; // 限制缩放范围 newScale = Vector3.Max(Vector3.one * minScale, Vector3.Min(Vector3.one * maxScale, newScale)); transform.localScale = newScale; } // 方法3：双指拖拽平移（这里用EasyTouch的Drag事件模拟） void OnDragStart(Gesture gesture) { // 只有双指触摸时才视为平移 if (gesture.touchCount == 2) { isDragging = true; dragStartPos = transform.position; } } void OnDrag(Gesture gesture) { if (isDragging && gesture.touchCount == 2) { // 使用两指中心点的位移来计算平移 // EasyTouch的gesture.position在两指时是中心点 Vector3 screenDelta = new Vector3(gesture.deltaPosition.x, gesture.deltaPosition.y, 0); // 将屏幕位移转换为世界位移。这里需要一个参考距离，比如模型到摄像机的Z轴距离。 float distanceToCam = Vector3.Distance(transform.position, Camera.main.transform.position); Vector3 worldDelta = Camera.main.ScreenToWorldPoint(screenDelta + new Vector3(Screen.width/2, Screen.height/2, distanceToCam)) - Camera.main.ScreenToWorldPoint(new Vector3(Screen.width/2, Screen.height/2, distanceToCam)); transform.position = dragStartPos + worldDelta * dragSpeed; } } void OnDragEnd(Gesture gesture) { isDragging = false; } }这个脚本实现了三个核心交互：
- 单指拖拽旋转：通过监听
On_TouchStart和On_TouchUp，结合Update中读取Input.touchCount和Touch.deltaPosition来实现平滑旋转。这里没有直接用EasyTouch的On_Swipe，因为我们需要的是持续拖拽而非快速滑动。 - 双指捏合缩放：直接使用
QuickPinch组件的On_Pinch事件，获取deltaPinch增量并应用到模型的localScale上，同时加了最大最小值的限制。 - 双指拖拽平移：我们巧妙地利用了EasyTouch的
On_Drag事件。通过判断gesture.touchCount == 2，将双指在屏幕上的整体移动，通过屏幕坐标到世界坐标的转换，变为模型在XZ平面（或根据摄像机角度调整）的平移。
注意：平移部分的坐标转换是难点。上述代码是一种简化方法，适用于摄像机正对模型的正交或透视视角。在更复杂的3D场景中，你可能需要根据摄像机的朝向，使用
Camera.ScreenPointToRay结合射线与某个假想平面的交点来计算精确的世界位移。
3.3 调试与手感调优
脚本写完，把“TouchManager”和“ModelContainer”都设置好，运行项目。用Unity Remote连接手机，或者在编辑器里用鼠标模拟触摸（按住Alt键+鼠标左键模拟单指，Alt+Ctrl+鼠标左键模拟双指）。
你会发现第一次运行手感可能很奇怪：旋转太快或太慢，缩放不跟手，平移方向错乱。这时候就需要回到EasyTouch组件和你的控制脚本里调整参数：
- 旋转不跟手：调整脚本中的
rotationSpeed值。通常设置在0.1到1.0之间微调。 - 缩放太灵敏：调整脚本中的
zoomSpeed，以及EasyTouch组件里的Pinch precision。Pinch precision调大（如0.5）会让缩放更“钝”，需要更大的手指开合变化才触发。 - 平移方向错误：检查
OnDrag方法中的坐标转换逻辑。一个更稳健的方法是，在OnDragStart时，记录下模型初始位置和从摄像机到初始触摸点的射线与某个世界平面（如Y=0的地面）的交点。在OnDrag中，计算当前射线与同一平面的新交点，用这两个交点的差值作为移动向量。这能保证平移方向与摄像机视角解耦。
调试的过程就是不断在真机上测试、调整参数、再测试的过程。记住，在编辑器里感觉“差不多”的手感，到真机上往往差很多，真机测试必不可少。
4. 高级技巧与性能优化实战
当你的项目从原型走向成熟，或者触摸交互变得复杂时，就需要考虑更深层次的问题了。下面分享几个我从实际项目中总结出来的高级技巧和优化点。
4.1 输入冲突的仲裁与管理
在一个复杂的UI界面中，你可能同时有需要拖拽的3D物体、可滑动的页面、可点击的按钮。如何避免“我想旋转模型，结果却滑动了下方的列表”这种输入冲突？
1. 使用手势阶段（Gesture Phase）和触摸点信息EasyTouch的Gesture对象提供了phase属性，表示手势所处的阶段（Start，Update，End）。在复杂的交互逻辑中，你可以在Start阶段就进行仲裁。例如，在你的模型旋转脚本的OnTouchStartForRotate方法开头，可以加入判断：
void OnTouchStartForRotate(Gesture gesture) { // 如果触摸起始点落在了UI元素上，则本次触摸不用于旋转模型 if (gesture.isOverGui && gesture.pickedObject != null && gesture.pickedObject.layer == LayerMask.NameToLayer("UI")) { return; } // ... 原有的旋转开始逻辑 }这里gesture.isOverGui和gesture.pickedObject是关键，它们能帮你判断触摸的初始目标。
2. 优先级与状态机为不同的交互模块设置优先级。例如，定义一个全局的输入状态枚举：
public enum InputState { Free, RotatingModel, DraggingUI, InMenu } public static InputState currentInputState = InputState.Free;在每个交互事件开始时，检查currentInputState。如果状态不是Free且不等于自身应处理的状态，则直接return。在事件结束时，将状态重置为Free。这种方法对于回合制游戏或带有明确模式切换的应用非常有效。
3. 利用Unity的EventSystem对于UI元素，最规范的做法是让它们通过Unity自带的EventSystem（如EventTrigger组件）来处理输入。EasyTouch可以与EventSystem共存。确保你的UI元素勾选了Raycast Target，并且Canvas的Graphic Raycaster正常工作。EasyTouch的QuickTouch组件在判断是否触摸到UI时，内部也是通过射线检测实现的，与EventSystem的机制类似。保持UI输入处理在EventSystem体系内，能减少很多不必要的冲突。
4.2 性能敏感场景下的优化策略
EasyTouch本身开销不大，但在低端移动设备上，或者每帧需要处理大量基于触摸的游戏逻辑时，以下几点优化能带来可观的性能提升：
1. 减少不必要的射线检测QuickTouch、QuickSwipe等组件每帧都会对触摸点进行射线检测，以判断是否触摸到了挂载该组件的物体。如果场景中有大量可交互但当前并不需要交互的物体，这会产生不必要的开销。
- 优化方案：动态启用/禁用监听器组件。例如，只有当玩家进入某个区域时，才通过代码
GetComponent<QuickTouch>().enabled = true来激活该区域内物体的触摸监听。 - 替代方案：对于大量同类型的物体（比如一堆可收集的硬币），不要每个都挂
QuickTouch。可以只在一个全局管理器上挂一个QuickTouch，然后在它的On_TouchStart事件中，通过物理OverlapSphere或网格查找算法，来批量判断触摸点附近有哪些物体被“点击”了。
2. 降低手势识别的事件频率EasyTouch组件在Advanced设置里，有一个Gesture rate（手势更新率）参数。它定义了每秒计算手势（如滑动向量、捏合距离）的次数。默认是60次/秒，即每帧都计算。对于一些对实时性要求不高的手势（如长按确认），你可以将这个值降低到30甚至15，能减少一些计算量。
3. 避免在事件回调中进行昂贵操作在On_Pinch、On_Drag等每帧触发的事件回调中，尽量避免进行以下操作：
- 复杂的物理查询（如
Physics.RaycastAll）。 - 查找游戏对象（
GameObject.Find，GetComponent），尽量在Start或Awake中缓存引用。 - 动态实例化/销毁对象（
Instantiate，Destroy）。 如果必须进行，可以考虑使用协程（Coroutine）分帧处理，或者将计算结果缓存起来复用。
4. 针对WebGL平台的特别注意事项如果你要发布到WebGL（比如微信小游戏），需要特别注意。WebGL的输入系统是基于浏览器的，与原生移动端有差异。EasyTouch 5.0.8对WebGL的支持基本是OK的，但务必测试以下几点：
- 多点触控：在Chrome和Safari浏览器上的表现可能不同。
- 鼠标模拟：在PC浏览器上用鼠标操作时，右键和滚轮事件是否被正确映射为触摸手势。
- 事件冒泡：防止触摸事件意外触发浏览器默认行为（如页面滚动）。可以在初始化时尝试调用
EasyTouch.SetEnableAutoSelect(true)，并确保你的Canvas设置正确。
一个常见的WebGL性能问题是，如果页面失去焦点，Update循环可能还在运行，导致不必要的计算。可以在OnApplicationPause事件中，禁用EasyTouch组件：
void OnApplicationPause(bool pauseStatus) { EasyTouch.instance.enabled = !pauseStatus; }4.3 扩展：实现自定义复杂手势
虽然EasyTouch提供了几种基础手势，但有时你需要更特别的，比如三指上滑、画圈、双击等。EasyTouch的架构允许你在其基础上进行扩展。
实现双击（Double Tap）EasyTouch没有原生的双击事件，但我们可以利用On_TouchStart和计时器轻松实现。
private float lastTapTime; private float doubleTapThreshold = 0.3f; // 双击时间间隔阈值 void OnEnable() { EasyTouch.On_TouchStart += OnTouchStartForDoubleTap; } void OnTouchStartForDoubleTap(Gesture gesture) { if (gesture.touchCount == 1) { float currentTime = Time.time; if (currentTime - lastTapTime < doubleTapThreshold) { // 双击成功！ Debug.Log("Double Tap Detected!"); // 重置时间，防止连续三次触摸被误判为两次双击 lastTapTime = 0; // 触发你的双击逻辑... } else { lastTapTime = currentTime; } } }实现自定义笔势（例如画“√”）这需要更复杂的轨迹识别。一个简单的思路是：
- 在
On_Drag或On_Swipe事件中，持续记录触摸点的位置序列（List<Vector2>）。 - 当手指抬起（
On_TouchUp）时，对这个点序列进行分析。 - 分析算法可以包括：计算整体移动方向、拐点检测、与预设模板的匹配度（如使用动态时间规整DTW算法）等。 虽然实现完整的笔势识别引擎工作量较大，但对于识别固定方向的简单勾画，通过判断点序列的大致角度变化就能做到。
5. 常见问题排查与避坑指南
即使按照文档操作，在实际开发中你还是会遇到各种各样的问题。下面我整理了一份“踩坑实录”，希望能帮你快速排雷。
5.1 手势无响应或响应错乱
这是最常见的一类问题，通常由以下原因导致：
| 问题现象 | 可能原因 | 排查步骤与解决方案 |
|---|---|---|
| 点击/触摸完全没反应 | 1.EasyTouch组件未启用。2. 监听器组件（如 QuickTouch）未挂载或未启用。3. 触摸对象缺少碰撞体（Collider）或UI元素未开启 Raycast Target。4. 有其他UI面板覆盖，且挡住了射线。 | 1. 检查Hierarchy中EasyTouch实例的激活状态。2. 检查目标物体上的监听器组件是否勾选启用。 3. 对于3D对象，添加 MeshCollider或BoxCollider；对于UI，检查Image或Text组件的Raycast Target。4. 检查Canvas层级，确保可交互对象在最上层。可以使用 EasyTouch的Show touches调试选项，在Game视图显示触摸点，看是否落在预期位置。 |
| 双指缩放/旋转不生效 | 1.EasyTouch组件中Enable Pinch或Enable Twist未勾选。2. QuickPinch或QuickTwist组件未添加或未启用。3. 脚本中未正确订阅事件（ On_Pinch/On_Twist）。4. 在编辑器测试时，未用正确方式模拟双指（需Alt+Ctrl+鼠标左键）。 | 1. 确认EasyTouch管理器上的总开关已打开。2. 确认场景中存在已启用的 QuickPinch/QuickTwist组件。3. 检查脚本的 OnEnable中是否订阅了事件，方法名是否正确，并且OnDisable中取消订阅。4. 使用Unity Remote连接真机进行测试，这是最可靠的方式。 |
| 拖拽物体时“粘手”或跳动 | 1. 坐标转换错误。将屏幕坐标直接赋值给了世界坐标。 2. 拖拽逻辑每帧应用的是绝对位置，而非增量。 3. 物体的碰撞体形状或位置异常。 | 1. 确保使用Camera.ScreenToWorldPoint并传入正确的Z值（通常是物体到摄像机的距离）。对于UI拖拽，应使用RectTransform.anchoredPosition。2. 在 On_Drag事件中，使用gesture.deltaPosition（本帧与上一帧的位移差值）而非gesture.position（当前绝对位置）。3. 检查碰撞体是否完全包裹住物体，拖拽时射线检测点是否稳定。 |
5.2 与其他系统或插件的兼容性问题
1. 与新版Unity Input System的冲突如果你的项目同时使用了新的Input System Package和EasyTouch，可能会发生输入事件被处理两次的情况。因为两者都可能监听底层输入。解决方案是“二选一”：
- 方案A（推荐）：在Player Settings的
Active Input Handling中，选择Input Manager (Old)。EasyTouch完全基于旧的Input Manager。 - 方案B：如果必须使用新的Input System，则需要通过设置让EasyTouch失效，或者自己编写一个适配层，将Input System的输入事件转发成EasyTouch能识别的格式，但这比较麻烦。
2. 与NGUI、FairyGUI等第三方UI框架的兼容这些UI框架有自己的事件系统。通常，只要确保EasyTouch的触摸射线能正确穿透到UI层即可。需要检查：
- 第三方UI的摄像机深度是否高于EasyTouch用于射线检测的摄像机（通常是Main Camera）。
- 第三方UI的元素是否提供了正确的碰撞信息。有时需要在EasyTouch的
EasyTouch组件中，调整Raycast Layer Mask，确保包含了UI所在的层。
3. 在AR/VR项目中的应用在ARFoundation或VR项目中，屏幕空间的概念可能发生变化。EasyTouch的输入是基于屏幕（Screen Space）的。在VR里，你可能需要将手柄的射线交互转换为屏幕坐标。在AR里，如果触摸是针对3D空间中的AR物体，你需要确保用于射线检测的摄像机是正确的AR摄像机，并且物体的碰撞体与真实的AR模型对齐。这可能需要对EasyTouch的工作流程进行较大改造，有时直接使用AR/VR SDK提供的交互工具包会更高效。
5.3 版本升级与项目迁移
从EasyTouch 4升级到5，或者在不同小版本间迁移，可能会遇到API变更。5.0.8相对于更早的5.x版本，通常更加稳定。
- 备份：升级前，务必备份整个项目。
- 查看日志：导入新版本后，首先查看Unity Console是否有编译错误或过时API警告（
Obsolete）。 - 逐步替换：最常见的变更是事件回调方法的签名。例如，某些版本中
Gesture参数的类型或命名空间可能变了。根据错误提示，逐个修改订阅事件的方法签名。 - 测试核心功能：升级后，重点测试所有触摸交互功能，特别是复杂手势和边界情况。
最后，关于“紫屏”或材质丢失的问题（有时在热更新或AssetBundle打包后出现），这通常不是EasyTouch直接导致的，而是Unity资源管理或着色器变体收集的问题。但如果你发现只有在涉及EasyTouch的UI或物体上出现，可以检查一下EasyTouch的预制体或示例场景中，是否使用了特殊的Shader，确保这些Shader被打包到了最终构建中。
