JoyToKey 使用教程

1. 快速上手

JoyToKey 的设计哲学是"开箱即用"。从下载到完成第一次按键映射，整个流程通常不超过 3 分钟。本节将带您完整走一遍基础流程，让您快速建立起对软件工作方式的直觉理解。

1.1 下载与安装

访问本站下载中心，点击"立即下载"按钮，在弹出的下载窗口中选择官方下载或镜像下载。下载完成后，运行安装程序，按照向导提示选择安装路径并完成安装。整个过程不需要任何额外依赖，单文件即可运行。

如果您选择了便携版，只需将 ZIP 压缩包解压到任意目录，双击其中的 JoyToKey.exe 即可启动，无需安装。便携版的优势在于配置文件与程序位于同一目录，便于在 U 盘或多台电脑之间携带。

1.2 启动软件

安装完成后，双击桌面或开始菜单中的 JoyToKey 图标启动软件。启动后，您会看到主界面被分为左右两部分：左侧是配置文件列表，右侧是当前配置文件下各手柄按键的映射详情。软件启动时会自动检测已连接的手柄设备，并为每个手柄创建一个独立的标签页。

如果您希望 JoyToKey 在开机时自动启动，可以使用管理员权限运行软件，然后在"设置"菜单中启用"开机自启动"选项。这样每次开机后 JoyToKey 就会自动以托盘图标形式常驻后台，无需手动干预。

2. 连接手柄

JoyToKey 支持所有遵循 XInput 与 DirectInput 协议的标准游戏控制器。连接方式包括 USB 有线连接与无线蓝牙连接，两种方式在映射功能上完全等价。

2.1 有线连接

使用 USB 数据线将手柄连接至电脑的 USB 端口。Windows 系统会自动识别设备并安装驱动程序（通常为 XInput 驱动），无需额外操作。连接完成后，启动 JoyToKey，软件会自动识别手柄并显示对应的标签页。

2.2 无线蓝牙连接

对于支持蓝牙的手柄（如 Xbox Series、DualShock 4、DualSense 等），可通过 Windows 蓝牙设置完成配对。以 DualShock 4 为例：同时按住手柄上的 Share 按钮与 PS 按钮约 3 秒，直到触摸板背光快速闪烁，表示手柄已进入配对模式。在电脑的蓝牙设置中搜索设备，找到"Wireless Controller"并完成配对。

2.3 刷新手柄连接

当您在 JoyToKey 运行期间连接新的手柄时，软件可能不会立即识别新设备。此时只需单击（左键或右键均可）系统托盘中的 JoyToKey 图标，软件会立即刷新手柄连接列表并加载新设备。这一便捷设计让手柄热插拔变得轻而易举。

3. 按键映射

按键映射是 JoyToKey 的核心功能。通过为每个手柄按键分配对应的键盘按键或鼠标操作，您可以让手柄控制任何接受键盘鼠标输入的应用程序。

3.1 进入按键分配界面

在主界面的手柄标签页中，您会看到所有可用按键的列表（按钮 1、按钮 2、按钮 3 等）。双击任意按键，或右键选择"分配..."，即可打开按键分配窗口。在分配窗口中，您可以同时设置按下时触发的按键与释放时触发的按键。

3.2 分配单个按键

在"按下时"输入框中，直接按下键盘上您希望映射的按键（例如字母 A、方向键 ↑、空格等），JoyToKey 会自动记录该按键。如果需要分配组合键（如 Ctrl+C），按住 Ctrl 不放再按 C 即可。分配完成后点击"确定"保存。

3.3 分配鼠标操作

切换到"鼠标"标签页，您可以将手柄按键分配为鼠标左键、右键、中键、滚轮上滚、滚轮下滚等操作。同时支持设置鼠标光标移动（按住时持续移动）与鼠标绝对坐标移动两种模式，满足不同场景需求。

3.4 自定义按键名称

为了让映射界面与实体手柄按键对应更直观，您可以为每个按键自定义显示名称。右键点击按键标签，选择"编辑此设备的显示名称"，将"按钮 1"修改为"A"、"按钮 2"修改为"B"，以此类推。修改后整个界面会自动更新，配置文件一目了然。

3.5 测试映射效果

分配完成后，可以打开任意文本编辑器（如记事本）测试映射效果。按下手柄上对应按键，您应该能看到文本编辑器中实时出现您分配的字符。如果一切正常，恭喜您已经完成了第一次按键映射！

4. 摇杆模拟鼠标

将摇杆转换为虚拟鼠标是 JoyToKey 最实用的功能之一，特别适合需要远程操作鼠标的场景，如演示、媒体播放控制等。

4.1 启用摇杆鼠标模式

在手柄标签页中找到摇杆区域，双击对应的方向（上、下、左、右），打开分配窗口。切换到"鼠标"标签页，您会看到"鼠标光标移动"选项，选择对应方向（上 = 上移，下 = 下移）。保存后摇杆即可控制鼠标光标移动。

4.2 调节灵敏度

摇杆鼠标的默认灵敏度可能不符合您的预期。在"设置"菜单中选择"摇杆设置"，您可以独立调整水平与垂直方向的移动速度（数值越大，光标移动越快）。建议从默认值开始，根据实际使用体验逐步调整，直至找到最舒适的手感。

4.3 设置死区

摇杆在静止状态下可能存在轻微漂移（输入不为零），导致鼠标光标缓慢漂移。在摇杆设置中调整"死区"参数，将死区设置为略大于漂移范围的值即可解决问题。典型值为 10% - 20%，过大会影响灵敏度，过小则无法消除漂移。

4.4 加速度曲线

加速度曲线决定了摇杆推力与光标移动速度之间的关系。线性曲线适合精细绘图等需要精确控制的场景；对数曲线适合大屏幕快速移动光标。JoyToKey 允许您在多种曲线模式间自由切换，找到最适合您工作流的那一种。

5. 配置文件管理

配置文件是 JoyToKey 管理多套映射方案的核心机制。每个配置文件包含一组完整的按键映射设置，您可以为不同的应用场景创建独立的配置文件。

5.1 新建配置文件

在主界面左侧的配置文件列表中点击"新建"按钮，输入有意义的名称（如"游戏A"、"办公软件"等），即可创建空白配置文件。新文件创建后，您可以立即开始为其分配按键映射。

5.2 自动关联应用程序

JoyToKey 支持根据前台应用程序自动激活对应配置文件。右键点击配置文件，选择"为目标应用程序关联配置"，在弹出的窗口中您可以指定应用程序的可执行文件路径或窗口标题关键字。当指定应用成为前台窗口时，JoyToKey 会自动切换至该配置文件。

关联规则支持三种模式：仅路径匹配（适用于固定路径的程序）、仅标题匹配（适用于多实例或动态路径的程序）、路径与标题同时匹配（最严格，确保精确切换）。您可以根据目标应用的特点选择合适的模式。

5.3 导出与导入

右键点击配置文件，选择"导出"即可将配置保存为单独文件。这些文件可用于备份，也可传输至其他电脑使用。在新电脑上只需选择"导入"，选择配置文件即可恢复您的映射方案，免去重新配置的麻烦。

5.4 配置文件存储位置

使用安装版时，用户配置数据默认存储在"我的文档\JoyToKey"目录下。这意味着如果您启用了 Windows 的"文档"文件夹云同步（OneDrive 等），配置文件会自动在多台设备间同步。便携版则将配置存储在程序同目录，与程序一起携带。

6. 进阶技巧

掌握基础用法后，以下进阶技巧能帮助您充分发挥 JoyToKey 的潜力，构建出真正个性化的手柄工作流。

6.1 长按与短按分配不同动作

在按键分配窗口的"多键"标签页中，您可以启用"按键持续时长"功能。设置一个时间阈值（如 0.5 秒），短按时触发一组按键，长按时触发另一组按键。例如，短按 A 键执行普通攻击，长按 A 键释放技能，让单个按键承载双重功能。

6.2 SHIFT 临时切换映射

SHIFT 功能允许您按住某个按键时临时切换到另一套映射方案，松开后自动还原。在分配窗口中勾选"作为 SHIFT 功能键"即可启用。这种机制让手柄的有限按键承载更多功能，特别适合复杂游戏的操作需求。

7.3.3 按键序列轮转

启用"按键序列"功能后，每次按下同一按键会按顺序触发不同的输入。例如，第一次按下触发 Input1、第二次按下触发 Input2、第三次按下触发 Input3，循环往复。配合"无操作时重置"选项，可以实现智能化的按键复用。

6.4 连发模式

对于需要高频按键的游戏（如射击、格斗），连发模式可大幅减轻手指负担。在分配窗口中勾选"重复"，设置重复频率（如每 50 毫秒触发一次）与起始延迟。按住按键期间，JoyToKey 会持续以设定频率模拟按键。

6.5 启动外部程序

可将手柄按键绑定到启动外部程序。在分配窗口的"外部程序"标签页中，指定可执行文件路径、命令行参数与起始工作目录。例如，按下手柄 Home 键启动浏览器、长按启动任务管理器等，让手柄成为电脑的快捷遥控器。

7. 故障排查

使用过程中如遇到问题，可参考以下常见故障排查方法。如问题仍无法解决，请访问常见问题页面或联系技术支持。

7.1 手柄无法识别

首先确认手柄在 Windows"设备和打印机"中能被正确识别。如果系统层面无法识别，问题出在手柄驱动或连接方式，请参考手柄厂商提供的支持文档。如果系统能识别但 JoyToKey 中看不到，请尝试点击系统托盘图标刷新手柄连接。

7.2 按键映射无效

确认 JoyToKey 处于运行状态（系统托盘中有图标）。检查当前激活的配置文件是否正确——主界面左侧配置列表中带高亮的为当前激活项。如果使用自动关联功能，请确保前台窗口的标题或路径与关联规则匹配。

7.3 部分游戏无响应

某些采用独占模式（Exclusive Mode）读取手柄输入的游戏会绕过 JoyToKey 的模拟层。这种情况下，可在游戏设置中将手柄输入模式切换为非独占，或使用键盘模式启动游戏。如问题依旧，可在 JoyToKey 设置中尝试启用"以管理员权限运行"。

7.4 摇杆鼠标漂移

摇杆静止时光标缓慢漂移，通常是死区设置过小所致。进入摇杆设置，逐步增大死区百分比，直至漂移完全消失。建议每次增加 5% 进行测试，找到平衡灵敏度与稳定性的最佳值。