Remote Desktop Accessibility

Auteurs : Leonard de Ruijter
Télécharger dernière version stable
Compatibilité NVDA : 2024.1 et supérieur

L'extension RDAccess (Remote Desktop Accessibility) ajoute une prise en charge pour accéder aux sessions de bureau à distance à NVDA en utilisant Microsoft Remote Desktop, Citrix ou VMware Horizon. Lorsqu'il est installé dans NVDA sur le client et le serveur, la parole et le braille générées sur le serveur seront verbalisées et affiché en braille par la machine client. Cela permet une expérience utilisateur où la gestion d'un système distant semble tout aussi performante que le fonctionnement du système local.

Caractéristiques

Prise en charge de Microsoft Remote Desktop (y compris Azure Virtual Desktop et Microsoft Cloud PC), Citrix, et VMware Horizon
Sortie de la parole et du braille
Détection automatique du braille distant en utilisant la détection automatique de l'afficheur braille de NVDA
Détection automatique de la parole distante en utilisant un processus de détection dédié qui peut être désactivé dans le dialogue des paramètres de NVDA
Prise en charge des copies portables de NVDA fonctionnant sur un serveur (configuration supplémentaire requise pour Fitrix)
Prise en charge complète pour les copies portables de NVDA fonctionnant sur un client (aucun privilège administrateur supplémentaire requis pour installer l'extension)
Plusieurs sessions de clients actives en même temps
Remote desktop instantanément disponible après le démarrage de NVDA
Possibilité à contrôler les paramètres du synthétiseur et l'afficheur braille spécifiques sans quitter la session distante
Possibilité d'utiliser la parole et le braille de la session utilisateur lors de l'accès à des bureaux sécurisés

Journal des changements

Version 1.5

Ajouter la possibilité de créer un rapport de diagnostic de débogage au moyen d'un bouton du panneau des paramètres RDAccess #23.
Prise en charge des afficheurs braille multi-lignes dans NVDA 2025.1 et plus récent #19.
La version NVDA compatible minimale est maintenant la 2024.1. Suppression de la prise en charge des versions antérieures.
Ajout notifications de connexion du client #25.
Dépendance RdPipe mise à jour.
Traductions mises à jour.

Version 1.4

Nouvelle version stable.

Version 1.3

Correction de la rupture des gestes de l'afficheur braille.

Version 1.2

Utiliser Ruff en tant que format et linter. #13.
Correction d'un problème où NVDA sur le client génère une erreur lors de l'arrêt de la parole sur le serveur.
Correction du support pour winAPI.secureDesktop.post_secureDesktopStateChange.
Amélioration de l'initialisation du pilote sur le serveur.

Version 1.1

Ajout de la prise en charge de style enregistrement du périphérique NVDA 2023.3 pour la détection automatique des afficheurs braille. #11.
Ajout de la prise en charge pour NVDA 2024.1 Alpha winAPI.secureDesktop.post_secureDesktopStateChange extension point. #12.

Version 1.0

Première version stable.

Premiers pas

Installer RDAccess à la fois sur le client et le serveur de la copie de NVDA.
Le système distant doit commencer automatiquement à parler en utilisant le synthétiseur de la parole local. Sinon, dans l'instance NVDA sur le serveur, sélectionnez le synthétiseur de la parole à distance dans le dialogue Sélection du synthétiseur de NVDA.
Pour utiliser le braille, activez la détection automatique de l'afficheur braille en utilisant le dialogue de sélection de l'afficheur braille.

Configuration

Après l'installation, l'extension RDAccess peut être configurée à l'aide de la boîte de dialogue Paramètres de NVDA, accessible à partir du menu de NVDA en choisissant Préférences > Paramètres... Après cela, choisissez la catégorie Bureau distant.

Cette boîte de dialogue contient les paramètres suivants :

Activer remote desktop accessibility pour

Cette liste de cases à cocher contrôle le mode de fonctionnement de l'extension. Vous pouvez choisir entre :

Connexions entrantes (Remote Desktop Server) : Choisissez cette option si l'instance actuelle de NVDA s'exécute sur un serveur de bureau distant.
Connexions sortantes (Remote Desktop Client) : Choisissez cette option si l'instance actuelle de NVDA s'exécute sur un client de bureau distant qui se connecte à un ou plusieurs serveurs.
Passerelle Secure Desktop : Choisissez cette option si vous souhaitez utiliser le braille et la parole dans l'instance utilisateur de NVDA lors de l'accès au bureau distant. Notez que pour que cela fonctionne, vous devez rendre l'extension RDAccess disponible sur le bureau Sécurisé de la copie de NVDA. Pour cela, choisissez "Utiliser les paramètres NVDA actuellement sauvegardés pour l'écran de connexion et sur les écrans sécurisés (nécessite des privilèges administrateur)" dans les paramètres Général de NVDA.

Pour garantir un démarrage en douceur avec l'extension, toutes les options sont activées par défaut. Vous êtes cependant encouragé à désactiver le serveur ou le mode client, le cas échéant.

Récupérer automatiquement la parole à distance après une perte de connexion

Cette option n'est disponible qu'en mode serveur. Il garantit que la connexion sera automatiquement rétablie lorsque le synthétiseur de la parole à distance est actif et que la connexion est perdue. Le comportement est très similaire à celui de la détection automatique de l'afficheur braille.

Cette option est activée par défaut. Vous êtes fortement encouragé à laisser cette option activée si le serveur de bureau distant n'a pas de sortie audio.

Autoriser le système distant à contrôler les paramètres du pilote

Cette option client, lorsqu'elle est activée, vous permet de contrôler les paramètres du pilote (tels que la voix et la hauteur du synthétiseur) du système distant. Les modifications effectuées sur le système distant seront automatiquement reflétées localement.

Conserver le support client lors de la sortie de NVDA

Cette option client n'est disponible que sur des copies installées de NVDA. Lorsqu'il est activé, il garantit que la partie client de NVDA est chargée dans votre client de bureau distant, même lorsque NVDA n'est pas en cours d'exécution.

Pour utiliser la partie client de RDAccess, plusieurs modifications doivent être faites dans le registre Windows. L'extension garantit que ces modifications sont apportées dans le profil de l'utilisateur actuel. Ces modifications ne nécessitent pas de privilèges administrateur. Par conséquent, NVDA peut appliquer automatiquement les modifications nécessaires lors du chargement et annuler ces modifications lors de la sortie de NVDA, garantissant la compatibilité avec les versions portables de NVDA.

Cette option est désactivée par défaut. Cependant, si vous exécutez une copie installée et que vous êtes le seul utilisateur du système, il est conseillé d'activer cette option pour un fonctionnement fluide lors de la connexion à un système distant après après le démarrage de NVDA.

Activer le support de Microsoft Remote Desktop

Cette option est activée par défaut et garantit que la partie client de RDAccess est chargée dans Microsoft Remote Desktop client (mstsc) lors du démarrage de NVDA. Les modifications apportées par cette option seront automatiquement annulées lors de la sortie de NVDA à moins que conserver le support client ne soit activée.

Activer le support de Citrix Workspace

Cette option est activée par défaut et garantit que la partie client de RDAccess est chargée dans l'application Citrix Workspace lors du démarrage de NVDA. Les modifications apportées par cette option seront automatiquement annulées lors de la sortie de NVDA à moins que conserver le support client ne soit activée.

Cette option est disponible uniquement dans les conditions suivantes :

Citrix Workspace est installé. Notez que la version Windows Store de l'application n'est pas prise en charge en raison des limites de l'application elle-même.
Il est possible d'enregistrer RDAccess dans le contexte actuel de l'utilisateur. Après avoir installé l'application, vous devez démarrer une session distante une fois pour l'activer.

Informer les changements de connexion avec

Cette liste déroulante vous permet de contrôler les notifications reçues lorsqu'un système distant ouvre ou arrête la parole à distance ou la connexion braille. Vous pouvez choisir entre :

Désactivé (Pas de notifications)
Messages (par exemple, "À distance braille connecté")
Sons (NVDA 2025.1+)
Messages et sons

Notez que les sons ne sont pas disponibles sur les versions de NVDA antérieures à la 2025.1. Les bips seront utilisés sur des versions plus anciennes.

Ouvrir rapport de diagnostic

Ce bouton ouvre un message navigable avec la sortie JSON contenant plusieurs diagnostics qui peuvent éventuellement aider à déboguer. Lorsqu'un problème est déposer sur GitHub, on pourrait être invité à fournir ce rapport.

Instructions spécifiques de Citrix

Il y a des points importants à noter lors de l'utilisation de RDAccess avec l'application Citrix Workspace :

Exigences côté client

La variante Windows Store de l'application n'est pas prise en charge.
Après avoir installé Citrix Workspace, vous devez démarrer une session distante une fois pour permettre à RDAccess l'enregistrement de lui-même. Cela se produit parce que l'application copie les paramètres du système aux paramètres de l'utilisateur pendant la configuration de la session initiale. Après cela, RDAccess peut s'enregistrer dans le contexte actuel de l'utilisateur.

Exigence côté serveur

Dans Citrix Virtual Apps et Desktops 2109, Citrix a activé la liste d'autorisation de la chaîne virtuelle dites. Cela signifie que les canaux virtuels tiers, y compris le canal requis par RDAccess, ne sont pas autorisés par défaut. Pour plus d'informations, voir ce post sur le blog de Citrix.

Autoriser explicitement le canal RdPipe requis par RDAccess n'est pas encore testé. Pour l'instant, probablement le mieux à faire c'est de désactiver complètement la liste d'autorisation. Si votre administrateur système n'est pas satisfait de cela, n'hésitez pas à signaler en toute liberté l'incidence ici.

Problèmes et contribution

Si vous souhaitez signaler un problème ou contribuer, consultez la page des incidence (issues) sur GitHub.

Composants externes

Cette extension s'appuie sur RD Pipe, une bibliothèque écrite en Rust, soutenant le support du client remote desktop. RD Pipe est redistribué dans le cadre de cette extension en vertu des termes de la version 3 de la GNU Affero General Public License.