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

Обзор

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

Возможности

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

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

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

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

Режим 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.