游戏客户端架构 / 系统课时
把触屏手势转换成动作
把触屏手势转换成动作
触屏只会提供按下、移动和抬起等指针事件,玩法真正需要的是“确认”“蓄力”“拖拽”“闪避”这类稳定动作。本节建立一套先识别手势、再映射动作的处理方式,用距离与时间阈值区分点击、长按、拖动和滑动,避免业务代码直接依赖触摸细节。
学习目标
- 能用起点、当前位置、持续时间和移动距离描述一次触摸序列
- 能为点击、长按、拖动和滑动建立互斥且可测试的判定规则
- 能把设备手势与玩法动作解耦,让同一动作同时接收触屏、鼠标或手柄输入
先把触摸事件收敛成一次手势
一次手势通常从 Down 开始,到 Up 或取消结束。识别器需要记住至少四类状态:起点、开始时间、最后位置、是否已经超过移动阈值。真正决定手势类型的不是某一个事件,而是整段事件序列的组合。
例如“抬起时移动很少且持续时间短”可以判为点击;移动很少但持续时间长可以判为长按;位移很大且时间短适合判为滑动;位移较大但不满足滑动速度条件时可以视为拖动。把这些规则集中在识别器里,玩法层就不需要重复计算距离和时间。

判定规则要互斥并明确优先级
阈值如果彼此重叠,就会出现同一序列既像点击又像滑动的情况。一个简单做法是在手势结束时按明确顺序判定,并把“短距离”与“大距离”分开。下面是一组示例规则:
| 手势 | 主要条件 | 典型语义 |
|---|---|---|
| 点击 | 距离 ≤ 12,持续时间 ≤ 0.25 秒 | 确认、普通攻击 |
| 长按 | 距离 ≤ 12,持续时间 ≥ 0.50 秒 | 蓄力、打开详情 |
| 滑动 | 距离 ≥ 80,持续时间 ≤ 0.35 秒 | 闪避、翻页 |
| 拖动 | 距离 > 12,且不满足滑动 | 拖动物体、移动视角 |
0.25 到 0.50 秒之间、且几乎没有移动的触摸可以返回“未识别”,而不是强行归类。这个空档能避免慢点击被误判成长按。真正项目中还应根据屏幕 DPI 或统一 UI 坐标换算距离阈值,不能简单把像素值跨设备照搬。
用可运行代码验证分类结果
下面的 C# 示例把一段已经结束的触摸序列转换为手势,再映射成玩法动作。示例故意不依赖任何引擎 API,便于单元测试;真实项目只需要把引擎的触摸坐标和时间转换成这里的输入参数。
using System;
public enum Gesture
{
None,
Tap,
LongPress,
Drag,
Swipe
}
public static class Program
{
static Gesture Classify(
double startX, double startY,
double endX, double endY,
double durationSeconds)
{
double dx = endX - startX;
double dy = endY - startY;
double distance = Math.Sqrt(dx * dx + dy * dy);
const double tapMove = 12.0;
const double tapMaxTime = 0.25;
const double longPressMinTime = 0.50;
const double swipeMinDistance = 80.0;
const double swipeMaxTime = 0.35;
if (distance <= tapMove && durationSeconds <= tapMaxTime)
return Gesture.Tap;
if (distance <= tapMove && durationSeconds >= longPressMinTime)
return Gesture.LongPress;
// 先识别快速大位移,避免把滑动降级成普通拖动。
if (distance >= swipeMinDistance && durationSeconds <= swipeMaxTime)
return Gesture.Swipe;
if (distance > tapMove)
return Gesture.Drag;
return Gesture.None;
}
static string MapToAction(Gesture gesture) => gesture switch
{
Gesture.Tap => "Confirm",
Gesture.LongPress => "Charge",
Gesture.Swipe => "Dodge",
Gesture.Drag => "MoveObject",
_ => "NoAction"
};
public static void Main()
{
Console.WriteLine(MapToAction(Classify(100, 100, 104, 103, 0.12)));
Console.WriteLine(MapToAction(Classify(100, 100, 102, 101, 0.80)));
Console.WriteLine(MapToAction(Classify(100, 100, 220, 105, 0.20)));
Console.WriteLine(MapToAction(Classify(100, 100, 145, 130, 0.90)));
}
}预期输出:
Confirm
Charge
Dodge
MoveObject这个例子把“识别”和“映射”拆成两个函数。以后即使把 Swipe 的阈值从 80 改成 100,玩法层仍然只看到 Dodge;反过来,把 Swipe 从闪避改成翻页,也不需要修改手势识别算法。
连续拖动要和最终手势分开
上面的分类适合在 Up 时决定最终手势,但拖拽类玩法通常还需要实时位置更新。此时可以把输入分成两条通道:一条是连续的 DragDelta 或指针位置,用于更新物体;另一条是在结束时确认的 Tap、Swipe、DragEnd 等离散动作。
不要在每个 Move 事件里立刻触发最终玩法命令。否则玩家本来想快速滑动,系统可能先触发多次拖动逻辑,抬手后又触发一次闪避,造成动作叠加。更安全的设计是让手势识别器拥有状态,并明确哪些事件只是“候选过程”,哪些事件才是“提交后的动作”。
动作层只消费稳定语义
触屏手势不应直接调用角色技能、相机或 UI 业务代码。推荐的边界是“设备事件 → 手势 → 动作 → 玩法”。这样鼠标左键也可以映射到 Confirm,手柄按键也可以映射到同一个动作,玩法系统无需知道动作来自哪种设备。
验收时应覆盖临界值:刚好 12 的位移、0.25 秒点击、0.50 秒长按、79 与 80 的滑动距离,以及快速斜向滑动。只要边界行为可预测、互斥规则固定、动作映射与设备无关,后续增加双击、双指缩放或旋转手势时,也可以继续扩展识别层,而不污染玩法层。