Unity MyFramework 用法说明(三十):使用 GlobalTouchSystem 统一处理 UI 与场景交互
上一篇介绍了InputSystem它负责收集鼠标和触摸状态。但触点按下之后到底命中了哪个 UI、哪个场景物体以及事件是否继续向下穿透还需要另一套系统处理。MyFramework 使用GlobalTouchSystem统一完成 UI 与场景物体的射线检测和交互事件分发。项目地址https://github.com/ZHOURUIH/MyFramework一、GlobalTouchSystem 负责什么GlobalTouchSystem的定位是替代传统 UGUIEventSystem让框架中的 UI 和场景对象使用同一套交互流程。它主要负责注册可交互对象 按照显示层级检测 UI 按照距离检测场景物体 处理点击、按下、悬停和移动 管理射线穿透 支持多个摄像机 限制当前允许操作的对象整体流程为InputSystem 收集触点 ↓ GlobalTouchSystem 发射射线 ↓ 先检测 UI ↓ 允许穿透时继续检测场景对象 ↓ 向命中的对象发送交互事件二、注册普通 UI 点击UI 节点使用myUGUIObject注册public class UIMain : LayoutScript { protected myUGUIObject mStartButton; public override void assignWindow() { newObject(out mStartButton, StartButton); } public override void onGameState() { base.onGameState(); mStartButton.registeCollider( onStartClick); } protected void onStartClick() { log(点击开始游戏); } }注册时框架会查找或创建碰撞体 将节点加入 GlobalTouchSystem 注册点击回调 默认阻挡后方射线 开启节点更新节点不需要挂 Unity 原生的Button组件。需要按钮的悬停变暗和按下位移效果时可以使用mStartImage.registeColliderImage( onStartClick);其中mStartImage为myUGUIImageSimple。三、监听更完整的交互状态除了点击还可以同时监听悬停和按下状态mStartButton.registeCollider( onStartClick, onStartHover, onStartPress); protected void onStartClick() { log(点击); } protected void onStartHover(bool hover) { log(悬停状态: hover); } protected void onStartPress(bool press) { log(按下状态: press); }框架中的ComponentInteractive还支持单击与双击 触点进入与离开 触点按下与抬起 触点移动与静止 长按 全屏按下与抬起 拖拽悬停与接收例如注册长按mStartButton.addLongPress( onLongPress, 1.0f); protected void onLongPress() { log(长按1秒); }四、注册场景中的物体场景物体需要继承或包装为MovableObject并指定用于射线检测的摄像机protected MovableObject mMonster; protected void initMonster() { mMonster.setClickCallback( onMonsterClick); mMonster.setHoverCallback( onMonsterHover); mMonster.setPassRay(false); mGlobalTouchSystem.registeCollider( mMonster, mCameraManager.getMainCamera()); } protected void onMonsterClick() { log(点击怪物); } protected void onMonsterHover(bool hover) { log(怪物悬停: hover); }场景对象必须能够获得Collider。GlobalTouchSystem会根据射线交点与摄像机的距离排序优先通知距离更近的对象。MovableObject.destroy()时会自动从系统中注销不需要业务层再次清理。五、UI 为什么会优先于场景物体全局射线检测会先遍历 UI 摄像机按照摄像机深度排序 ↓ 按照 UI 深度排序 ↓ 检测命中的 UI 节点只有 UI 允许射线继续穿透时才会检测场景物体。因此玩家点击界面按钮时不会同时点中按钮后面的怪物。UI 的前后关系由框架生成的UIDepth决定而不是简单依赖对象注册顺序。六、控制射线穿透默认注册点击节点时不允许穿透mButton.registeCollider( onClick);等价于mButton.registeCollider( onClick, false);需要点击自己后继续检测下方对象mTransparentArea.registeCollider( onAreaClick, true);也可以单独修改mTransparentArea.setPassRay(true);射线穿透适合纯装饰 UI 不会阻挡场景操作的透明区域 需要同时通知上下层对象的特殊交互普通按钮、输入框和滑动区域通常不应该穿透。七、滑动区域中的父子节点滑动列表中子节点只有位于Viewport范围内时才应该响应点击。框架可以绑定bindPassOnlyParent(mViewport);它表示子节点必须位于父节点碰撞区域内 才能继续接收射线检测LayoutScript.registeScrollRect()已经会自动完成相关注册registeScrollRect( mScroll, mViewport, mContent);业务层一般不需要再手动处理滑动列表的射线裁剪。八、限制当前可操作对象新手引导经常要求玩家只能点击指定按钮其他位置都不响应。可以设置mGlobalTouchSystem.setActiveOnlyObject( mGuideButton);如果目标位于滑动列表或多层父节点中应使用mGlobalTouchSystem .setActiveOnlyObjectWithAllParent( mGuideButton);它会把目标及已经注册的父节点一起加入允许列表保证父级滑动或遮罩逻辑仍然正常。允许多个对象mGlobalTouchSystem.addActiveOnlyObject( mConfirmButton); mGlobalTouchSystem.addActiveOnlyObject( mCancelButton);解除限制时可以传入空对象mGlobalTouchSystem.setActiveOnlyObject( null);这类接口适合新手引导 强制确认弹窗 指定区域教学 UGC 编辑器当前工具限制九、查询当前位置命中的对象需要主动判断鼠标当前指向谁时可以调用IMouseEventCollect hoverObject mGlobalTouchSystem.getHoverObject( Input.mousePosition);获取全部命中对象protected HashSetIMouseEventCollect mHoverList new(); protected void checkHover() { mGlobalTouchSystem.getAllHoverObject( mHoverList, Input.mousePosition); }返回列表已经按照 UI 层级或场景距离排列可以用于拖拽目标检测、编辑器选择和自定义提示。十、对象生命周期注册过的对象不应绕过框架直接销毁。UI 节点通过框架销毁时会自动执行mGlobalTouchSystem.unregisteCollider( window);MovableObject.destroy()也会自动注销。需要临时取消交互但保留对象时可以使用mButton.setHandleInput(false);恢复mButton.setHandleInput(true);这比反复注册和注销更适合短时间禁用按钮。十一、总结MyFramework 的输入处理分为两层InputSystem 收集键盘、鼠标和触摸状态 GlobalTouchSystem 检测触点命中的对象并分发事件常用接口包括obj.registeCollider(...); obj.registeColliderImage(...); obj.setPassRay(...); obj.setHandleInput(...); mGlobalTouchSystem.registeCollider( movable, camera); mGlobalTouchSystem.setActiveOnlyObject(...); mGlobalTouchSystem.getHoverObject(...);通过统一管理 UI 深度、场景距离、射线穿透和对象生命周期业务层不需要分别维护 UGUI 点击、Physics Raycast 和移动端触摸逻辑。

相关新闻

Framework 数据泄露:处理获赞也遭质疑,客户需防钓鱼与盗窃风险

Framework 数据泄露:处理获赞也遭质疑,客户需防钓鱼与盗窃风险

Framework 数据泄露引关注:处理方式获赞,也遭质疑,客户需防钓鱼与盗窃 2026 年 8 月 6 日晚上 10:37,marsmathis 收到一封关于有限数据泄露的邮件,此次泄露导致客户信息外流(无账单信息)。他认为…

2026/10/22 13:41:08 阅读更多 →
揭秘行业内幕:如何选择靠谱的安阳网站建设公司避坑指南

揭秘行业内幕:如何选择靠谱的安阳网站建设公司避坑指南

在这个数字化浪潮席卷全球的时代,企业的生命线早已不仅仅是线下的门店或推销电话,而是延伸到互联网的每一个角落。对于安阳的老板们来说,拥有一张漂亮的“网络名片”——也就是企业官网,已经不再是可选项,而是生存的必需品。然而,当你在搜索引擎里输入“安阳网站建设公司…

2026/10/22 10:47:22 阅读更多 →
设备OEE自动计算:从手工Excel到实时看板

设备OEE自动计算:从手工Excel到实时看板

一、背景故事:真实场景切入在半导体Fab的生产一线,工程师每天面对的不是教科书里的理想模型,而是充满噪声的实际工况。设备报警、良率波动、数据不一致、系统响应慢——这些问题轮番登场,考验着每一个从业者的判断力和执行力。今天…

2026/10/22 17:46:24 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/10/22 10:18:38 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/10/22 11:01:53 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/10/22 9:44:47 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/10/22 10:42:00 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/10/22 10:40:08 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/10/22 10:56:37 阅读更多 →

日新闻

周新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型(GMM)的语音识别系统,很多人第一反应就是一堆数学公式,觉得门槛很高。但如果你真的在MATLAB里把它落地跑通,会发现核心其实就是三件事:把声音变成特征向量,用GMM给每个类别…

2026/10/22 1:47:45 阅读更多 →
数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人,但落到具体操作上,无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程:对图像做反白、改调色板、彩色转灰度,最后把像素数据导出成txt文件。单看每一…

2026/10/22 21:33:42 阅读更多 →
机器人大脑技术盘点:具身智能的感知、决策与数据闭环

机器人大脑技术盘点:具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词,你会发现一个很有意思的现象:每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型,有人指的是运动控制系统,还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/22 5:12:39 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/22 22:56:44 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/22 22:56:12 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/22 19:06:46 阅读更多 →