4. 事件系统移植：触摸事件、鼠标事件、手势识别在不同平台上的适配策略

事件系统移植，说白了就是让同一套交互逻辑，在触摸屏和鼠标键盘上都能跑得通。我早年做嵌入式 UI 时，被这个问题坑过好几次——明明在模拟器上点得飞起，一上真机就各种不响应。后来才明白，事件不是简单的「点一下」，它背后是一整套从硬件到应用层的传递链路。

这一章，我们就来拆解这条链路。

4.1 事件模型的底层差异

不同平台的事件模型，本质区别在于「谁先收到事件」以及「事件怎么冒泡」。桌面端通常是鼠标消息驱动，移动端则是触摸事件优先。我习惯把这两类模型抽象成一张图，方便团队理解。

下面这张 SVG 图，展示了事件从硬件到应用层的典型传递路径。我每次做移植方案时，都会先画出这张图，再决定在哪一层做适配。

4.2 触摸事件适配策略

触摸事件移植，最头疼的是「多点触控」和「坐标映射」。我记得有一次移植一个绘图 App，单指画线没问题，双指缩放时坐标全乱套了。查了半天，发现是事件 ID 没处理好。

4.2.1 事件 ID 与触点管理

每个触摸点都有一个唯一 ID。Android 用 getPointerId()，iOS 用 UITouch 对象本身。移植时，我习惯用一个哈希表来管理触点：

// 统一触点管理结构
struct TouchPoint {
    int id;           // 触点唯一 ID
    float x, y;       // 当前坐标
    float prevX, prevY; // 上一帧坐标
    uint64_t timestamp; // 时间戳（微秒）
    enum State { BEGAN, MOVED, STATIONARY, ENDED, CANCELLED } state;
};

// 触点管理器
class TouchManager {
    std::unordered_map<int, TouchPoint> activeTouches;
public:
    void onTouchBegan(int id, float x, float y, uint64_t ts);
    void onTouchMoved(int id, float x, float y, uint64_t ts);
    void onTouchEnded(int id, float x, float y, uint64_t ts);
    void onTouchCancelled(int id);
    // 获取所有活跃触点
    const auto& getActiveTouches() const { return activeTouches; }
};

4.2.2 坐标转换

不同平台的坐标系原点不一样。Android 是左上角，iOS 也是左上角但 UIView 的 bounds 可能被 transform 改变。Web 端还要考虑 CSS 变换和滚动偏移。

我一般会在适配层做一次「归一化」：

// 将平台坐标转换为逻辑坐标
struct LogicalPoint {
    float x, y; // 归一化到 [0, 1] 范围
};

LogicalPoint normalizePoint(float rawX, float rawY, 
                            float viewWidth, float viewHeight) {
    return { rawX / viewWidth, rawY / viewHeight };
}

// 反向转换（用于渲染层）
float denormalizeX(float normX, float viewWidth) {
    return normX * viewWidth;
}

4.3 鼠标事件适配策略

鼠标事件移植相对简单，但有个坑：鼠标滚轮。不同平台的滚轮单位不一样。Windows 是 WHEEL_DELTA（120），macOS 是像素值，Linux 是步进值。我曾在移植一个表格组件时，滚轮速度忽快忽慢，用户体验极差。

4.3.1 滚轮事件归一化

// 统一滚轮事件结构
struct WheelEvent {
    float deltaX, deltaY; // 标准化后的滚动量（单位：逻辑像素）
    bool isPrecise;       // 是否为精确滚动（触控板 vs 鼠标滚轮）
};

// 平台适配示例
#if defined(_WIN32)
    WheelEvent fromWin32(WPARAM wParam, LPARAM lParam) {
        int delta = GET_WHEEL_DELTA_WPARAM(wParam);
        return { 0.0f, delta / 120.0f * 30.0f, false };
    }
#elif defined(__APPLE__)
    WheelEvent fromMacOS(CGFloat deltaX, CGFloat deltaY) {
        return { deltaX, deltaY, true };
    }
#endif

4.3.2 鼠标悬停与进入/离开

触摸设备没有悬停概念。移植时，如果 UI 依赖 hover 状态（比如按钮高亮），需要做降级处理。我常用的做法是：

• 检测设备是否支持悬停（通过 pointer: fine 媒体查询或平台 API）。
• 如果不支持，将 hover 效果改为 active 或 focus 触发。
• 在触摸设备上，点击后短暂显示高亮，然后恢复。

4.4 手势识别移植

手势识别是事件系统移植中最复杂的部分。不同平台的手势识别器实现差异很大。Android 有 GestureDetector，iOS 有 UIGestureRecognizer，Web 端则需要自己实现或使用第三方库。

我个人建议：不要试图直接复用平台的手势识别器。因为它们的触发时机和状态机逻辑不同，移植后行为会不一致。更好的做法是，在适配层实现一套轻量级的手势识别引擎。

4.4.1 常见手势的状态机

手势类型	状态序列	关键参数
点击（Tap）	BEGAN → ENDED（时间 < 300ms，位移 < 10px）	最大时间、最大位移
长按（Long Press）	BEGAN → STATIONARY（时间 > 500ms）→ ENDED	最小时间、允许位移
滑动（Swipe）	BEGAN → MOVED（速度 > 阈值）→ ENDED	最小速度、方向约束
捏合（Pinch）	BEGAN（双指）→ MOVED（间距变化）→ ENDED	缩放因子、最小间距
旋转（Rotate）	BEGAN（双指）→ MOVED（角度变化）→ ENDED	旋转角度阈值

4.4.2 实现一个轻量级手势引擎

我曾在项目中写过这样一个引擎，核心思路是「事件流 + 状态机 + 优先级仲裁」：

class GestureEngine {
    std::vector<std::unique_ptr<GestureRecognizer>> recognizers;
public:
    void addRecognizer(std::unique_ptr<GestureRecognizer> rec) {
        recognizers.push_back(std::move(rec));
    }

    void onTouchEvent(const TouchEvent& event) {
        // 1. 将事件分发给所有识别器
        for (auto& rec : recognizers) {
            rec->handleEvent(event);
        }
        // 2. 仲裁：如果多个识别器同时触发，按优先级选择
        resolveConflicts();
        // 3. 触发回调
        fireCallbacks();
    }

private:
    void resolveConflicts() {
        // 例如：长按优先级高于滑动，双击高于单击
        // 具体策略根据业务需求定制
    }
};

4.5 触摸与鼠标的共存策略

很多设备同时支持触摸和鼠标（比如二合一笔记本）。这时候事件会冲突。典型场景：触摸后 300ms 内，系统会模拟一次鼠标点击。如果不处理，同一个操作会触发两次。

我的解决方案是：

• 事件抑制： 在触摸事件发生后，延迟 500ms 再处理鼠标事件。如果 500ms 内又有触摸事件，重置计时器。
• 设备类型标记： 在事件结构中增加 source 字段（TOUCH / MOUSE / PEN），上层根据来源决定是否响应。
• 混合输入模式： 允许用户同时使用触摸和鼠标，但同一时刻只允许一种输入源处于活跃状态。

// 事件抑制示例
class InputDispatcher {
    uint64_t lastTouchTime = 0;
    static constexpr uint64_t SUPPRESS_INTERVAL_MS = 500;

public:
    bool shouldDispatchMouseEvent(uint64_t currentTime) {
        if (currentTime - lastTouchTime < SUPPRESS_INTERVAL_MS) {
            return false; // 抑制鼠标事件
        }
        return true;
    }

    void onTouchEvent(uint64_t timestamp) {
        lastTouchTime = timestamp;
        // 处理触摸事件
    }
};

4.6 性能调优要点

事件系统移植后，性能问题往往出现在高频事件处理上。比如触摸滑动时，每帧可能产生几十个事件。如果每个事件都走一遍完整的识别流程，UI 线程很容易卡顿。

我常用的优化手段：

• 事件合并： 在适配层，将同一帧内的多个 MOVE 事件合并为一个。只保留最后一个位置。
• 懒识别： 手势识别器只在状态可能变化时才计算。比如点击手势，在 BEGAN 阶段只记录时间，不触发任何逻辑。
• 线程分离： 将事件采集放在独立线程，手势识别放在工作线程，UI 更新只接收最终结果。
• 对象池： 避免频繁创建 TouchPoint 或 WheelEvent 对象。用对象池复用内存。

// 事件合并示例
class EventMerger {
    TouchPoint lastMovedPoint;
    bool hasPendingMove = false;

public:
    void onTouchMoved(const TouchPoint& pt) {
        lastMovedPoint = pt;
        hasPendingMove = true;
    }

    void flush() {
        if (hasPendingMove) {
            // 将合并后的点发送给手势识别器
            gestureEngine.onTouchMoved(lastMovedPoint);
            hasPendingMove = false;
        }
    }
};