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.
5. Дважды щелкнув по дополнению, когда NVDA открыт, вы сможете установить дополнение для NVDA.
Код проекта можно найти в папке addon/globalPlugins/unicorn. addon/doc содержит файлы локализации.
_init_.py содержит код инициализации, а также функции обратного вызова, которые вызываются NVDA. Он создает настройки DVCtransport и DialogSettings, а также обработку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.