短按、长按、双击——一个键拆出三种功能的点击类型体系
同一个音量键,单击调音量、长按开手电筒、双击开相机——靠的就是点击类型(click type)。Key Mapper 给每个键提供三种点击类型,相互独立、可同时存在。
三种类型与默认阈值
- 短按(Short press):按下即触发,无需松开。最直接,没有参数
- 长按(Long press):按住至少一段时间才触发,默认 500 毫秒。阈值可全局改,也可按映射单独改
- 双击(Double press):快速按下并松开两次,默认间隔 300 毫秒。同样可调
三个阈值在两处可改:全局默认在应用设置里;单条键映射在编辑页的 OPTIONS 标签里。
关键规则:并行和序列不一样
- 并行触发器:所有键共享一个点击类型,在触发模式按钮上方统一选
- 序列触发器:点每个键右侧的三点菜单,逐键设置点击类型——这就允许「单击 A 然后长按 B」这种混合组合

同一个键的三条映射怎么共存
短按/长按/双击是三种独立判定,所以一个键可以挂三条键映射:
- 音量减短按 → 调音量(保留默认行为时用「不覆盖默认行为」)
- 音量减长按 → 打开手电筒
- 音量减双击 → 打开相机
注意事项:短按映射和双击映射共存时会有判定延迟——系统要等 300 毫秒确认你不是在双击。如果短按操作明显「变钝」,把双击映射删掉或调小双击间隔。
「不覆盖默认行为」
逐键菜单里的这个开关决定按键是否还执行原功能:
- 关(默认):按键完全交给 Key Mapper,原功能失效
- 开:原功能照常执行,你的动作额外发生
适合「音量键继续调音量,但长按时额外开手电筒」这类叠加需求。4.3 版本起还可以在设置里把「不覆盖默认行为」设为默认值。
点击类型配好后,映射层面还有一层选项:屏幕消息、振动与超时参数。