UnicornNVDA (Интеграция UnicornDVC для NVDA)

Оглавление

• О программе
• Начало работы
• Использование

Информация

UnicornNVDA - это дополнение, которое облегчает обмен данными между NVDA и внешней библиотекой Unicorn. Дополнение обеспечивает обмен информацией между локальным и удаленным экземплярами NVDA, например, ввод данных шрифтом Брайля/речью, а также вывод данных. Дополнение предоставляет простой способ использования библиотеки UnicornDVC.

Последняя версия дополнения и библиотеку можно загрузить с веб-сайта Babbage.

Начало работы

Эти инструкции позволят вам запустить копию проекта на вашем локальном компьютере для целей разработки и тестирования. Unicorn NVDA - это проект на python, который выполняется в виртуальной среде.

Предварительные условия

Для запуска проекта требуется несколько вещей

• SCons: инструмент для создания программного обеспечения. Смотрите scons документация или на странице скачать для получения дополнительной информации об установке SCons
• Это 32-разрядная версия python, последнюю версию можно найти на их странице загрузки.
• NVDA, последнюю версию можно найти на их странице загрузки.
• UnicornDVC, последнюю версию можно найти на странице [загрузки] access4u(https://access4u.eu/downloads/).

Установка

Установка проекта довольно проста.

1. Клонировать запустите проект локально.
2. Запустите команду py -m SCons в корневой папке terminal. Это создаст проект и выведет unicornaddon.
3. (Необязательно) Вы можете добавить файл .env в корневую папку, чтобы включить intellisense для библиотек в NVDA. Для этого вам сначала нужно установить среду NvdaDevEnvironment, следуйте этому хорошо написанному руководству(https://github.com/nvaccess/nvda/blob/master/projectDocs/dev/createDevEnvironment.md). Затем добавьте файл с именем .env в корневую папку, затем добавьте PYTHONPATH="PathNameToNvdaDirectory" в файл .env.
4. Дважды щелкнув по дополнению, когда NVDA открыт, вы сможете установить дополнение для NVDA.

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

Структура файла и кода

Код проекта можно найти в папке addon/globalPlugins/unicorn. addon/doc содержит файлы локализации.

• _init_.py содержит код инициализации, а также функции обратного вызова, которые вызываются NVDA. Он создает настройки DVCtransport и DialogSettings, а также обработку обратные вызовы, вызываемые самим NVDA.

• transport.py содержит функциональность кода обратного вызова для UnicornDVC. Транспортный класс управляет передачей данных, например, шрифта Брайля или речи, от клиента Nvda к серверу Nvda и наоборот. Он делает это с помощью класса Unicorn, определенного в unicorn.py, и вызывает множество обратных вызовов, а также предоставляет обратные вызовы applib. Важными обратными вызовами, вызываемыми здесь, являются, например, OnNewChannelConnection(), Write() и т.д.

• unicorn.py содержит обработчик обратного вызова из NVDA в applib и наоборот. Этот класс позволяет unicorn applib вызывать функции.

Как тестировать/отлаживать

Поскольку код выполняется в виртуальной среде разработки, мы не можем полностью выполнять отладку с помощью консоли, как это было бы привычно для традиционных отладчиков. Вместо этого, поскольку это дополнение запускается NVDA, нам нужно настроить уровень ведения журнала в редакторе реестра по адресу: `Компьютер\HKEY_CURRENT_USER\Программное обеспечение\ACCESS4U\UnicornDVC" Настройка ведения журнала уровень, равный 5, приведет к переходу на уровень отладки; установка уровня ведения журнала на 6, наивысшего уровня, приведет к переходу на подробный уровень. Кроме того, вы можете включить режим отладки в nvda, перезапустив его с включенной отладкой или изменив его в настройках.

Журналы можно найти в папке %Temp% на вашем компьютере. В папке Temp вы можете найти следующие файлы:

• nvda.log Здесь содержатся выходные данные nvda и журналы, которые вы будете выводить с помощью обработчика журнала.
• UnicornDVCAppLib_DatePrintedInNumbers.log Это содержит выходные данные applib из библиотеки UnicornDVC.
• UnicornDVCPlugin_DatePrintedInNumbers.log Здесь содержатся выходные данные плагина из библиотеки UnicornDVC.

Журналы applib и plugin создаются только при подключении в качестве клиента/сервера или при подключении к RDP соответственно. Эти журналы получены из UnicornDVC, для получения документации о том, что такое ошибки и определения журналов, посетите Access4u.

Перевод

• Валентин Куприянов: Русский язык

• UnicornNVDA-V.4.21.1.nvda-addon
• UnicornNVDA-V.3.0.nvda-addon
• UnicornNVDA-V.2024.2.1.nvda-addon
• UnicornNVDA-V.2022.1.nvda-addon