GamepadSupport (Поддержка геймпада)

Это дополнение обеспечивает поддержку в NVDA геймпадов, совместимых с XInput (таких как контроллеры Xbox, большинство современных PC-геймпадов и т.д.). С его помощью пользователи могут назначить кнопки геймпада на команды NVDA или сочетания клавиш, что позволяет управлять компьютером одной рукой с помощью контроллера.

Общая информация

• Название дополнения: Gamepad Support (Поддержка геймпада)
• Автор: Shunxian Wu PurrHare@outlook.com
• Протестировано на версии NVDA: 2025.1
• Лицензия: GPL v3
• Официальный сайт: NVDA Chinese Community
• Репозиторий: GitHub Repository

Возможности

• Интеграция с XInput: Основано на стандарте XInput 1.4, что обеспечивает высокую совместимость и минимальную задержку.
• Полное распознавание кнопок:
  • Крестовина (D-Pad): Вверх, Вниз, Влево, Вправо.
  • Основные кнопки (Action Buttons): A, B, X, Y.
  • Верхние кнопки (Shoulder Buttons): LB, RB.
  • Нажатие стиков (Thumbstick Clicks): L_Thumb (нажатие левого стика), R_Thumb (нажатие правого стика).
  • Кнопки меню (Menu Buttons): Start, Back.
• Интеллектуальное определение триггеров: Эмулирует линейные триггеры LT и RT как стандартные двоичные кнопки. Включает логику порога срабатывания для предотвращения случайных нажатий.
• Нативная поддержка жестов (Gestures): Все вводы с геймпада регистрируются как стандартные «жесты» NVDA, что позволяет гибко настраивать их, как и сочетания клавиш.
• Оптимизация производительности:
  • Активный режим: Опрос геймпада с частотой 100 Гц при подключении для отзывчивого ввода.
  • Режим ожидания: Автоматически переключается на низкочастотное сканирование раз в 5 секунд при отключении геймпада для экономии ресурсов CPU.

Руководство пользователя

После установки дополнения и подключения геймпада:

1. Нажмите NVDA + 1, чтобы включить Справку по вводу (Input Help), и проверьте, правильно ли озвучиваются нажатия кнопок геймпада.
2. Откройте меню NVDA (NVDA + N).
3. Перейдите в Параметры (P) -> Жесты ввода (N)....
4. Выберите команду NVDA, нажмите кнопку Добавить (A), а затем нажмите кнопку геймпада, которую хотите назначить.

Часто задаваемые вопросы (FAQ)

В: Почему мой геймпад не реагирует? О: Убедитесь, что ваш геймпад поддерживает режим XInput (стандарт для большинства современных PC-контроллеров). Вы можете проверить журнал NVDA (log); если там указано «Gamepad connected», значит, устройство распознано.

В: Почему используется только XInput 1.4? О: Это обеспечивает совместимость с нативными драйверами в Windows 8 и выше. Если вы используете более старую версию Windows, возможно, потребуется обновить библиотеки времени выполнения DirectX.

Участие в разработке и обратная связь

Если вы столкнулись с ошибками или у вас есть предложения по функционалу, пожалуйста, свяжитесь с нами через:

• Создайте issue в GitHub Issues.
• Присоединитесь к обсуждению в китайском сообществе NVDA Chinese community.