Accesibilidad de registro de tecnología de asistencia

En este artículo se explica cómo registrar una aplicación de accesibilidad con el Centro de accesibilidad. También se explica cómo adaptar la aplicación de accesibilidad para que funcione bien con el escritorio seguro.

El Centro de accesibilidad es una aplicación de Panel de control para Microsoft Windows que reúne la funcionalidad de accesibilidad y facilidad de uso. Mediante el uso del Centro de acceso fácil, los usuarios pueden configurar sus equipos para satisfacer sus necesidades físicas y cognitivas.

Una función del Centro de accesibilidad es ayudar a los usuarios a iniciar aplicaciones de accesibilidad, como Narrador, Teclado en pantalla y Lupa. Las aplicaciones de terceros registradas también aparecen en el Centro de acceso fácil y se pueden iniciar directamente desde allí.

Las aplicaciones de accesibilidad deben funcionar sin problemas con el escritorio seguro. El escritorio seguro es la interfaz de usuario que aparece cuando el equipo está bloqueado (en el inicio de sesión o cuando el usuario ha bloqueado el escritorio) y cuando se le pide que permita una acción potencialmente no segura. Por motivos de seguridad, Windows coloca límites en software de terceros que se ejecuta en el escritorio seguro. Si desea que la aplicación de accesibilidad se ejecute en el escritorio seguro, debe registrar la aplicación con el Centro de acceso fácil.

Registro con el Centro de facilidad de acceso

Las aplicaciones de accesibilidad se registran con el Centro de accesibilidad mediante la creación de una o varias claves del Registro cuando se instala la aplicación. En la tabla siguiente se muestra la información contenida en las claves del Registro.

Localización

Los valores del Registro de Nombre y Descripción de la aplicación deben ser localizables para admitir la interfaz de usuario multilingüe (MUI).

Estas cadenas tienen el siguiente formato, donde los corchetes angulares indican los elementos necesarios y corchetes indican un elemento opcional.

@<ResDllPath\ResDLLFilename>,-<resID>[;< comentario>]

<ResDllPath\ResDLLFilename> es la ruta de acceso al archivo DLL del recurso. La ruta de acceso puede contener variables de entorno.

<resID> es el identificador de recurso de la cadena.

[comentario] contiene cualquier comentario opcional.

Este es un ejemplo:

@%SystemRoot%\system32\anyAT.dll,-5020

Para obtener más información sobre MUI, consulta Centro de conocimiento de MUI de Windows.

Perfil de HCI

El perfil interacción del equipo humano (HCI) es una manera de determinar qué alojamientos proporcionar en función de las necesidades del usuario. Las aplicaciones de accesibilidad deben registrar información sobre el tipo de discapacidad que la aplicación ayuda a dar cabida.

El valor del Registro de perfiles contiene XML que describe el tipo de discapacidad dirigida por la aplicación de accesibilidad. Este XML tiene el formato siguiente:

<HCIModel>
<Accommodation type="disability"/>
</HCIModel>

Los valores válidos para el atributo Tipo de alojamiento son los siguientes:

• visión leve
• visión grave
• cognitivo leve
• cognitivo grave
• dexteridad leve
• dexteridad grave
• audición leve
• audición grave
• voz leve
• voz grave

Si una aplicación de accesibilidad admite varios alojamientos, el valor del Registro de perfiles debe incluir un atributo tipo de alojamiento para cada alojamiento.

Facilidad de acceso a los detalles del registro

Para registrar la aplicación de accesibilidad, debe crear una clave para la aplicación en la siguiente ubicación del Registro y rellenarla con pares nombre-valor.

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\

Asigne un nombre a la clave del Registro de la aplicación con el siguiente formato:

"CompanyName_ProductName_v#"

Por ejemplo, "Contoso_Magnifier_v2.0".

Para agregar valores del Registro, el programa de instalación debe ejecutarse con privilegios elevados.

Alojamiento seguro de escritorio

La clave del Registro SecureDesktopAccommodation le permite especificar cómo responde la aplicación de accesibilidad al escritorio seguro. De forma predeterminada, el Centro de acceso fácil inicia la aplicación en el escritorio seguro si ya se estaba ejecutando en el escritorio normal o si está configurado para ejecutarse en el escritorio de inicio de sesión. Mediante la clave SecureDesktopAccommodation , puede hacer lo siguiente:

• Especifique una versión alternativa de la aplicación para su uso en el escritorio seguro. Por ejemplo, es posible que tenga una versión alternativa que deshabilite las características no seguros o esté optimizada para usar menos memoria e iniciarse más rápido.

  Para especificar la versión alternativa, establezca la clave SecureDesktopAccommodation en el nombre de la versión alternativa. Por ejemplo, si registró la aplicación en la clave Contoso_Screen Reader_v1.0, podría registrar la versión alternativa en Contoso_Screen ReaderSecure_v1.0. A continuación, establezca la clave SecureDesktopAccommodation de Contoso_Screen Reader_v1.0 en "Contoso_Screen ReaderSecure_v1.0".

• Especifique una aplicación de accesibilidad de Microsoft que se usará en el escritorio seguro en lugar de la aplicación. Para esta opción, establezca SecureDesktopAccommodation en el nombre de la aplicación de accesibilidad de Microsoft determinada: "osk", "magnifierpane" o "Narrador".

• Especifique que la aplicación no se debe ejecutar en el escritorio seguro y ninguna de las aplicaciones alternativas. Para esta opción, establezca SecureDesktopAccommodation en "none" (recommend) o el nombre de una aplicación inexistente.

Si la clave del Registro SecureDesktopAccommodation para la aplicación de accesibilidad especifica una aplicación de accesibilidad de Microsoft que se va a ejecutar en el escritorio seguro en lugar de la aplicación, Windows notifica al usuario que realiza la transición al escritorio seguro. Para notificar al usuario, Windows muestra la cadena especificada en la clave del Registro Descripción de la aplicación. Por ejemplo, si la aplicación ScreenReader Deluxe 1.0 usa Microsoft Narrator en el escritorio seguro, incluiría una cadena Description como "Microsoft Narrator se usará en el escritorio seguro, inicio de sesión y otros escritorios seguros en lugar de ScreenReader Deluxe 1.0".

Si la clave SecureDesktopAccommodation de la aplicación está establecida en "none", use la clave Description para indicar al usuario que la aplicación no está disponible en el escritorio seguro y no se proporciona ninguna alternativa.

Windows muestra el texto Descripción en las ubicaciones pertinentes del Centro de acceso.

Ejecución en la instalación y en el escritorio de inicio de sesión

Si anexa el nombre de clave registrada de la aplicación de accesibilidad a la cadena en la siguiente ubicación del Registro, Windows iniciará la aplicación inmediatamente después de instalarla. Además, Windows ejecutará automáticamente la aplicación cada vez que el escritorio de inicio de sesión esté activo.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\Accessibility\Configuration

La clave de configuración es una cadena delimitada por comas. Para agregar la aplicación, anexe una cadena que sea la misma que la clave del Registro de la aplicación en HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\.

Ejecución en un trabajo

Si la clave del Registro TerminateOnDesktopSwitch no está presente o está establecida en distinto de cero, Windows ejecuta la aplicación en el contexto de un trabajo, finalizando y reiniciando la aplicación con cada transición de escritorio. La ejecución en un trabajo garantiza que solo se ejecuta una sola instancia de la aplicación en un momento determinado y libera a la aplicación de tener que supervisar el estado del escritorio. Las desventajas de ejecutarse en un trabajo incluyen:

• La aplicación incurre en un costo de inicio con cada transición de escritorio.
• La aplicación solo se puede iniciar a través del Centro de acceso fácil.
• La aplicación debe guardar continuamente su configuración porque una transición de escritorio puede finalizarla en cualquier momento.

Si la clave TerminateOnDesktopSwitch existe y se establece en 0, Windows no ejecuta la aplicación de accesibilidad en un trabajo. Esto tiene las ventajas siguientes:

• No hay costos de inicio asociados a las transiciones de escritorio.
• La aplicación se puede iniciar fuera del Centro de acceso.

Las desventajas de no ejecutarse en un trabajo incluyen:

• Dado que la aplicación no se reinicia en las transiciones de escritorio, debe detectar cuándo el escritorio actual está inactivo y responder adecuadamente. Por ejemplo, la aplicación debe renunciar al control de hardware para que la versión de escritorio segura de la aplicación pueda usarla y la aplicación debe entrar en modo de suspensión para evitar el uso de recursos de procesador.
• Si la aplicación se puede iniciar a través del menú Inicio, el Explorador de Windows o la línea de comandos, debe informarse sobre la facilidad de acceso. Para obtener más información, vea Tecla del logotipo de Windows + U.
• Dado que varias copias de la aplicación se pueden ejecutar simultáneamente en diferentes escritorios, la aplicación debe escribirse para admitir varias copias en ejecución.

Tecla del logotipo de Windows + U

Si la aplicación de accesibilidad está configurada para ejecutarse en un trabajo, el código de inicio de la aplicación debe incluir una llamada a la función IsProcessInJob para determinar si la aplicación se está iniciando en un trabajo. Si es así, la aplicación debe iniciar el Centro de acceso y, a continuación, salir. En el ejemplo siguiente se muestra cómo llamar a IsProcessInJob.

BOOL fAlreadyInJob;
BOOL fSuccess = IsProcessInJob(GetCurrentProcess(), NULL, &fAlreadyInJob); 

Si la aplicación de accesibilidad está configurada para ejecutarse fuera de un trabajo, debe notificar al Centro de acceso fácil que la aplicación se está iniciando y continúa como es normal.

Independientemente de cómo se configure la aplicación, si proporciona una manera de salir desde dentro de la aplicación, como un botón Cerrar, la aplicación debe notificar a la Facilidad de acceso centro que sale.

Una aplicación notifica al Centro de acceso la facilidad de acceso estableciendo una clave temporal del Registro e insertando la combinación de teclas Logotipo de Windows + U en el flujo de entrada.

La aplicación debe crear la clave temporal en la siguiente ubicación.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\AccessibilityTemp

La clave temporal debe tener el mismo nombre que el nombre de la aplicación registrada, como "Contoso_Screen Reader_v1.0". El valor de la clave es un DWORD establecido en 0x0003 cuando se inicia o 0x0002 cuando se sale de la aplicación.

INPUT input[4] = {0};

input[0].type = INPUT_KEYBOARD;
input[0].ki.wVk = VK_LWIN;
input[0].ki.dwFlags = 0;

input[1].type = INPUT_KEYBOARD;
input[1].ki.wVk = 0x55; // U key
input[1].ki.dwFlags = 0;

input[2].type = INPUT_KEYBOARD;
input[2].ki.wVk = 0x55; // U key
input[2].ki.dwFlags = KEYEVENTF_KEYUP;

input[3].type = INPUT_KEYBOARD;
input[3].ki.wVk = VK_LWIN;
input[3].ki.dwFlags = KEYEVENTF_KEYUP;

SendInput(ARRAYSIZE(input), input, sizeof(input[0]));

Tecla del logotipo de Windows + Subir volumen

Cuando el usuario inicia la aplicación de accesibilidad presionando la combinación de teclas Logotipo de Windows + Subir volumen (por ejemplo, en un dispositivo de tableta), el Centro de acceso pasa el siguiente argumento de línea de comandos a la aplicación:

/hardwarebuttonlaunch

La aplicación puede usar este argumento para determinar si se debe iniciar normalmente o para ajustar el comportamiento en consecuencia.

Transferencia de la configuración de escritorio seguro

Si la aplicación de accesibilidad admite el escritorio seguro, puede usar el registro para copiar la configuración cuando la aplicación pasa al escritorio seguro. Copiar la configuración ayuda a que la transición al escritorio seguro sea más fluida para el usuario.

Para copiar la configuración, establezca la clave del Registro CopySettingsToLockedDesktop de la aplicación en 1 y almacene la configuración en la siguiente ubicación del Registro.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\Accessibility\ATConfig\<AT Key Name>

El Centro de acceso supervisa esta ubicación del Registro mientras se ejecuta la aplicación. Cuando se produce una transición al escritorio seguro, el Centro de acceso fácil copia la configuración en la misma ubicación en el subárbol HKCU de escritorio seguro. Después, la aplicación puede leer la configuración y reanudar su estado.

La aplicación de accesibilidad debe escribir su configuración a intervalos regulares o cada vez que cambien los valores. La escritura de la configuración en la salida de la aplicación no funcionará. Si la aplicación se ejecuta en un trabajo, se termina en la transición fuera del escritorio seguro, antes de que el código de salida tenga la oportunidad de ejecutarse. Si la aplicación no se ejecuta en un trabajo, la aplicación no finaliza en la transición fuera del escritorio seguro.

Precaución

Dado que las claves del Registro que se describen aquí están escritas en modo de usuario, no son seguras. Si la aplicación de accesibilidad lee el contenido de estas claves, debe comprobar cuidadosamente los datos y usarlos con precaución. En concreto, la aplicación debe realizar una comprobación de límites en los valores DWORD , tener cuidado con las longitudes de cadena, no debe leer nombres dll de complemento y no debe ejecutar ningún comando encontrado en cadenas.

Ejemplos del Registro

En el ejemplo siguiente se muestran los posibles valores del Registro para un producto ficticio denominado Contoso ScreenReader versión 2.0, cuyo nombre localizado se almacena como un recurso.

Los valores de la tabla están bajo la clave siguiente:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\Contoso_Screen Reader_v2.0

<HCIModel>
   <Accommodation type="low vision">
   <Accommodation type="severe vision">
   <Accommodation type="mild cognitive">
</HCIModel>

Si la aplicación proporciona un lector de pantalla y una lupa de pantalla en un único ejecutable, los valores del componente lector de pantalla podrían tener este aspecto:

<HCIModel>
   <Accommodation type="low vision">
   <Accommodation type="severe vision">
   <Accommodation type="mild cognitive">
</HCIModel>

Los valores del componente de lupa estarían en la siguiente clave:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Contosoibility\ATs\Contoso_Magnifier_v2.0

<HCIModel>
   <Accommodation type="mild vision">
</HCIModel>