How to Develop a Game
UI Event System
PublishDate: 2025-06-01 | CreateDate: 2025-06-01 | LastModify: 2025-06-01 | Creator：ljf12825

Event System是Unity UI System中的核心交互管理器，掌控了所有鼠标点击、键盘输入、触摸事件、UI导航的逻辑

Unity的Event System是一个处理用户输入事件的系统，用于发送“点击了谁”“选中了谁”之类的事件，属于UnityEngine.EventSystems命名空间

EventSystemPanel

组件用途
Event System整个输入系统的“大脑”
Input Module输入方式模块，比如处理鼠标、键盘、手柄（你可以切换）
Raycaster（挂在 Canvas 或 3D 对象上）实际检测点击了哪个物体，比如：GraphicRaycaster, PhysicsRaycaster
Event Trigger通过Inspector可视化配置多种事件响应
Touch Input Module输入方式模块，专门负责处理触摸输入事件，适用于手机、平板等触控设备

EventSystem会追踪以下交互：

类型描述接口
点击 Click鼠标/触摸点击 UIIPointerClickHandler
拖拽 Drag拖拽 ScrollRect、物品、滑块IDragHandler, IBeginDragHandler, IEndDragHandler
悬停 Hover鼠标移动到 UI 上IPointerEnterHandler, IPointerExitHandler
按钮按下长按、释放IPointerDownHandler, IPointerUpHandler
键盘导航方向键移动焦点IMoveHandler
输入表单输入ISubmitHandler, ISelectHandler

任何的UI交互脚本，都是通过这些接口连接到Event System

EventSystem的工作流程图

[鼠标/键盘/触摸输入]
      ↓
[Input Module] → 分析输入（比如点击、拖动、导航）
      ↓
[Raycaster] → 检测点击了哪个 UI 元素
      ↓
[EventSystem] → 通知对应的组件执行接口函数（如 OnClick）

EventSystem Component

EventSystem

挂载在GameObject上，只有一个
功能：

EventSystem Panel

属性含义
First Selected初始选中的 UI 对象（用于导航/手柄）
Send Navigation Events是否允许方向键或手柄移动选中项
Drag Threshold拖拽时鼠标/手指移动多少才视为“拖拽”

Standalone Input Module

适合：鼠标 + 键盘控制
Unity默认生成
功能：把输入映射为事件（点击、拖动、导航）

属性说明
Send Pointer Hover To Parent是否强制启用这个模块
Horizontal Axis / Vertical Axis对应键盘方向键（默认是 “Horizontal” 和 “Vertical”）
Submit Button / Cancel Button默认是 “Submit”（Enter）和 “Cancel”（Esc）
Input Actions Per Second每秒导航几次
Repeat Delay长按导航前的延迟时间

Input System UI Input Module（新系统）

详见Input System

适合：新版Unity Input System（使用Input Actions的）

属性说明
Actions Asset你设置好的 .inputactions 文件
Point / Click / Navigate / Submit 等分别绑定触摸、点击、方向等操作
Move Repeat Rate / Delay同样是手柄方向键长按节奏

Raycaster

EventSystem本身不会知道你点到谁，它需要Raycaster组件配合UI或3D元素

Graphic Raycaster（用于Canvas UI）

挂在Canvas上，专门检测UI元素是否被点中

Canvas Graphic Raycaster

Physics Raycaster（用于3D物体）

挂在摄像机上，配合3D对象（带Collider）使用，检测鼠标是否点击到物体

Physics2D Raycaster（用于2D物体）

配合2D Collider检测点击或拖动等交互

Event Trigger

内部原理

优点缺点
方便快捷，适合快速绑定事件性能稍差，复杂项目不建议大量使用
无需写代码，设计灵活事件流程不透明，调试困难
适合简单交互原型绑定过多事件会影响维护和阅读

EventTrigger适用于设计师或非程序员，使其能够在Inspector里直接配置各种事件响应

Touch Input Module

工作原理

1.检测触摸事件
TouchInputModule监听Input.touches，获取当前所有触摸点
2.生成PointerEventData
每个触摸点对应一个PointerEventData，包含位置、按下时间、手指ID等信息
3.射线检测
根据触摸点位置对场景进行射线检测，找到被触摸的UI或物体
4.事件分发
通过ExecuteEvents把对应事件派发给目标物体的事件处理接口
5.处理多点触控
支持同时跟踪多个触摸点，分别生成和管理多个PointerEventData

API

Static Properties

属性描述
current返回当前EventSystem

Properties

属性类型说明
alreadySelectingbool只读属性，表示 EventSystem 当前是否正在执行 SetSelectedGameObject()。
一般用于内部防止递归调用选中事件。
currentInputModuleBaseInputModule当前正在使用的输入模块（如 StandaloneInputModule 或 InputSystemUIInputModule）。
currentSelectedGameObjectGameObject当前选中的 UI 对象（例如当前焦点在某个按钮上时，这就是那个按钮）。
firstSelectedGameObjectGameObject场景加载或 EventSystem 启动时最初被选中的对象（通常用于手柄/键盘导航）。
isFocusedbool表示 EventSystem 是否处于“聚焦”状态。
在 PC 上，这通常意味着游戏窗口是否处于激活状态（失焦时不响应输入）。
pixelDragThresholdint拖动时鼠标或手指要移动多少像素才算开始拖拽（用来防止误触拖动）。默认是 5。
sendNavigationEventsbool是否启用方向键/手柄的导航事件（如按 ↑↓←→ 移动 UI 选择框）。关闭后不能用方向键移动焦点。

Public Methods

方法作用常见用途
IsPointerOverGameObject()判断鼠标/手指是否悬停在 UI 上做点击穿透判断
RaycastAll()手动执行一次 UI 射线检测获取所有命中的 UI 元素
SetSelectedGameObject()设置当前聚焦的 UI控制导航焦点
UpdateModules()刷新输入模块很少手动用，一般系统自动处理

Focus

在UI系统中，焦点（Focus）是指当前“被选中、正在响应输入”的UI元素

它表现为：

焦点只对以下操作有效：

操作依赖焦点
按方向键移动 UI 选择依赖
按 Enter 提交按钮依赖
输入框自动聚焦后可打字依赖
鼠标点击按钮不依赖焦点（靠点击 Raycast）
EventSystem.current.currentSelectedGameObject

这就是当前拥有焦点的那个UI元素

示例

1.打开页面时设置初始焦点

public GameObject defaultButton;

void OnEnable()
{
  EventSystem.current.SetSelectedGameObject(null); // 清空旧焦点
  EventSystem.current.SetSelectedGameObject(defaultButton);
}

2.按键触发当前焦点的“提交”

void Update()
{
  if (Input.GetKeyDown(KeyCode.Return))
  {
    var go = EventSystem.currentSelectedGameObject;

    if (go != null)
        ExecuteEvents.Execute<ISubmitHandler>(go, new BaseEventData(EventSystem.current), ExecuteEvents.submitHandler);
  }
}

焦点与导航（方向键控制）

每个SelectableUI（比如 Button、Toggle、InputField）都有导航设置

Navigation nav = myButton.navigation;
nav.mode = Navigation.Mode.Eplicit;
nav.delectOnRight = anotherButton;
myButton.navigation = nav;

按下方向键，跳转到指定的UI元素

用户可以通过键盘、手柄、遥控器等输入设备，在UI组件之间切换焦点并触发交互

导航的核心是EventSystem，它负责追踪当前的Selected GameObject，处理导航方向输入

Selectable系列组件包含导航信息，决定方向键或手柄移动时焦点跳转到哪个元素，UI组件都继承自Selectable类

属性：

建议

常见问题