URL: https://github.com/paulber19/VLCAccessEnhancementNVDAAddon.git
Загрузка:
Совместимость:
Это расширение добавляет ряд команд для облегчения воспроизведения медиафайлов с помощью NVDA:
Эта версия совместима с версией 3.0 VLC.
Эти жесты команд можно изменить с помощью диалогового окна NVDA «Жесты ввода».
Некоторые сочетания клавиш, предоставляемые по умолчанию VLC, создают проблемы и должны быть изменены. Это:
Чтобы реализовать эти новые сочетания клавиш, необходимо изменить файл конфигурации «vlcrc» в VLC следующим образом:
Вот сочетания клавиш, которые озвучивает это расширение:
Чтобы не беспокоить пользователя, воспроизведённое время автоматически озвучивается, только когда медиафайл находится на паузе или воспроизводится с отключённым звуком.
Выполняется проверка, чтобы предотвратить выход за пределы медиафайла. Например, невозможно сделать прыжок на 5 минут, если осталось всего 2 минуты воспроизведения, или вернуться на 10 секунд, если воспроизведённое время составляет 3 секунды.
Медиафайл автоматически ставится на паузу, когда оставшееся время после прыжка составляет менее 10 секунд, чтобы избежать остановки медиафайла VLC и позволить вернуться назад, если потребуется.
Состояние «звук отключён» упоминается при запуске воспроизведения.
Уровень громкости объявляется при каждом изменении.
Переход в паузу объявляется.
Параметры «Автоматически объявлять уровень громкости» и «Автоматически объявлять прошедшее время» управляют поведением расширения. По умолчанию оба этих параметра включены.
Каждый параметр можно изменить с помощью диалога настройки расширения или скрипта, без назначенного по умолчанию жеста команды.
VLC предлагает возможность использовать сочетание клавиш «control + t» для перехода к определённому времени медиафайла. Но диалоговое окно, которое при этом создаётся, имеет проблемы с доступностью.
Это расширение предоставляет альтернативу (лучшую) для перехода к определённому времени с помощью сочетания клавиш «Control + запятая». Это сочетание клавиш вызывает диалоговое окно, которое позволяет установить время (часы, минуты, секунды), куда следует поместить курсор воспроизведения в медиафайле, в пределах общей длительности медиафайла за вычетом 5 секунд.
Для возобновления воспроизведения медиафайла возможны два решения:
VLC запоминает текущую позицию воспроизведения в момент его прерывания, то есть либо после команды VLC, либо при выходе из приложения.
Когда медиафайл запускается снова, VLC отображает возможность возобновления в строке состояния на очень короткое время (несколько секунд), и при нажатии сочетания клавиш «Alt + r» воспроизведение перезапускается с сохранённой позиции медиафайла.
Поскольку для незрячего человека это едва ли возможно, это расширение предоставляет скрипт, который позволяет возобновить воспроизведение с позиции, сохранённой VLC, без этого временного ограничения.
Когда медиафайл возобновляется и VLC сохранил для него позицию перезапуска воспроизведения, голосовое объявление «Возобновить воспроизведение Alt + Control + r» указывает на это. Используя жест команды «Alt + Control + r», воспроизведение медиафайла продолжается с сохранённой позиции.
Этот жест команды редактируется пользователем.
Это второе решение требует, чтобы вы сначала отметили начальную позицию воспроизведения с помощью жеста команды «NVDA + Control + f5». Желательно предварительно поставить медиафайл на паузу. Вам не нужно выходить из VLC, чтобы возобновить воспроизведение этого медиафайла.
Чтобы возобновить воспроизведение медиафайла, используйте команду клавиатуры «NVDA + Control + f6» для возобновления воспроизведения с позиции, сохранённой расширением для этого медиафайла.
Эта позиция сохраняется в файле конфигурации расширения, и для каждого медиафайла сохраняются имя медиафайла и связанная с ним позиция. В этом файле сохраняются только самые последние открытые медиафайлы.
Внимание: имя медиафайла должно быть уникальным в этом файле. Если два файла с одинаковым именем находятся в разных папках, будет сохранена только последняя запись для этого имени.
Некоторые медиафайлы, такие как радио, не позволяют использовать эту функцию. Это определяется отсутствием общего времени.
VLC представляет элементы управления воспроизведением медиа (в основном кнопки и флажки), которые недоступны с клавиатуры.
Хотя сочетания клавиш VLC позволяют выполнять некоторые функции этих элементов, расширение предоставляет доступ к этим элементам управления с помощью клавиши «Tab».
Эти элементы управления сгруппированы на виртуальной панели. Вход на эту панель сигнализируется объявлением «Панель управления». Выход с панели сигнализируется объявлением заголовка дорожки «фокус окна».
На этой панели клавиша «Tab» позволяет перейти к следующему элементу, «shift + Tab» - к предыдущему элементу.
Клавиша «Enter» позволяет активировать элемент.
Внимание: пробел приостанавливает или перезапускает воспроизведение медиафайла, но не активирует элемент.
Параметр «Доступ к элементам управления воспроизведением» позволяет изменить это поведение, установленное по умолчанию.
При запуске VLC создаёт в папке конфигурации пользователя Windows папку «vlc», которая содержит файлы конфигурации VLC.
Чтобы сбросить конфигурацию VLC без переустановки, достаточно удалить эту папку.
Чтобы облегчить эту задачу, расширение предлагает опцию «Удалить папку конфигурации VLC» в диалоговом окне «Настройка VLC».
Чтобы вызвать это диалоговое окно:
Впоследствии, если необходимо использовать кнопку «Изменить сочетания клавиш вашего медиаплеера VLC», вам нужно будет запустить VLC хотя бы один раз, чтобы заново создать эту папку и файлы конфигурации VLC.
Поскольку разработчики медиаплеера не предусмотрели в программном обеспечении предоставление релевантной информации для идентификации составляющих его объектов, это расширение полагается на их имя или описание. Для этого необходимо определить для каждой языковой версии VLC объекты, используемые расширением. Эти определения находятся в файлах «strings-xx.ini» (xx = идентификатор языка) в папке «VLCLocale» расширения. Эти файлы сохраняются в кодировке «UTF-8» без BOM. Чтобы узнать язык, настроенный в VLC, это расширение использует имя второго меню в строке меню, и для этого определён ключ «StringToFindLanguage» в разделе «hand». Раздел «VLC» файла содержит ключи для идентификации объектов. Это:
Как было сказано ранее, некоторые сочетания клавиш VLC не могут использоваться в зависимости от типа клавиатуры. Это расширение позволяет их определять и изменять.
Определения этих изменяемых сочетаний клавиш находятся в файле «settings.ini» в папке «local» для каждого языка NVDA, поддерживаемого расширением. В этом файле раздел «vlc-keynames» определяет с помощью номеров идентификаторы сочетаний клавиш VLC для редактирования, а раздел «vlc-assignments» связывает каждый идентификатор с новыми сочетаниями клавиш. Сочетания клавиш должны быть в форме, понятной VLC (например, Ctrl для control, left для левой стрелки).
Жесты команд в этом расширении также определяются в файле «settings.ini». Их можно найти в разделе «script-gestures», и для каждого скрипта можно назначить одно или несколько действий команд в форме NVDA (например, kb:(desktop):Control+c, kb:nvda+shift+alt+f1). Идентификаторы скриптов:
Обновление расширения по умолчанию происходит автоматически вскоре после запуска NVDA (от 20 до 600 секунд) и не чаще одного раза в день. Вы можете отключить это обновление, сняв флажок «Автоматически проверять наличие обновлений» в настройках расширения, подменю «Обновление». Версия расширения может быть:
По умолчанию стабильная версия обновляется до более новой стабильной версии (с бо́льшим номером версии). Но можно обновить текущую стабильную версию до версии для разработчиков следующей стабильной версии. Для этого достаточно установить флажок «Также обновлять стабильные версии до версий для разработчиков» в настройках расширения, подменю «Обновление».
Версия для разработчиков обновляется:
Кнопка «Проверить наличие обновлений», расположенная в настройках расширения, подменю «Обновление», позволяет немедленно выполнить поиск обновления.
Кнопка «Просмотреть историю», расположенная в той же категории, позволяет отобразить историю текущей версии в браузере.
В случае автоматического обновления, если обнаружена новая версия, отображается диалоговое окно «Обновление», которое предлагает:
В случае обновления до стабильной версии кнопка «Что нового» предоставляет возможность открыть в браузере историю дополнения и, таким образом, узнать о новых возможностях предлагаемой версии.
История этого дополнения находится в файле: «changes.html».