RdAccess (Доступность удаленных рабочих столов)

• Авторы: Leonard de Ruijter
• Скачать последнюю стабильную версию
• Совместимость с NVDA: 2024.1 и новее

Дополнение RDAccess (Remote Desktop Accessibility) добавляет поддержку сеансов удалённого рабочего стола Microsoft Remote Desktop, Citrix, Parallels RAS или VMware Horizon для NVDA. При установке на клиенте и на сервере речь и брайль, сгенерированные на сервере, будут озвучены и отображены на брайлевском дисплее на клиентской машине. Это обеспечивает пользовательский опыт, при котором управление удалённой системой ощущается так же бесшовно, как работа с локальной системой.

Возможности

• Поддержка Microsoft Remote Desktop (включая Azure Virtual Desktop и Microsoft Cloud PC), Citrix, Parallels RAS и VMware Horizon
• Вывод речи и брайля
• Автоматическое определение удалённого брайля с использованием автоматического обнаружения брайлевских дисплеев NVDA
• Автоматическое определение удалённой речи с помощью специального процесса обнаружения, который можно отключить в диалоге настроек NVDA
• Поддержка портативных копий NVDA, работающих на сервере (для Citrix требуется дополнительная настройка)
• Полная поддержка портативных копий NVDA, работающих на клиенте (для установки дополнения не требуются дополнительные административные привилегии)
• Несколько активных клиентских сеансов одновременно
• Удалённый рабочий стол доступен сразу после запуска NVDA
• Возможность управлять определёнными настройками синтезатора и брайлевского дисплея, не выходя из удалённого сеанса

Журнал изменений

Версия 1.7

• Удалена поддержка защищённого рабочего стола.

Версия 1.6

• Документирована и улучшена поддержка Parallels RAS.
• Минимальная совместимая версия NVDA теперь — 2025.1. Поддержка более ранних версий удалена.
• Обновлена зависимость RdPipe.
• Добавлена возможность настраивать уровень ведения журнала RdPipe.
• Добавлено средство просмотра журнала RdPipe, доступное из панели настроек.
• Улучшено поведение при удалении (больше не вызывает ошибок и не удаляет поддержку Citrix, если Citrix недоступен).

Версия 1.5

• Добавлена возможность создавать отчёт диагностики для отладки с помощью кнопки на панели настроек RDAccess #23.
• Поддержка многострочных брайлевских дисплеев в NVDA 2025.1 и новее #19.
• Минимальная совместимая версия NVDA теперь — 2024.1. Поддержка более ранних версий удалена.
• Добавлены уведомления о подключении клиента #25.
• Обновлена зависимость RdPipe.
• Обновлены переводы.

Версия 1.4

• Новая стабильная версия.

Версия 1.3

• Исправлены неработающие жесты на брайлевском дисплее.

Версия 1.2

• Использование Ruff в качестве форматтера и линтера. #13.
• Исправлена проблема, когда NVDA на клиенте генерирует ошибку при приостановке речи на сервере.
• Исправлена поддержка winAPI.secureDesktop.post_secureDesktopStateChange.
• Улучшена инициализация драйвера на сервере.

Версия 1.1

• Добавлена поддержка регистрации устройств в стиле NVDA 2023.3 для автоматического обнаружения брайлевских дисплеев. #11.
• Добавлена поддержка точки расширения winAPI.secureDesktop.post_secureDesktopStateChange в NVDA 2024.1 Alpha. #12.

Версия 1.0

Первая стабильная версия.

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

1. Установите RDAccess как на клиентскую, так и на серверную копию NVDA.
2. Удалённая система должна автоматически начать говорить с использованием локального синтезатора речи. Если этого не произошло, в экземпляре NVDA на сервере выберите удалённый синтезатор речи в диалоге выбора синтезатора NVDA.
3. Для использования брайля включите автоматическое обнаружение брайлевского дисплея с помощью диалога выбора брайлевского дисплея.

Настройка

После установки дополнение RDAccess можно настроить с помощью диалога настроек NVDA, доступного из меню NVDA, выбрав «Параметры» > «Настройки...». Затем выберите категорию «Удалённый рабочий стол».

Этот диалог содержит следующие настройки:

Включить удалённую доступность рабочего стола для

Этот список флажков управляет режимом работы дополнения. Выберите между:

• Входящие подключения (сервер удалённого рабочего стола): Выберите эту опцию, если текущий экземпляр NVDA работает на сервере удалённого рабочего стола.
• Исходящие подключения (клиент удалённого рабочего стола): Выберите эту опцию, если текущий экземпляр NVDA работает на клиенте удалённого рабочего стола, который подключается к одному или нескольким серверам.

Для обеспечения беспроблемного начала работы с дополнением все опции включены по умолчанию. Однако рекомендуется отключить серверный или клиентский режим по мере необходимости.

Автоматически восстанавливать удалённую речь после потери соединения

Эта опция доступна только в серверном режиме. Она гарантирует, что соединение будет автоматически восстановлено, когда активен синтезатор удалённой речи и соединение потеряно, аналогично автоматическому обнаружению брайлевского дисплея.

Эта опция включена по умолчанию. Настоятельно рекомендуется оставить эту опцию включённой, если на сервере удалённого рабочего стола нет аудиовыхода.

Разрешить удалённой системе управлять настройками драйверов

При включении на клиенте эта опция позволяет управлять настройками драйверов (такими как голос и высота тона синтезатора) с удалённой системы. Изменения, сделанные на удалённой системе, автоматически отразятся локально.

Сохранять клиентскую поддержку при выходе из NVDA

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

Для использования клиентской части RDAccess необходимо внести изменения в реестр Windows. Дополнение гарантирует, что эти изменения вносятся в профиль текущего пользователя, не требуя административных привилегий. Следовательно, NVDA может автоматически применять необходимые изменения при загрузке и отменять эти изменения при выходе из NVDA, обеспечивая совместимость с портативными версиями NVDA.

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

Включить поддержку удалённого рабочего стола по умолчанию

Эта опция, включённая по умолчанию, гарантирует, что клиентская часть RDAccess загружается в клиенте Microsoft Remote Desktop (mstsc) при запуске NVDA. Это также требуется для VMware Horizon, Parallels RAS, Azure Virtual Desktop и т.д. Изменения, внесённые через эту опцию, будут автоматически отменены при выходе из NVDA, если не включена постоянная клиентская поддержка.

Включить поддержку Citrix Workspace

Эта опция, включённая по умолчанию, гарантирует, что клиентская часть RDAccess загружается в приложении Citrix Workspace при запуске NVDA. Изменения, внесённые через эту опцию, будут автоматически отменены при выходе из NVDA, если не включена постоянная клиентская поддержка.

Эта опция доступна только при следующих условиях:

• Установлен Citrix Workspace. Обратите внимание, что версия приложения из Магазина Windows не поддерживается из-за ограничений самого приложения.
• Возможно зарегистрировать RDAccess в контексте текущего пользователя. После установки приложения вам необходимо один раз запустить удалённый сеанс, чтобы включить это.

Уведомлять об изменениях подключения с помощью

Этот комбинированный список позволяет управлять уведомлениями, получаемыми при открытии или закрытии удалённой системой соединения с речью или брайлем. Вы можете выбрать между:

• Выкл. (без уведомлений)
• Сообщения (например, «Удалённый брайль подключён»)
• Звуки (NVDA 2025.1+)
• Сообщения и звуки

Обратите внимание, что звуки недоступны в версиях NVDA старше 2025.1. В более старых версиях будут использоваться звуковые сигналы.

Открыть отчёт диагностики

Эта кнопка открывает просматриваемое сообщение с выводом JSON, содержащим несколько диагностических данных, которые могут помочь в отладке. При создании issue на GitHub вас могут попросить предоставить этот отчёт.

Особые инструкции для Citrix

При использовании RDAccess с приложением Citrix Workspace следует обратить внимание на важные моменты:

Требования на стороне клиента

1. Вариант приложения из Магазина Windows не поддерживается.
2. После установки Citrix Workspace вам необходимо один раз запустить удалённый сеанс, чтобы позволить RDAccess зарегистрироваться. Это происходит потому, что приложение копирует системные настройки в пользовательские во время начальной настройки сеанса. После этого RDAccess может зарегистрироваться в контексте текущего пользователя.

Требование на стороне сервера

В Citrix Virtual Apps and Desktops 2109, Citrix включила так называемый список разрешённых виртуальных каналов, ограничивая по умолчанию сторонние виртуальные каналы, включая канал, требуемый RDAccess. Для получения дополнительной информации см. этот пост в блоге Citrix.

Явное разрешение канала RdPipe, требуемого RDAccess, ещё не тестировалось. Пока что лучше полностью отключить список разрешённых. Если у вашего системного администратора есть опасения, вы можете обратиться к этой проблеме здесь.

Проблемы и участие

Чтобы сообщить о проблеме или принять участие в разработке, обратитесь к странице issues на Github.

Внешние компоненты

Это дополнение использует RD Pipe, библиотеку, написанную на Rust, которая обеспечивает поддержку клиента удалённого рабочего стола. RD Pipe распространяется как часть этого дополнения на условиях версии 3 GNU Affero General Public License.

[[!tag stable dev beta]]