好的,我们来详细梳理一下 Unity3D 中 UnityEngine.EventSystems 命名空间下的常用接口。这个命名空间是 Unity UI 系统的核心,用于处理基于输入的事件(如点击、拖拽、选择等),它解耦了输入设备和 UI 逻辑,使得处理交互变得更加模块化和高效。
对惹,这里有一个游戏开发交流小组984358500,希望大家可以点击进来一起交流一下开发经验呀!
核心概念
在了解接口之前,必须先理解两个核心组件:
- EventSystem: 场景中必须有一个且只能有一个的全局管理器。它负责处理输入、射线检测,并将事件分发给正确的对象。Raycaster: 射线检测器,用于检测输入事件应该由哪个 UI 元素或 3D/2D 物体接收。常用的有:
- GraphicRaycaster: 用于 UI Canvas。PhysicsRaycaster: 用于 3D 物体。Physics2DRaycaster: 用于 2D 物体。
最常用的接口
这些接口需要挂在 GameObject 上,并实现其对应的方法。当该物体被相应的射线检测器(如 GraphicRaycaster)检测到,并且满足条件时,这些方法就会被 EventSystem 调用。
1. 指针(鼠标/触摸)事件
这是最常用的一组接口,用于处理鼠标和触摸输入。
- IPointerClickHandler
- 作用: 处理点击/触碰事件(按下并在同一对象上释放)。常用方法:
public void OnPointerClick(PointerEventData eventData)
- 注意: OnPointerClick 会在 OnPointerUp 之后被调用,且只有在按下和释放是同一个对象时才触发。
- IPointerDownHandler
- 作用: 当指针(鼠标按键/手指)按下时触发。常用方法:
public void OnPointerDown(PointerEventData eventData)
- IPointerUpHandler
- 作用: 当指针(鼠标按键/手指)抬起时触发。注意:即使抬起时光标不在原物体上,只要按下时在该物体上,此方法也会被调用。常用方法: public void OnPointerUp(PointerEventData eventData)
- IPointerEnterHandler
- 作用: 当指针进入物体区域时触发(类似 UI 的 OnMouseEnter)。常用方法: public void OnPointerEnter(PointerEventData eventData)
- IPointerExitHandler
- 作用: 当指针离开物体区域时触发(类似 UI 的 OnMouseExit)。常用方法: public void OnPointerExit(PointerEventData eventData)
- IDragHandler
- 作用: 处理拖拽事件(在物体上按下并移动)。常用方法: public void OnDrag(PointerEventData eventData)
- 注意: 通常需要同时实现 IBeginDragHandler 和 IEndDragHandler。
- IBeginDragHandler
- 作用: 当拖拽开始时(满足拖拽阈值后)触发一次。常用方法: public void OnBeginDrag(PointerEventData eventData)
- IEndDragHandler
- 作用: 当拖拽结束(指针抬起)时触发一次。常用方法
- public void OnEndDrag(PointerEventData eventData)
2. 选择(Selection)事件
主要用于处理对象被 EventSystem 选中或取消选中的逻辑,常用于输入框(InputField)或自定义可选中对象。
- ISelectHandler
- 作用: 当对象被选中时触发(例如用鼠标点击或通过键盘导航选中)。常用方法: public void OnSelect(BaseEventData eventData)
- IDeselectHandler
- 作用: 当对象失去选择时触发。常用方法:
- public void OnDeselect(BaseEventData eventData)
3. 其他重要接口
- IScrollHandler
- 作用: 当鼠标滚轮在物体上滚动时触发。常用方法: public void OnScroll(PointerEventData eventData)
- IMoveHandler
- 作用: 当使用键盘方向键(或WASD)移动“选择”时触发(例如在菜单项之间导航)。常用方法: public void OnMove(AxisEventData eventData)
- ISubmitHandler & ICancelHandler
- 作用: 通常用于模拟“提交”(如回车键/手柄A键)和“取消”(如ESC键/手柄B键)操作。常用方法:
public void OnSubmit(BaseEventData eventData) // 提交 public void OnCancel(BaseEventData eventData) // 取消

使用示例:一个简单的按钮逻辑
using UnityEngine; using UnityEngine.EventSystems; public class CustomButton : MonoBehaviour, IPointerClickHandler, IPointerEnterHandler, IPointerExitHandler { public void OnPointerClick(PointerEventData eventData) { Debug.Log("按钮被点击了!"); // 在这里执行点击后的逻辑,例如加载场景、生成物体等 } public void OnPointerEnter(PointerEventData eventData) { Debug.Log("鼠标移入了"); // 可以在这里做高亮效果,例如改变颜色、缩放等 transform.localScale = Vector3.one * 1.1f; } public void OnPointerExit(PointerEventData eventData) { Debug.Log("鼠标移出了"); // 恢复原状 transform.localScale = Vector3.one; } }
关键数据类:PointerEventData
几乎所有指针事件接口的方法都会传入一个 PointerEventData 类型的参数,它包含了丰富的事件上下文信息,例如:
- position: 指针的屏幕坐标。delta: 指针自上一帧的移动量(对于拖拽非常有用)。button: 触发事件的鼠标按键(左键、右键等)。pointerCurrentRaycast: 当前帧射线检测命中的结果。pointerPress: 当前被按下的游戏对象。dragObject: 当前被拖拽的游戏对象。selectedObject: 当前被选中的游戏对象。
总结与工作流程
- 必备设置: 确保场景中有且仅有一个 EventSystem GameObject(创建 UI Canvas 时会自动创建)。根据需要添加 GraphicRaycaster (在Canvas上)、PhysicsRaycaster (在Camera上) 等。实现接口: 在你的脚本中实现一个或多个所需的事件接口。编写逻辑: 在接口对应的回调方法(如 OnPointerClick)中编写你的业务逻辑。使用数据: 利用 PointerEventData 参数获取详细的输入信息。
通过这套系统,你可以为 UI 元素、3D 物体或 2D 精灵轻松创建复杂而灵活的交互逻辑。
免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删