CFDesktop 文档

Appearance

Phase 3: 输入抽象层 TODO ​

状态: ⬜ 待开始 预计周期: 1~2 周 依赖阶段: Phase 0, Phase 1, Phase 2 目标交付物: 统一输入分发、触摸处理、按键处理、手势识别、焦点导航

一、阶段目标 ​

核心目标 ​

屏蔽底层输入差异，统一触摸、物理按键、旋钮等输入事件，支持焦点导航模式。

具体交付物 ​

  • [ ] InputManager 统一分发层
  • [ ] TouchInputHandler 触摸处理器
  • [ ] KeyInputHandler 按键处理器
  • [ ] RotaryInputHandler 旋钮处理器
  • [ ] FocusNavigator 焦点导航器
  • [ ] 单元测试

二、Week 1: 核心处理器 ​

Day 1-2: InputManager 基础 ​

  • [ ] 创建 InputManager 类
    • [ ] 单例模式
    • [ ] 设备注册/注销
    • [ ] 事件分发机制
  • [ ] 实现设备注册/注销
    • [ ] registerDevice()
    • [ ] unregisterDevice()
    • [ ] 设备列表管理
  • [ ] 实现事件分发机制
    • [ ] dispatchEvent()
    • [ ] 事件过滤器
  • [ ] 添加事件过滤器支持
    • [ ] addEventFilter()
    • [ ] removeEventFilter()

Day 3: TouchInputHandler ​

  • [ ] 创建 TouchInputHandler 类
    • [ ] 触摸点跟踪
    • [ ] 手势检测基础
  • [ ] 实现触摸点跟踪
    • [ ] TouchPoint 结构
    • [ ] 多点触摸支持
    • [ ] 压力检测
  • [ ] 实现单击/双击检测
    • [ ] 点击阈值判定
    • [ ] 时间窗口判定
  • [ ] 实现长按检测
    • [ ] 定时器实现
    • [ ] 移动距离判定

Day 4: KeyInputHandler ​

  • [ ] 创建 KeyInputHandler 类
    • [ ] 按键配置支持
    • [ ] 状态跟踪
  • [ ] 实现按键状态跟踪
    • [ ] 按键列表
    • [ ] 时间戳记录
  • [ ] 实现长按检测
    • [ ] 阈值配置
    • [ ] 信号触发
  • [ ] 实现连击检测
    • [ ] 计数器
    • [ ] 时间窗口

Day 5: RotaryInputHandler ​

  • [ ] 创建 RotaryInputHandler 类
    • [ ] 旋钮配置
    • [ ] 速度计算
  • [ ] 实现旋转解码
    • [ ] AB 相位解码
    • [ ] 方向判定
  • [ ] 实现速度计算
    • [ ] 滑动平均
    • [ ] 加速因子
  • [ ] 实现加速功能
    • [ ] 速度映射
    • [ ] 可配置系数

三、Week 2: 手势与导航 ​

Day 1-2: GestureRecognizer ​

  • [ ] 创建 GestureRecognizer 类
    • [ ] 手势状态机
    • [ ] 配置支持
  • [ ] 实现滑动手势
    • [ ] 方向判定
    • [ ] 距离阈值
    • [ ] 超时检测
  • [ ] 实现捏合手势
    • [ ] 双指检测
    • [ ] 缩放计算
  • [ ] 实现旋转手势
    • [ ] 角度计算
    • [ ] 方向判定

Day 3: FocusNavigator ​

  • [ ] 创建 FocusNavigator 类
    • [ ] 单例模式
    • [ ] 焦点策略
  • [ ] 实现方向导航算法
    • [ ] 四方向查找
    • [ ] 距离计算
    • [ ] 方向判定
  • [ ] 实现焦点链自定义
    • [ ] addFocusChain()
    • [ ] 自定义跳转
  • [ ] 实现边界策略
    • [ ] 循环策略
    • [ ] 停止策略

Day 4: 原生设备 ​

  • [ ] 实现 EvdevDevice
    • [ ] /dev/input/eventX 读取
    • [ ] 事件解析
    • [ ] 设备识别
  • [ ] 实现 tslib 电阻触摸校准（⚠️ i.MX6ULL 真机触摸硬前提）
    • [ ] Qt tslib 插件集成（QT_QPA_EGLFS_TSLIB=1 / QT_QPA_FB_TSLIB=1）
    • [ ] 校准数据加载（/etc/pointercal）
    • [ ] 校准流程（ts_calibrate）
  • [ ] 实现 GPIOButton
    • [ ] sysfs 接口
    • [ ] 边沿检测
    • [ ] 防抖处理
  • [ ] 实现 RotaryEncoder
    • [ ] GPIO 输入
    • [ ] 状态解码
    • [ ] 位置计算

Day 5: 测试与集成 ​

  • [ ] 编写单元测试
    • [ ] 触摸处理测试
    • [ ] 按键处理测试
    • [ ] 手势识别测试
    • [ ] 焦点导航测试
  • [ ] 集成测试
    • [ ] 多设备协同
    • [ ] 事件流测试
  • [ ] 性能测试
    • [ ] 事件延迟测试
    • [ ] CPU 占用测试

补漏项（2026-06-29 核对） ​

以下原 Phase 3 未覆盖，但对完整桌面（尤其 i.MX6ULL 真机）是刚需。

全局快捷键 / 系统热键（可先于 IPC 做） ​

  • [ ] InputManager 事件过滤器链做全局 KeyEvent 路由（WSL X11 / EGLFS 下 Qt 原生 grabKeyboard 不够用）
  • [ ] Super/Meta 唤起启动器、Alt-Tab 任务切换、通知中心开关、主题切换、音量/亮度媒体键、Print 截图
  • [ ] 与 10_shell_navigation.md 的唤起入口对接

虚拟键盘（OSK）+ 输入法（IME） ​

  • [ ] 触摸设备软键盘面板（maliit 或自研最小面板，不挂重量级 IME 守护进程）
  • [ ] CJK 拼音等输入法引擎对接（见 aels-i18n）
  • [ ] 输入候选面板（动画克制，6ULL 软件渲染友好）

剪贴板与拖放（Clipboard & DnD） ​

  • [ ] QClipboard 复制粘贴（文本 / 图片 / MIME）
  • [ ] 拖放：文件拖进应用打开、文本→笔记（overlay 渲染 + 外部 X 窗口下 DnD 协议桥接是真难点）

四、验收标准 ​

功能验收 ​

  • [ ] 触摸输入正常响应
  • [ ] 手势识别准确率 > 95%
  • [ ] 焦点导航无死循环
  • [ ] 原生设备正常读取

性能验收 ​

  • [ ] 事件延迟 < 16ms
  • [ ] CPU 占用 < 5%

兼容性验收 ​

  • [ ] 模拟器和真机行为一致

五、文件清单 ​

核心接口 ​

  • [ ] include/CFDesktop/Base/Input/InputManager.h
  • [ ] include/CFDesktop/Base/Input/InputEvent.h
  • [ ] include/CFDesktop/Base/Input/InputDevice.h

处理器 ​

  • [ ] include/CFDesktop/Base/Input/TouchInputHandler.h
  • [ ] include/CFDesktop/Base/Input/KeyInputHandler.h
  • [ ] include/CFDesktop/Base/Input/RotaryInputHandler.h
  • [ ] include/CFDesktop/Base/Input/GestureRecognizer.h
  • [ ] include/CFDesktop/Base/Input/FocusNavigator.h

实现 ​

  • [ ] src/base/input/InputManager.cpp
  • [ ] src/base/input/TouchInputHandler.cpp
  • [ ] src/base/input/KeyInputHandler.cpp
  • [ ] src/base/input/RotaryInputHandler.cpp
  • [ ] src/base/input/GestureRecognizer.cpp
  • [ ] src/base/input/FocusNavigator.cpp

原生设备 ​

  • [ ] src/base/input/native/EvdevDevice.cpp
  • [ ] src/base/input/native/GPIOButton.cpp
  • [ ] src/base/input/native/RotaryEncoder.cpp
  • [ ] src/base/input/simulator/SimulatedInput.cpp

测试 ​

  • [ ] tests/unit/base/input/test_input_manager.cpp
  • [ ] tests/unit/base/input/test_touch_handler.cpp
  • [ ] tests/unit/base/input/test_key_handler.cpp
  • [ ] tests/unit/base/input/test_rotary_handler.cpp
  • [ ] tests/unit/base/input/test_gesture_recognizer.cpp
  • [ ] tests/unit/base/input/test_focus_navigator.cpp

六、相关文档 ​

最后更新: 2026-06-29（补 tslib 校准 / 全局快捷键 / 虚拟键盘+IME / 剪贴板DnD 补漏项）

Built with VitePress

Copyright © 2026 CharlieChen