Reproductor multimedia VLC: complementos de accesibilidad - manual del usuario
Auteur: paulber19 con la participación muy activa de Daniel Poiraud.
URL: paulber19@laposte.net
Descargar:
Compatibilidad:
- mínima de NVDA requerida: 2019.1
- última versión de NVDA probada: 2019.3
Índice
1. Introducción
1.1. Funcionalidades
Este complemento añade varias órdenes para facilitar la reproducción de medios con NVDA.
- script para anunciar la duración del medio que ya has reproducido,
- script para anunciar la duración del medio restante por reproducir,
- script para anunciar la duración total del medio,
- script para anunciar la velocidad actual,
- anuncio automático de cambios de estado, como pausa, sonido silenciado, cambio de tono o velocidad de reproducción, y la configuración de reproducción repetida o aleatoria,
- anuncio automático de la duración después de una órdene de salto,
- scripts para marcar la posición de reproducción y iniciar la reproducción en esta posición,
- script para reanudar la reproducción interrumpida del tiempo memorizado por VLC,
- lectura correcta de la barra de estado,
- posibilidad de modificar algunos atajos de teclado problemáticos de VLC.
y otras mejoras como:
- el acceso a los controles de reproducción (idea de la función de Javi Domínguez),
- el acceso al diálogo Efectos y filtros,
- el anuncio correcto del nombre y el valor de los potenciómetros,
- la eliminación de texto html innecesaria en la descripción de algunos objetos (código fuente de Javi Domínguez).
1.2. Compatibilidad
Esta versión es compatible con versiones de VLC superiores a 3.0.
2. Gestos de Entrada proporcionados por el complemento:
- NVDA+Control+H: Mostrar ayuda sobre posibles órdenes en la ventana principal,
- coma: anunciar la duración ya reproducido del medio,
- punto: anunciar la duración restante del medio para ser reproducido,
- guión: anunciar la duración total del medio,
- n tilde: anunciar la velocidad de reproducción,
- Control + coma: Mostrar el cuadro de diálogo para establecer el tiempo y mover el cursor de reproducción en este tiempo,
- NVDA+control+f5: guardar el tiempo actual del medio para una futura reanudación de la reproducción,
- NVDA+control+f6: reanudar la reproducción del tiempo registrado para este medio,
- alt+control+r: reanudar la reproducción interrumpida en la posición memorizada por VLC.
Estos gestos de entrada se pueden modificar con el cuadro de diálogo "Gestos de entrada" de NVDA.
3. Órdenes de teclado propios a VLC verbalizados por el complemento:
Algunos atajos predeterminados de VLC son problemáticos y deben modificarse. Son:
- Las órdenes de teclado "cierra corchete" y "abre corchete" para la velocidad de reproducción un poco más rápido o un poco más lento, porque no se pueden utilizar en el teclado francés. Serán reemplazados por "I" y "U". Nota del traductor: Estos mismos serán reemplazados en el teclado español.
- Las órdenes de teclado "control+alt+flecha derecha o izquierda" para avanzar o retroceder de 5 minutos el medio, porque no funciona en algunas configuraciones. Se reemplazarán por "control+mayúscula+flecha derecha o izquierda".
- Las órdenes de teclado "+" y "-" teclado alfanumérico para cambiar la velocidad de reproducción, porque están mal colocados. Serán reemplazados por "o" y "y".
Para configurar estos nuevos atajos, debe modificar el archivo de configuración "vlcrc" de VLC como sigue:
- después de instalar VLC o eliminar la carpeta de configuración de VLC, inícielo una vez con el atajo del escritorio o reproduciendo un medio y luego deténgalo.
- pulsar "NVDA+n" y en el submenú "Preferencias", seleccione el submenú "Reproductor multimedia VLC: complementos de accesibilidad - opciones",
- por último, pulsa el botón "Modificar los atajos del Reproductor multimedia VLC".
Aquí están las órdenes de teclado que este complemento verbaliza:
- Y: decrementar la velocidad de reproducción.
- U: decrementar un poco la velocidad de reproducción.
- I: incrementar un poco la velocidad de reproducción.
- O: incrementar la velocidad de reproducción.
- abrir exclamación: retorno a la velocidad normal,
- m: silenciar o desilenciar el sonido,
- espacio: iniciar o pausar la reproducción,
- s: detener el medio,
- l: alternar el estado de repetición del medios entre repetir todo, repetir el medio actual, no repetir,
- mayúscula + flecha derecha o izquierda: avanzar o retroceder la duración reproducido del medio de 3 segundos,
- alt + flecha derecha o izquierda: avanzar o retroceder la duración reproducido del medio de 10 segundos,
- control + flecha derecha o izquierda: avanzar o retroceder la duración reproducido del medio de 1 minuto,
- control mayúscula + flecha derecha o izquierda: avanzar o retroceder la duración reproducido del medio de 5 minutos.
- flecha arriba o abajo: subir o bajar el volumen,
- control flecha arriba o abajo: subir o bajar el volumen,
- espacio: poner en pausa el medio o reanudar la reproducción.
Para no molestar al usuario, el tiempo reproducido automáticamente solo se verbaliza cuando el medio está en pausa o se está reproduciendo con el sonido silenciado.
Se realiza una comprobación para evitar un salto fuera de los límites del medio. Por ejemplo, No es posible hacer un salto de 5 minutos Si quedan sólo 2 minutos restantes para reproducir o bien retroceder de 10 segundos si la duración ya reproducida es de 3 segundos.
El estado "sonido silenciado" es señalado al iniciar la reproducción.
El nivel de volumen se anuncia en cada cambio.
El pasaje en pausa es anunciado.
Las opciones "Anunciar automáticamente el nivel de volumen" y "Anunciar automáticamente el tiempo transcurrido" controlan el comportamiento del complemento. De manera predeterminada, se habilitan estas dos opciones.
Cada opción se puede modificar mediante el cuadro de diálogo que te permite configurar el complemento o con un script sin gesto de entrada asignado por defecto.
4. Script Mostrar el cuadro de diálogo para establecer el tiempo y mover el cursor de reproducción en este tiempo
VLC ofrece la posibilidad de utilizar el atajo "control+t" para moverse a un tiempo específico del medio. Pero el cuadro de diálogo que se presenta plantea problemas de accesibilidad.
Este complemento ofrece otra solución (preferible) para moverse a un tiempo con el atajo "control+coma".
Este atajo presenta un cuadro de diálogo que te permite configurar el tiempo (horas, minutos, segundos) para colocar el cursor de reproducción del medio, dentro de los límites de la duración totale del medio disminuido de 5 segundos.
5. Reanudar la reproducción
Para reanudar la reproducción de un medio, son posibles dos soluciones:
5.1. Primera solución
VLC almacena la posición de la reproducción actual cuando esta se interrumpe, es decir, ya sea seguido de una órden de VLC, ya sea al salir de la aplicación.
Cuando se reinicia el medio, VLC muestra la posibilidad de reanudar en la barra de estado por un tiempo muy corto (unos segundos) y al pulsar el atajo "alt+r", la reproducción se reinicia en la posición registrada para este medio.
Como esto es difícil de usar por la gente ciega, este complemento proporciona un script que permite que la reproducción se reanude en la posición registrada por VLC sin tener esta restricción de tiempo.
Cuando se reinicia un medio y VLC ha registrado, para este medio, una posición para reanudar la reproducción, el mensaje de voz "Reanudar la reproducción alt+control+r" lo indica. Al utilizar el gesto de entrada "alt+control+r", la reproducción del medio continúa en la posición registrada.
Este gesto de entrada puede ser modificado por el usuario.
5.2. Segunda solución
Esta segunda solución requiere en primer lugar marcar una posición para reanudar la reproducción con el gesto de entrada "nvda+control+f5".
Es preferible de poner en pausa el medio de antemano.
No tienes que salir de VLC para reanudar la reproducción de este medio.
Para reanudar la reproducción de un medio, la órdenes de teclado "NVDA+control+f6" reiniciará la reproducción en la posición registrada por el complemento para este medio.
Esta posición se guarda en el archivo de configuración del complemento y para cada medio se registra el nombre del medio y la posición asociada. En este archivo solo se guardan los medios abiertos más recientemente.
Advertencia: el nombre del medio es único en este archivo. Si dos archivos con el mismo nombre están en carpetas diferentes, solo se conservará el último registro para ese nombre.
Algunos medios tal como una radio, no permiten el uso de esta característica. Esto se determina por la ausencia de tiempo total.
6. Acceso a los controles de reproducción
VLC presenta loss elementos de control de reproducción del medio (principalmente los botones y casillas de verificación) que no son alcanzables por el teclado.
Aunque los atajos de VLC permiten realizar ciertas funciones de estos elementos, el complemento da el acceso a estos controles usando la tecla "Tab".
Estos controles se agrupan en un panel virtual.
La entrada en este panel es señalado por el anuncio "Panel de control".
La salida del panel es señalado por el anuncio del título del medio seguido de "ventana enfocado".
En este panel, la tecla "Tab" permite pasar al siguiente elemento, "mayúscula + Tab" al elemento anterior.
Es posible activar un elemento con la tecla "Intro".
Advertencia: la barra espaciadora pone en pausa o reinicia la reproducción del medio, pero no activa el elemento.
La opción "Acceso a los controles de reproducción" permite cambiar el comportamiento configurado por defecto.
7. Complementos tecnicos
7.1. Reinicialización de la configuración de VLC
Cuando VLC arranca por primera vez, crea en la carpeta de configuración de usuario de Windows, la carpeta "vlc" que contiene los archivos de configuración de VLC.
Para restablecer la configuración de VLC sin tener que reinstalarlo, simplemente elimine esta carpeta.
Para facilitar esto, el complemento ofrece el botón "Eliminar la carpeta de configuración de VLC" en el cuadro de diálogo de configuración del complemento.
Después, si el botón "Modificar los atajos del Reproductor multimedia VLC" debe utilizarse, es necesario iniciar VLC al menos una vez para volver a crear esta carpeta y los archivos de configuración de VLC.
7.2. Soporte multilingüe del Reproductor multimedia VLC
Dado que los diseñadores del reproductor multimedia no pretenden que el software proporcione información relevante para identificar los objetos que lo constituyen, este complemento se basa en su nombre o descripción.
Para hacer esto, es necesario definir para cada idioma de VLC los objetos utilizados por el complemento. Estas definiciones se encuentran en los archivos "strings-xx.ini" (xx = identificador de idioma) de la carpeta "VLCLocale" del complemento.
Estos archivos se guardan en codificación "UTF-8" sin BOM.
Para conocer el idioma configurado en VLC, este complemento usa el nombre del segundo menú de la barra de menús y es la clave "StringToFindLanguage" de la sección "main" que lo define.
La sección "VLC" del archivo contiene las claves para identificar los objetos. Son:
- VLCAppTitle = establece el título de la ventana de VLC sin el medio lanzado.
- PlayButtonDescription = Define la descripción del botón de reproducción
- PauseThePlaybackButtonDescription = Define la descripción del botón de pausa
- UnMuteImageDescription = define la descripción del botón para silenciar o desilenciar el sonido
- LoopCheckButtonDescription = define la descripción del botón para poner la reproducción del medio en modo repetición o no.
- RandomCheckButtonDescription = define la descripción del botón para la reproducción normal o aleatoria
7.3. Definición de las órdenes de teclado a modificar
Como se mencionó anteriormente, algunos atajos de VLC no son explotables dependiendo del tipo de teclado. Este complemento permite definirlos y modificarlos.
Las definiciones de estos atajos a modificar están en el archivo "settings.ini" de la carpeta "locale" para cada idioma de NVDA admitido por el complemento.
En este archivo, la sección "vlc-keynames" definidos por un número, los identificadores VLC de los atajos a modificar y la sección "vlc-assignements", asocia con cada identificador el nuevo atajo.
Los atajos deben estar en la forma entendida por VLC (por ejemplo, Ctrl para control, left para flecha izquierda).
7.4. Definición de los gestos de entrada
Los gestos de entrada de esste complemento también se definen en el archivo "settings.ini".
Estan en la seccion "script-gestures" y para cada script, es posible asignar uno o más gestos de entrada en la forma NVDA, (por ejemplo kb:(desktop):control+c, kb:nvda+shift+alt+f1).
Los identificadores de los scripts son:
- goToTime=script "Mostrar el cuadro de diálogo para establecer el tiempo y mover el cursor de reproducción en este tiempo",
- reportElapsedTime=script "Anunciar la duración ya reproducido del medio",
- reportRemainingTime=script "Anunciar la duración restante del medio para ser reproducido",
- reportTotalTime=script "Anunciar la duración total del medio",
- reportCurrentSpeed=script "Anunciar la velocidad actual",
- recordResumeFile=script "Guardar la posición de reproducción actual para este medio",
- resumePlayback= script "Reanudar la reproducción en la posición guardada para este medio".
- continuePlayback= script "Reanudar la reproducción interrumpida en la posición memorizada por VLC"
- hideShowMenusView = script que habilita el menú "Interfaz mínima" de VLC que oculta o muestra la barra de menú. El gesto de entrada debe coincidir exactamente al atajo de VLC.
- adjustmentsAndEffects = script que habilita el menú "Efectos y filtros" de VLC. El gesto de entrada debe coincidir al atajo de VLC.
8. Actualización
La actualización del complemento por defecto se hace automáticamente poco tiempo después de iniciar NVDA (entre 20 y 600 segundos) y como máximo una vez al día.
Puedes desactivar esta actualización desmarcando la opción "Buscar automáticamente actualizaciones" que se encuentra en las opciones del complemento, submenú "Actualización".
La versión del complemento puede ser:
- Ya sea una versión estable: su número de versión es de tipo "1.0" por ejemplo.
- Ya sea una versión de desarrollo: su número de versión es entonces de tipo "1.0-dev1", o "1.0-rc1", o "1.0-beta2".
Por defecto, una versión estable se actualiza con la última versión estable (Número de versión superior).
Sin embargo, es posible actualizar la versión actual estable con una versión de desarrollo de la próxima versión estable. Simplemente marcando la opción "Actualizar también versiones estable hacia versiones de desarrollo" situado en las opciones del complemento, submenú "Actualización".
Una versión de desarrollo se actualiza con una versión de desarrollo más reciente o con su versión estable.
El botón "Buscar actualización" situado en las opciones del complemento, submenú "Actualización", permite buscar inmediatamente una actualización.
9. Historial
9.1. Versión 2.2 (18/05/2020)
- corrección de la regresión en la reanudación de la reproducción de medios.
- pausar los medios durante un salto hacia adelante en los últimos 3 segundos para evitar detener los medios mediante VLC.
9.2. Versión 2.1.1 (03/04/2020)
Se corrigió el historial de cambios de extensión.
9.3. Versión 2.1 (03/04/2020)
- compatibilidad con NVDA 2020.1,
- cumplimiento de NVDA para la prueba de compatibilidad de extensiones con NVDA.
9.4. Version 2.0.2 (14/02/2020)
Enlace de descarga de extensión fija.
9.5. Version 2.0.1 (09/02/2020)
- corrección de la no presentación del mensaje pidiendo al usuario que detenga VLC.
- eliminación de instrucciones de rastreo.
9.6. Versión 2.0 (07/02/2020)
- Compatibilidad con NVDA 2019.3
- Se añade la actualización automática del complemento
- Implementado en la opción el anuncio automático de los cambios del nivel de volumen y el tiempo transcurrido.
- Anuncio de ocultar la barra de menús.
- Gestión del atajo habilitando el menú "Interfaz mínima".
- Gestión del atajo habilitando el menú "Efectos y filtros".
- Mejora del anuncio del nombre y del nivel de los potenciómetros.
- Acceso vía el panel virtual, a los diversos elementos de control de reproducción del medio (código fuente de base de Javi Domínguez).
- Tomada en cuenta la ausencia de tiempo total de ciertos medios durante el anuncio del tiempo transcurrido, total y restante.
- Eliminación de texto HTML incluido en la descripción de ciertos controles (código fuente de base de Javi Domínguez).
- Mejora de la accesibilidad en la lista de reproducción.
- Mejora de la accesibilidad de los campos de edición (código fuente de base de Javi Domínguez).
- En el diálogo "metadatos":
- Anuncio de los títulos de los cuadros de edición.
- Corrección del bloqueo en los desplazamientos vía la tecla de tabulación (código fuente de base de Javi Domínguez).
- Reordenamiento del menú de ajustes del complemento.
9.7. Versión 1.3.1 (11/06/2019)
- Corrección del archivo buildVars.py
- Se añade traducción al español
9.8. Versión 1.3 (01/06/2019)
Compatibilidad con NVDA 2019.2.0 (actualización del manifest.ini).
9.9. Versión 1.2 (06/03/2019)
- Reemplazo de los botones "Sí" y "No" con los botones "Aceptar" y "Cancelar" en los cuadros de confirmación para usar la tecla "Escape".
- Reemplazo del termino "module complémentaire " por "extension impuesto por los traductores de NVDA en francés).
- Compatibilidad con NVDA 2019.1.0.
- Preparación para la compatibilidad con python3.
9.10. Versión 1.1 (21/12/2018)
- Corrección de no reanudar la reproducción cuando la lista de medios recientes tiene solo un medio,
- Corrección de la documentación,
- Puesta en compatibilidad con versiones alpha 2019.1 de NVDA.
9.11. Versión 1.0 (29/10/2018)
Para evitar confusiones con otros complementos para VLC, el nombre del complemento cambia a "VLCAccessEnhancement" y en el Administrador de Complementos, se llama "Reproductor multimedia VLC: complementos de accesibilidad".
Novedades:
- Puesta en compatibilidad con NVDA 2018.3,
- Cambio en el nombre del complemento para evitar confusiones con otros complementos para VLC.
- Anuncia la indicación de la posibilidad de reanudar la reproducción interrumpida en la posición memorizada por VLC y reanuda la reproducción con el gesto de entrada "alt+control+r",
- Se añade el botón para eliminar el archivo de configuración de VLC,
Cambio interno::
- Reelaboración completa del código,
- Archivo style.css renombrado en style_md.css,
- Reconversión del archivo del manual del usuario para la conformidad en la forma con los complementos internacionales,
- Renombrado el menú de configuración del complemento.
9.12. Historial anterior
9.12.1. Versión 3.0 (19/06/2018)
Esta versión es compatible con VLC 3.0, incompatible con versiones anteriores.
Novedades:
- Verbalización del indicador de repetición del medio,
- Lectura correcta de la barra de estado,
- Anuncio del estado reproduciendo o en pausa con el sonido silenciado al enfocar la ventana principal.
Cambios:
- El archivo de configuración de VLC ya no se modifica automáticamente para definir atajos de teclado. Su implementación se realiza manualmente por el usuario con la ayuda de un simple botón,
- El cuadro de diálogo "Ir a tiempo" de VLC ya no se verbaliza.
- El nivel de volumen ahora se anuncia con cada cambio.
9.12.2. Versión 2.3.1
Correcciones de errores (regresión de "nvda+control+h")
9.12.3. Versión 2.3
- Se añade los scripts para Reanudar la reproducción
- Se añade la gestión de un archivo de configuración para el complemento
9.12.4. Versión 2.2
- Configuración del archivo vlcrc para cambiar las teclas de variaciones de velocidad,
- Anuncio de la duración reproducida durante los saltos de reproducción,
- Anuncio del silenciado/desilenciado del sonido,
- Anuncio del pasaje en pausa,
- Verbalización del cuadro de diálogo de VLC "Ir a tiempo",
- Modificación del cuadro de diálogo del complemento "Ir a tiempo".
9.12.5. Cambios para la versión 2.0
Primera versión multilingüe.