自定义按键映射——解决跨平台和快捷键冲突

什么是按键映射

按键映射（Key Mapping）是指把主控端按下的某个按键或按键组合，转换成被控端收到的另一个按键或按键组合。

BilldDesk 在 GitHub README 的功能列表中明确支持「按键映射」：

• 可以解决跨平台的快捷键差异（Windows ↔ macOS）
• 可以解决游戏中的按键冲突（比如主控端和被控端的快捷键撞了）
• 可以为特定场景创建自定义的按键快捷方式

解决跨平台快捷键差异

Windows 和 macOS 的核心修饰键不同：

BilldDesk 默认会自动做 Ctrl ↔ Command 的基础映射，但一些场景需要更精细的自定义。

场景一：Windows 远程 macOS

• 主控端 Ctrl + C → 被控端 Command + C（复制）
• 主控端 Ctrl + V → 被控端 Command + V（粘贴）
• 主控端 Ctrl + Z → 被控端 Command + Z（撤销）

场景二：macOS 远程 Windows

• 主控端 Command + C → 被控端 Ctrl + C
• 主控端 Command + V → 被控端 Ctrl + V

BilldDesk 默认会自动处理这两种基础映射。但如果默认映射不符合你的习惯，或者有更特殊的映射需求，可以自定义。

解决游戏按键冲突

远程云游戏时，主控端的某些快捷键可能和被控端游戏的快捷键冲突。比如：

• 主控端按 F1 想触发 BilldDesk 的功能菜单，但被控端游戏中 F1 是技能释放
• 主控端按 Ctrl + Shift 想切换输入法，但被控端游戏中这是一个重要的快捷键

通过按键映射，可以把主控端的快捷键改成别的按键，避免冲突。

如何设置按键映射

BilldDesk 的按键映射设置入口在：

1. 远程会话中 → 远程窗口工具栏 → 按键映射（或类似名称）
2. 或 BilldDesk 全局设置 → 按键映射

设置界面中可以：

• 点击「添加新映射」
• 设定主控端按键组合（按下时触发）
• 设定被控端按键组合（发送到被控端）
• 保存映射规则

常见映射示例

按键错乱怎么办

远程中偶尔会出现按键错乱 / 按键不生效的情况。官方 FAQ 给出的解决方法是：

按键错乱通常是因为 Win / Alt / Ctrl 键按下了没有松开。重新按一下这三个键应该就能恢复。

这种情况通常发生在主控端切换窗口或按键事件被本机输入法拦截的时候。按一下 Win / Alt / Ctrl 相当于给被控端发一个「释放」事件，可以恢复正常。