游戏手柄支持——让你的 NVDA 操作得心应手

这是由中文社区贡献者 Shunxian 开发的一款新插件,扩展了 NVDA 对外部输入硬件的支持范围。

目前 NVDA 支持丰富的输入源,包括键盘、触摸屏、盲文点显器上的 Perkins-style 键盘以及通过该插件扩展的游戏手柄。
后续还计划支持更多的输入硬件,绝对值得期待一波!

我们通过这些外置硬件让 NVDA 的按键组合更多样。尤其类似游戏手柄这样的轻便外设,在很多场景都能提供极大的便利,配合 NVDA 的模拟按键功能,不仅可以实现幻灯片翻页,还能实现演讲者备注的阅读、媒体播放控制、轻量化文本阅读等。

好啦!下面直接贴出插件的文档,各位读者按需自取吧!


本插件为 NVDA 增加了对 XInput 兼容手柄(如 Xbox 控制器、主流国产 PC 手柄等)的支持。通过本插件,用户可以将手柄按键映射为 NVDA 指令或键盘快捷键,从而实现通过控制器单手操作电脑。

基本信息


功能特性

  • XInput 集成:基于 XInput 1.4 标准,兼容性强,延迟极低。
  • 全按键识别
    • 方向键 (D-Pad): 上、下、左、右。
    • 动作键: A, B, X, Y。
    • 肩键: LB, RB。
    • 摇杆点击: 左摇杆中键 (L_Thumb), 右摇杆中键 (R_Thumb)。
    • 菜单键: Start, Back。
  • 智能扳机识别:将 LT 和 RT 线性扳机键模拟为普通开关按键,支持压力阈值判定,防止误触。
  • 原生手势支持:所有手柄输入均注册为 NVDA 系统的标准“手势”,可像分配键盘快捷键一样灵活配置功能。
  • 性能优化
    • 手柄连接时,以 100Hz 高频轮询,确保操作跟手。
    • 手柄断开后,自动切换至 5 秒一次的低频扫描模式,不占用 CPU 资源。

使用指南

安装插件并连接手柄后:

  1. 按下 NVDA+数字1 开启输入帮助,测试手柄按键是否能正常朗读。
  2. 打开 NVDA 菜单 (NVDA + N)。
  3. 进入 选项 (P) -> 按键与手势 (N)...
  4. 选中一个 NVDA 命令,点击 添加 (A),然后按下你想绑定的手柄按键。

常见问题

Q: 为什么我的手柄没反应?
A: 请确保你的手柄支持 XInput 模式(通常现代 PC 手柄均支持)。连接后可检查 NVDA 日志,若显示 "Gamepad connected" 则表示连接成功。
Q: 为什么只有 XInput 1.4?
A: 这是为了兼容 Windows 8 及以上系统的原生驱动。如果你的系统版本较低,可能需要手动更新 DirectX 运行库。


贡献与反馈

如果您在使用过程中遇到 Bug 或有功能建议,请通过以下方式联系:

获取方式

标签: 快捷键, 手柄, 命令, 单手操作

添加新评论