Pad2 - Расширенное озвучивание символов для NVDA

Обзор

Дополнение Pad2 предоставляет расширенные возможности для работы с символами под курсором обзора в NVDA. С помощью одной клавиши (NumPad2 или NVDA+.) вы можете получить различную информацию о символе в зависимости от количества нажатий.

Возможности

Одно нажатие: Озвучивание текущего символа
Два нажатия: Описание символа (для китайского языка zh_TW)
Три нажатия: Код символа (десятичный и шестнадцатеричный)
Четыре нажатия: Заглушка для словаря (будет реализовано)
Пять нажатий: Заглушка для тезауруса (будет реализовано)

Использование

Основные жесты

Действие	Жест (Desktop)	Жест (Laptop)	Описание
Одно нажатие	NumPad2	NVDA+.	Озвучивание символа
Два нажатия	NumPad2 (быстро дважды)	NVDA+. (быстро дважды)	Описание символа
Три нажатия	NumPad2 (быстро трижды)	NVDA+. (быстро трижды)	Код символа
Четыре нажатия	NumPad2 (быстро 4 раза)	NVDA+. (быстро 4 раза)	Словарь (в разработке)
Пять нажатий	NumPad2 (быстро 5 раз)	NVDA+. (быстро 5 раз)	Тезаурус (в разработке)

Режимы работы

Режим 1: Озвучивание символа

При однократном нажатии дополнение озвучивает символ, находящийся под курсором обзора. Это стандартное поведение, аналогичное встроенной функции NVDA, но с дополнительной интеграцией с брайлевским дисплеем.

Режим 2: Описание символа

Двойное быстрое нажатие активирует режим описания символа. Дополнение:
- Озвучивает описание символа с помощью функции spellTextInfo
- Получает подробное описание символа из таблицы символов для китайского языка (zh_TW)
- Отображает символ и его описание на брайлевском дисплее

Режим 3: Код символа

Тройное быстрое нажатие показывает техническую информацию о символе:
- Десятичный код Unicode символа
- Шестнадцатеричный код Unicode символа
- Отображение символа и обоих кодов на брайлевском дисплее

Режимы 4-5: Планируемые функции

В текущей версии реализованы как заглушки с информационными сообщениями. Планируется интеграция со словарями и тезаурусами.

Технические детали

Совместимость с API NVDA

Дополнение адаптировано для работы с NVDA 2024-2026.1 и включает обработку различных версий API брайля:

Настройка
Изменение горячих клавиш
Вы можете изменить или добавить дополнительные жесты через диалог “Жесты ввода” NVDA:
1.
Откройте меню NVDA -> “Параметры” -> “Жесты ввода”
2.
Найдите категорию “Просмотр текста”
3.
Найдите скрипт “Сообщает символ под курсором обзора. Одно нажатие — озвучивание символа, два — описание символа, три — код символа, четыре — поиск в словаре, пять — поиск в тезаурусе…”
4.
Добавьте или измените жесты по вашему желанию

Устранение неполадок

Проблема: Дополнение не реагирует на нажатия

Решение: Проверьте, что курсор обзора установлен на тексте. Переместите курсор обзора (обычно стрелками) на нужный символ.

Проблема: Ошибка “module ‘braille’ has no attribute ‘Tether’”

Решение: Обновите NVDA до версии 2024.1 или новее. Дополнение автоматически определяет версию API.

Проблема: Не отображаются описания символов

Решение: Убедитесь, что для вашего языка существуют таблицы описаний символов в NVDA. По умолчанию настроено для zh_TW.