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/8/8 0:38:43 阅读更多 →
揭秘行业内幕:如何选择靠谱的安阳网站建设公司避坑指南

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

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

2026/8/8 0:37:42 阅读更多 →
设备OEE自动计算:从手工Excel到实时看板

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

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

2026/8/8 0:36:42 阅读更多 →

最新新闻

从大语言模型到神经解码:技术范式转变与工程实践

从大语言模型到神经解码:技术范式转变与工程实践

在实际技术领域,从一家大型、成熟的AI研究机构转向一家专注于前沿、甚至有些科幻色彩技术(如“心灵感应技术”)的初创公司,是一个极具话题性的职业选择。这背后往往涉及对技术栈、工程挑战、个人愿景和行业趋势的深刻思考。虽然我…

2026/8/8 3:31:17 阅读更多 →
Matlab/Simulink混合动力汽车建模与仿真实践

Matlab/Simulink混合动力汽车建模与仿真实践

1. 项目概述:混合动力汽车建模的意义与挑战在汽车工业向电气化转型的大背景下,插电式混合动力汽车(PHEV)凭借其兼顾燃油经济性和续航能力的特性,已成为市场主流选择之一。作为一名长期从事汽车电控系统开发的工程师&am…

2026/8/8 3:31:17 阅读更多 →
华中师范大学研究生学位论文排版全攻略:从规范解读到Word/LaTeX高效实操

华中师范大学研究生学位论文排版全攻略:从规范解读到Word/LaTeX高效实操

1. 项目概述:从“规范”到“效率”的实战之路又到了一年一度的毕业季,对于华中师范大学的研究生同学来说,除了实验数据、理论分析和文献综述,还有一座绕不过去的大山——学位论文的格式排版。我见过太多同学,学术内容扎…

2026/8/8 3:31:17 阅读更多 →
扑克牌游戏策略与心理战术全解析

扑克牌游戏策略与心理战术全解析

1. 玩牌的精彩瞬间解析扑克牌作为流传数百年的经典游戏,在不同文化背景中演化出无数种玩法。从家庭聚会到专业赛事,从休闲娱乐到心理博弈,纸牌游戏总能创造出令人难忘的精彩时刻。这些瞬间往往包含着策略、运气与心理的完美结合。2. 经典牌局…

2026/8/8 3:31:17 阅读更多 →
Node.js Event Loop机制与异步任务处理详解

Node.js Event Loop机制与异步任务处理详解

1. Node Event Loop 机制深度解析作为 Node.js 的核心机制,Event Loop 决定了 JavaScript 代码的执行顺序和异步任务的处理方式。我在实际开发中遇到过不少由于对 Event Loop 理解不深导致的 bug,比如定时器不准、回调顺序错乱等问题。今天就来详细拆解这…

2026/8/8 3:31:17 阅读更多 →
基于Flask+Vue的红色旅游管理系统架构设计

基于Flask+Vue的红色旅游管理系统架构设计

1. 项目概述:河南红色旅游景点管理系统的技术架构这个项目是一个典型的旅游行业信息化解决方案,采用前后端分离架构实现。前端使用Vue.js构建响应式管理界面,后端采用Flask框架提供RESTful API服务,数据库层使用Django ORM进行抽象…

2026/8/8 3:30:17 阅读更多 →

日新闻

AI多智能体时代来临,读懂MCP与A2A架构,抢占企业数字化新风口

AI多智能体时代来临,读懂MCP与A2A架构,抢占企业数字化新风口

当下AI应用飞速普及,无数企业下场搭建智能体系统,可落地阶段难题接踵而至:上下文无限堆积频繁爆栈、AI工具调用准确率低下、Token成本居高不下、企业数据权限混乱暗藏安全隐患……很多团队卡在架构搭建环节,空有前沿技术概念&…

2026/8/8 0:00:07 阅读更多 →
PHP二维码生成终极指南:用chillerlan/php-qrcode打造专业级二维码

PHP二维码生成终极指南:用chillerlan/php-qrcode打造专业级二维码

PHP二维码生成终极指南:用chillerlan/php-qrcode打造专业级二维码 【免费下载链接】php-qrcode A PHP QR Code generator and reader with a user-friendly API. 项目地址: https://gitcode.com/gh_mirrors/ph/php-qrcode 在当今数字时代,二维码已…

2026/8/8 0:00:08 阅读更多 →
UniApp微信小程序隐私保护组件开发:从原理到实战

UniApp微信小程序隐私保护组件开发:从原理到实战

1. 项目缘起:为什么我们需要一个隐私保护通用组件?最近在维护一个基于uniapp开发的微信小程序矩阵时,我遇到了一个非常棘手的问题。随着平台对用户隐私保护的要求越来越严格,几乎每一个新版本发布,或者在某些特定机型&…

2026/8/8 0:00:08 阅读更多 →

周新闻

最大流算法详解:从水管网络到Ford-Fulkerson与Dinic实战

最大流算法详解:从水管网络到Ford-Fulkerson与Dinic实战

1. 从水管网络到最大流:一个核心问题的诞生想象一下,你是一个城市供水系统的总工程师。你的城市有多个水源(水库),需要通过一个复杂的地下管道网络,将水输送到各个居民区。每条管道都有其最大通水能力&…

2026/8/6 22:02:27 阅读更多 →
基于Springboot的企业门户网站(源码+LW+调试文档+讲解)

基于Springboot的企业门户网站(源码+LW+调试文档+讲解)

温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片! 温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片! 温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台…

2026/8/6 22:02:27 阅读更多 →
MATLAB xcorr函数详解:从互相关原理到四大实战应用

MATLAB xcorr函数详解:从互相关原理到四大实战应用

1. 从一次信号“找茬”说起:为什么我们需要互相关几年前,我在处理一组声学传感器数据时遇到了一个棘手的问题。我有两个麦克风记录了一段相同的音频信号,理论上它们接收到的声音波形应该非常相似,只是由于麦克风位置不同&#xff…

2026/8/7 23:24:08 阅读更多 →

月新闻

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南 【免费下载链接】BaiduNetdiskPlugin-macOS For macOS.百度网盘 破解SVIP、下载速度限制~ 项目地址: https://gitcode.com/gh_mirrors/ba/BaiduNetdiskPlugin-macOS 还在为百度网盘macOS版的龟速下…

2026/8/7 17:02:37 阅读更多 →
终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 还在为网易云音乐下载的NCM格式文件无法在其他播放器播放而烦恼吗?ncmdump解密工具帮你轻松解决这个困…

2026/8/7 23:54:54 阅读更多 →
HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

AgentCard 智能体卡片:为英语学习 App 打造桌面级学习助手适用平台:HarmonyOS 7.0 (API 26 Beta)一、引言 HarmonyOS 7.0(API 26 Beta)新增了 AgentCard 智能体卡片能力,这是继 HMAF(鸿蒙智能体框架&#x…

2026/8/7 17:02:36 阅读更多 →