4. LVGL手势识别：单指滑动、双指缩放、长按检测、手势冲突处理

手势识别，说白了就是让屏幕听懂你的手指在“画”什么。单指滑动、双指缩放、长按——这些操作在LVGL里都有现成的机制。但真正把它们用好，你得理解背后的检测逻辑和冲突处理。我刚开始做嵌入式UI时，就吃过手势冲突的亏，两个手势互相抢响应，界面卡得不行。

今天咱们就把这四种手势拆开揉碎，看看LVGL到底怎么识别它们，以及遇到冲突时该怎么处理。

4.1 单指滑动：最基础的手势

单指滑动，也叫“划动”。LVGL里用 lv_indev_t 的 LV_INDEV_TYPE_POINTER 类型来处理。你滑动时，系统会记录按下点和抬起点的坐标差。

核心参数：

LV_INDEV_GESTURE_THRESHOLD：滑动阈值，默认20像素。小于这个值不算滑动。
LV_INDEV_GESTURE_MIN_VELOCITY：最小速度，默认3像素/毫秒。太慢也不算滑动。

我习惯在 lv_event_t 里用 LV_EVENT_GESTURE 来捕获滑动方向。代码很简单：

static void gesture_event_handler(lv_event_t * e)
{
    lv_indev_t * indev = lv_indev_get_act();
    lv_gesture_dir_t dir = lv_indev_get_gesture_dir(indev);

    switch(dir) {
        case LV_GESTURE_DIR_LEFT:
            lv_label_set_text(label, "向左滑");
            break;
        case LV_GESTURE_DIR_RIGHT:
            lv_label_set_text(label, "向右滑");
            break;
        case LV_GESTURE_DIR_TOP:
            lv_label_set_text(label, "向上滑");
            break;
        case LV_GESTURE_DIR_BOTTOM:
            lv_label_set_text(label, "向下滑");
            break;
        default:
            break;
    }
}

// 注册到对象
lv_obj_add_event_cb(obj, gesture_event_handler, LV_EVENT_GESTURE, NULL);

这里有个坑：LV_EVENT_GESTURE 只在滑动结束后触发一次。如果你想实时跟踪手指位置，得用 LV_EVENT_PRESSING。

4.2 双指缩放：多点触控的典型应用

双指缩放依赖多点触控。LVGL从v8开始原生支持 LV_INDEV_TYPE_POINTER 的多点输入。缩放检测的核心是计算两个触摸点的距离变化。

我记得第一次做图片查看器时，双指缩放怎么都不灵敏。后来发现是没设置 lv_indev_set_group，导致第二个触摸点被忽略了。

实现要点：

确保驱动层支持多点触控，上报 lv_indev_data_t 时 point 数组长度大于1。
在事件回调里用 lv_indev_get_point_count() 判断触摸点数。
计算两点距离变化量，映射到缩放比例。

示例代码：

static void zoom_event_handler(lv_event_t * e)
{
    lv_indev_t * indev = lv_indev_get_act();
    uint8_t point_cnt = lv_indev_get_point_count(indev);

    if(point_cnt == 2) {
        lv_point_t points[2];
        lv_indev_get_points(indev, points);

        int32_t dx = points[1].x - points[0].x;
        int32_t dy = points[1].y - points[0].y;
        int32_t dist = lv_sqrt(dx*dx + dy*dy);

        // 与上一次距离比较，计算缩放因子
        static int32_t last_dist = 0;
        if(last_dist != 0) {
            float scale = (float)dist / last_dist;
            // 应用到对象
            lv_obj_set_scale(obj, scale * 256);
        }
        last_dist = dist;
    }
}

lv_obj_add_event_cb(obj, zoom_event_handler, LV_EVENT_PRESSING, NULL);

注意：双指缩放时，LV_EVENT_GESTURE 不会触发。因为LVGL把双指操作归类为“多点手势”，不走单指滑动逻辑。如果你同时注册了单指滑动和双指缩放，记得在双指操作时屏蔽滑动事件。

4.3 长按检测：时间维度的手势

长按检测不依赖移动，只依赖时间。LVGL内部用定时器实现：按下后开始计时，超过 LV_INDEV_LONG_PRESS_TIME（默认400ms）就触发长按事件。

事件类型有两个：

事件	触发时机	典型用途
`LV_EVENT_LONG_PRESSED`	按下超过400ms且未移动	弹出菜单、删除确认
`LV_EVENT_LONG_PRESSED_REPEAT`	长按后持续触发（默认每100ms一次）	数值连续增减、滚动加速

我曾经在智能家居面板上做过一个场景：长按灯光图标弹出亮度调节滑块。一开始用 LV_EVENT_LONG_PRESSED 没问题，但用户手指稍微动了一下（超过阈值），长按就被取消了。后来我把滑动阈值调大了一倍，才解决。

static void long_press_handler(lv_event_t * e)
{
    lv_event_code_t code = lv_event_get_code(e);

    if(code == LV_EVENT_LONG_PRESSED) {
        lv_label_set_text(label, "长按触发！");
        // 弹出菜单或执行操作
    } else if(code == LV_EVENT_LONG_PRESSED_REPEAT) {
        static int count = 0;
        count++;
        lv_label_set_text_fmt(label, "重复: %d", count);
    }
}

lv_obj_add_event_cb(obj, long_press_handler, LV_EVENT_ALL, NULL);

4.4 手势冲突处理：最头疼的部分

手势冲突，说白了就是多个手势同时满足条件，系统不知道该响应哪个。比如：

单指滑动 vs 长按：手指按住不动，算长按还是算滑动（速度为零）？
单指滑动 vs 双指缩放：两个手指同时操作，系统怎么区分？
长按 vs 点击：按了300ms松手，算点击还是算长按？

LVGL的默认处理策略是“先到先得 + 优先级”。但实际项目中，你得自己加逻辑。

我的冲突处理三板斧：

按触摸点数分流：1个手指走滑动/长按逻辑，2个手指走缩放逻辑。在事件回调开头判断 lv_indev_get_point_count()。
按时间窗口区分：按下后200ms内不触发长按，给滑动留出判断时间。200ms后如果手指没动，才进入长按检测。
手动屏蔽事件：在双指操作时，用 lv_event_stop_bubbling(e) 阻止事件继续传播，避免单指滑动被误触发。

举个例子，我做过一个地图应用，需要同时支持单指拖动和双指缩放。冲突点在于：单指拖动时，如果用户无意中用了两个手指，地图会乱跳。我的解决方案是：

static void map_gesture_handler(lv_event_t * e)
{
    lv_indev_t * indev = lv_indev_get_act();
    uint8_t cnt = lv_indev_get_point_count(indev);

    if(cnt == 1) {
        // 单指：只处理拖动
        // 屏蔽缩放相关逻辑
    } else if(cnt >= 2) {
        // 双指：只处理缩放
        // 屏蔽拖动逻辑
        lv_event_stop_bubbling(e);  // 阻止事件冒泡
    }
}

避坑指南：我曾经在双指缩放时忘记调用 lv_event_stop_bubbling，结果单指滑动和双指缩放同时触发，界面像抽风一样。记住：多点触控时，一定要显式阻止不相关的事件。

4.5 知识体系总览

下面这张图总结了本章的核心逻辑。你可以看到，所有手势最终都汇聚到事件处理中心，通过触摸点数和时间窗口来分流。

从图上可以看出，核心思路就是“先分流，再处理”。触摸点数是第一道关卡，时间窗口是第二道。最后用 lv_event_stop_bubbling 兜底，防止事件串扰。

4.6 实战建议

最后给你几个我踩坑后总结的建议：

阈值别用死值：不同屏幕的触摸灵敏度不一样。我习惯在初始化时从配置文件读取阈值，方便调试。
长按和点击别混用：如果同一个按钮既支持点击又支持长按，用户很容易误操作。我的做法是：点击立即响应，长按延迟响应，两者互斥。
双指缩放记得加阻尼：直接映射距离变化会导致缩放太灵敏。加个系数（比如0.8）让手感更自然。
测试时用真机：模拟器上触摸事件和真机差别很大。我吃过一次亏，模拟器上双指缩放完美，真机上完全没反应——后来发现是驱动层没上报第二个触摸点。

嗯，手势识别这块内容就这些。记住：LVGL给了你工具，但怎么组合使用，还得靠你对业务场景的理解。多试几次，手感就出来了。