TouchManager

这是一个专为"拖拽牌块"设计的触摸输入管理器,负责将用户的滑动操作转换为游戏世界中物体的实时位移,并协调拖拽的开始、进行中和结束后的重置逻辑。它是麻将消消游戏交互层的核心组件之一。

核心功能

  1. 监听全局触摸/鼠标事件

    通过 TouchPad.Instance 的事件(ScreenDragEvent、ScreenPointerDownEvent、ScreenPointerUpEvent)获取屏幕上的按下、移动、抬起操作。

  2. 控制一个可拖拽物体的跟随移动

    • 当手指/鼠标按下并开始拖拽时,记录起始位置和拖拽路径。

    • 如果满足一定路径长度(dragPathLength > 0.1f),则标记 MinDragReached。

    • 如果设置了 FirstObject(即当前被拖拽的牌块),则启动协程 SlowFollowC,将牌块的位置实时更新为"起始位置 + 拖拽偏移量",实现视觉上的跟随拖拽。

  3. 管理拖拽状态

    • CanDrag:是否允许拖拽。

    • MinDragReached:是否达到最小拖拽距离(可用于判断是否为有效拖拽,避免误触)。

    • ResetDragEvent 回调:当拖拽结束或指针离开 UI 区域时,调用外部传入的回放方法,将牌块复位或完成匹配逻辑。

  4. 判断运行平台
    IsMobileDevice() 根据 SystemInfo.deviceType 返回是否为手持设备(手机),可用于区分鼠标输入和触摸输入。

  5. 实现 IPointerExitHandler

    当指针(鼠标/手指)离开当前 UI 元素时,立即取消拖拽并调用重置回调,确保拖拽不会"逃出"有效区域。

在这个项目中扮演的角色

麻将消消类游戏通常需要拖拽牌块到某个目标位置 或滑动选择相邻牌 。TouchManager 充当了拖拽行为的控制中枢:

  • 它与底层的 TouchPad(负责转换屏幕坐标到世界坐标)配合。

  • 它对外暴露 SetFirstObject 方法,允许外部指定当前被拖拽的物体和一个重置回调。

  • 拖拽过程中的实时跟随是"每帧更新位置",注意它用了 WaitForEndOfFrame,意味着跟随发生在渲染之前,看起来会比较平滑。

代码中的一些设计细节

  • 单例 Instance:确保全局只有一个拖拽管理器。

  • 协程 SlowFollowC :每帧只执行一次位置更新,避免每帧都开新协程(通过 followStarted 标志限制)。

  • ResetDragEvent 是一个 Action<Action>,即它接受一个 completeCallBack 参数,允许异步完成重置后执行回调。

  • 拖拽路径长度累积 :每次 LastScreenDragHandler 中累加当前帧与上一帧的移动距离,用于判断是否为"有意拖拽"(避免手抖误触)。

时序图

相关推荐
BruceNeter15 小时前
C# winform卡死问题分析1——线程池子线程创建句柄
c#·.net
ellis19701 天前
Claude Code[二] 上下文相关的机制
unity·ai编程
何以解忧唯有撸码2 天前
开源】当桌面图标开始打台球:我用 WinForms 做了一桌“真的”台球
c#·winform·自定义控件·gdi
zdr尽职尽责2 天前
Unity 3C 动画系统:从「蜘蛛网」到可维护的动画架构
unity·架构·游戏引擎
国家一级摸鱼选手3 天前
[Unity]几何碰撞检测:SAT 分离轴定理详解(从数学原理到 C# 实现)
unity·c#·游戏引擎·分离轴定理(sat)·多边形相交
汤姆宝库3 天前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#
Risehuxyc3 天前
C# 发展历史
开发语言·c#
kyle~3 天前
C# --- 反射
开发语言·c#
暴走约伯5 天前
【VFX工具链源码拆解 09】终极工业化闭环:基于 ID 规则驱动的全自动场景建档、骨骼挂载与男转女场景迁移
unity·c#·游戏引擎·材质
用户788477316345 天前
WinForms 迁移 WPF:Upgrade Assistant 覆盖 30%,剩下 70% 我手写了六周
c#