基于 Flutter 与 Python 的低延迟虚拟键盘实现方案

3.3 交互体验：按下发光与触觉反馈

为了赋予软件'机械感'，我们为按键增加了多维反馈：

1. 视觉反馈：通过 AnimatedContainer 追踪 _activeKeys 状态。按下时，按键边框变亮，产生外发光（Glow Effect）并模拟阴影下陷。
2. 触觉反馈：调用 HapticFeedback.selectionClick()，让手指在点按时感受到微弱震动。

4. 关键代码解析

4.1 Python 服务端核心逻辑

import pydirectinput
import socket

# 将暂停时间设为 0，消除 pydirectinput 的内置延迟
pydirectinput.PAUSE = 0

# 处理心跳与按键映射
def handle_message(message, addr, sock):
    if "PING" in message:
        sock.sendto(b"PONG", addr)  # 返回心跳响应
        return
    
    action, key = message.split(":")
    target = key_map.get(key)
    if target:
        if action == "DOWN":
            pydirectinput.keyDown(target)  # 驱动级模拟按下
        else:
            pydirectinput.keyUp(target)  # 驱动级模拟松开

4.2 Flutter 智能防误触

Dart Listener(
  onPointerDown: (event) {
    // 识别触点面积：手指尖接触面积小，手掌肉垫接触面积大
    // radiusMajor 是判断手掌误触的关键
    if (event.kind == PointerDeviceKind.touch && event.radiusMajor > 25) {
      print("Palm detected, ignoring...");
      return;
    }
    _sendKey("DOWN", id);
  },
  onPointerUp: (_) => _sendKey("UP", id),
)

5. 效果展示

连接前：左上角红色指示灯显示 ENGINE OFFLINE，蓝色 CONNECT 按钮诱导用户连接。 连接后：指示灯变为亮绿色呼吸动画，文字切换为 ENGINE ONLINE。IP 输入框锁定并调暗，按钮变为沉浸式深色。 操作感：WASD 绿色高亮，按键按下时产生实时光效，响应几乎零延迟。