scrcpy-mask鼠标右键长按功能深度解析：从问题到解决方案

【问题现象】为什么鼠标右键在游戏中会"不听话"？

当玩家在《和平精英》等FPS游戏中激战正酣时，本想通过右键长按进行精确瞄准，却意外弹出浏览器的检查菜单——这正是scrcpy-mask早期版本中困扰用户的典型问题。更令人沮丧的是，即便成功触发右键操作，也常出现"按了没反应"或"松开还在瞄准"的异常表现。这些现象背后，其实隐藏着桌面环境与移动设备交互的深层矛盾。

【用户场景】谁在为什么而困扰？

1. 🎮 手游竞技玩家

"刚捡到三级头就因为开不了镜被爆头！"
FPS手游玩家需要通过右键长按实现开镜瞄准，操作频率高达每分钟20-30次，任何延迟或误触发都会直接影响游戏胜率。

2. 🖌️ 绘图设计工作者

"画直线时右键老是弹出菜单打断思路"
使用安卓绘画应用的设计师，需要通过长按右键调出颜色拾取器，但系统默认菜单会严重干扰创作流程。

3. 🎯 模拟器测试工程师

"自动化测试脚本因长按识别不准频繁失败"
在APP兼容性测试中，精确的长按事件模拟是验证按钮功能的关键，错误的事件触发会导致测试结果失真。

【技术方案】如何让鼠标"听懂"玩家的指令？

预设配置一键导入

项目提供的"AVD-和平精英"预设方案已完成优化配置：

• 左键映射为持续射击（长按阈值150ms）
• 右键绑定开镜功能（触发延迟100ms）
• 滚轮调节灵敏度（步长0.1）

事件拦截机制升级

v0.4.2版本通过三重防护解决菜单干扰：

1. 捕获阶段阻止事件冒泡（像用防波堤拦截海浪）
2. 添加event.preventDefault()系统调用
3. 实现自定义上下文菜单替代方案

【实现原理解析】

核心机制：长按识别的"时间密码"

为什么长按识别需要100ms延迟？太短会误判手抖，太长影响操作手感。系统采用"双计时器"机制：

MouseDown事件 → 启动100ms计时器 → 
[是→触发长按] ← 超时检查 ← [否→触发单击]
                ↑
           MouseUp事件

关键代码逻辑

在frontend/src/components/mappings/ButtonPadCastSpell.tsx中实现了核心逻辑：

const handleMouseDown = (e) => {
  e.stopPropagation(); // 阻止事件冒泡（像给涟漪按下暂停键）
  pressTimer = setTimeout(() => {
    sendTouchEvent('longPress', position);
    isLongPress = true;
  }, 100); // 长按识别阈值
};

const handleMouseUp = () => {
  clearTimeout(pressTimer);
  if (!isLongPress) {
    sendTouchEvent('click', position);
  }
  isLongPress = false;
};

【应用技巧】让操作如丝般顺滑

自定义参数调节

1. ⚙️ 打开设置面板 → 进入"高级映射"
2. 🕒 调整"长按识别延迟"（建议值：游戏类100-150ms，办公类200-300ms）
3. 🖱️ 勾选"右键菜单禁用"选项
4. 💾 保存配置并应用

常见问题排查

1. 右键仍弹出菜单
   → 检查是否勾选"禁用系统右键菜单"
   → 验证scrcpy-mask是否获取管理员权限

2. 长按响应延迟
   → 降低longPressThreshold至80ms
   → 关闭后台占用CPU的程序

3. 操作不同步
   → 检查手机与电脑的时间同步
   → 更新至v0.4.2+版本修复时间戳bug

【未来优化方向】

智能识别系统

计划引入AI模型自动区分：

• 游戏场景（快速响应模式）
• 办公场景（精准识别模式）
• 绘图场景（压力感应模式）

硬件加速支持

通过WebAssembly优化事件处理，将延迟从当前的100ms降低至30ms以内，达到专业游戏手柄的响应级别。

多设备协同

实现多手机同时连接时的鼠标事件隔离，满足直播主播多设备控制需求。