Gamepad Support(游戏手柄支持)插件
本插件为 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 资源。
使用指南
安装插件并连接手柄后:
- 按下 NVDA+数字1 开启输入帮助,测试手柄按键是否能正常朗读。
- 打开 NVDA 菜单 (
NVDA + N)。
- 进入 选项 (P) -> 按键与手势 (N)...。
- 选中一个 NVDA 命令,点击 添加 (A),然后按下你想绑定的手柄按键。
常见问题
Q: 为什么我的手柄没反应?
A: 请确保你的手柄支持 XInput 模式(通常现代 PC 手柄均支持)。连接后可检查 NVDA 日志,若显示 "Gamepad connected" 则表示连接成功。
Q: 为什么只有 XInput 1.4?
A: 这是为了兼容 Windows 8 及以上系统的原生驱动。如果你的系统版本较低,可能需要手动更新 DirectX 运行库。
贡献与反馈
如果您在使用过程中遇到 Bug 或有功能建议,请通过以下方式联系:
* 在 GitHub Issues 提交问题。
* 访问中文社区 NVDA 中文站 交流。