Audiocinemateca руководство для NVDA

Дополнение Audiocinemateca предлагает нам возможность иметь страницу Audiocinemateca в нашем NVDA.

Audiocinemateca - это сайт, созданный в 2015 году, который поддерживает и обновляет коллекцию фильмов, сериалов, документальных и короткометражных фильмов в аудиоформате со звуковым описанием для слепых людей, совершенно бесплатно и на испанском языке.

Если вы хотите познакомиться с ним поближе, прежде чем перейти к этому дополнению, посетите аудиокинотеку, перейдя по этой ссылке.

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

Что предлагает дополнение

Дополнение позволит вам просмотреть, воспроизвести и скачать любой фильм, сериал, документальный фильм или короткометражку в Аудиокинотеатре.

• Вы сможете просмотреть файл с теми же данными, что и на веб-странице.
• Мы сможем воспроизвести в простом плеере фильмы, сериалы (с выбором сезона и эпизода), документальные или короткометражные фильмы.
• Мы также сможем скачать любой фильм, сериал (выбрав сезон и эпизод), документальный или короткометражный фильм.

В случае с фильмами, некоторые из них могут содержать несколько частей, поэтому мы сможем выбрать, какую часть фильма мы хотим воспроизвести или скачать.

В случае с сериалами нам нужно будет выбрать сезон (если их несколько) и эпизод как при воспроизведении, так и при скачивании.

Управление дополнением осуществляется через интерфейс, который позволяет делать запросы, а также воспроизводить и скачивать.

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

Плагин можно запустить из меню Сервис / Audiocinemateca или назначив соответствующие клавиши в Жесты ввода / Audiocinemateca.

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

Плагин требует наличия действующего имени пользователя и пароля Audiocinematic.

Дополнение поставляется без базы данных, поэтому при первом запуске дополнения будет предложено загрузить базу данных.

При первом запуске дополнения нам будет предложено ввести имя пользователя и пароль Audiocinemateca. На экране входа в систему вы также можете перейти на сайт, чтобы зарегистрироваться или запросить новый пароль, если вы его не помните, просто нажав на кнопку «Посетить сайт». Если вы создали свою учетную запись, войдя в нее через Facebook, или у вас включена двухэтапная верификация, вы не сможете воспользоваться этим дополнением.

После верификации вам будет предложено загрузить базу данных. Если у нас нет базы данных, плагин не запустится, поэтому мы должны ответить «да».

Несколько замечаний о логине и базе данных.

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

В этой папке находится файл под названием .audiocinemateca. Этот файл содержит наше имя пользователя и пароль, а также конфигурацию плагина.

Затем находятся два файла .json - каталог и версия каталога.

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

Автор дополнения не несет ответственности, если вы поделитесь пользователем или паролем, вы предупреждены о местонахождении таких данных и сами решаете, не делиться ли ими.

Размер обновлений этого дополнения к базе данных составляет примерно 1,5 / 2 мегабайта.

Инструменты / Меню Audiocinemateca

В этом меню у нас есть следующие возможности:

• Запустить Audiocinemateca: откроется интерфейс плагина. У нас может быть открыт только один диалог, либо интерфейс Audiocinemateca, либо Опции.
• Опции: появится диалог с опциями, позволяющими настроить плагин по своему вкусу. Диалог опций может быть показан только в том случае, если интерфейс Аудиокинематографа закрыт и ничего не воспроизводится.
• Возврат к настройкам по умолчанию: вернет все настройки дополнения к значениям по умолчанию, как если бы оно было только что установлено.
• Документация по дополнению: это полезно для тех, кто не знает, как найти документацию. Он покажет этот документ.

Клавиши, которые мы можем назначить в разделе «Жесты ввода».

В этом разделе мы можем назначить следующие клавиши:

• Показать окно Audiocinemateca: загрузит интерфейс плагина.
• Показать окно Параметры: откроется диалог с опциями для настройки плагина.
• Уменьшение и увеличение громкости: позволит нам управлять громкостью, предоставляя информацию в любое время из любого места.
• Уменьшение и увеличение скорости: позволит управлять скоростью воспроизведения, предоставляя информацию в любое время из любого места.
• Перемотать вперёд и перемотать назад: позволит нам задержать или продвинуть воспроизведение в секундах или минутах в соответствии с настройками в опциях.
• Воспроизведение / Пауза воспроизведения: позволит нам приостановить или воспроизвести воспроизведение из любого места.
• Остановить воспроизведение: остановит воспроизведение, которое в данный момент проигрывается или поставлено на паузу.
• Информация о воспроизведении: покажет время, прошедшее с момента воспроизведения, а также общее время воспроизведения.

Все действия, связанные с плеером, могут быть выполнены только в том случае, если окно Audiocinemateca закрыто.

При нажатии любой из вышеперечисленных опций все время будут появляться голосовые сообщения о том, что происходит.

У вас может быть открыт только один диалог - либо интерфейс Аудиокинематографа, либо Опции.

Диалог опций может быть отображен только в том случае, если интерфейс Аудиокинематографа закрыт и ничего не воспроизводится.

Основной интерфейс

Главный экран дополнения состоит из 3 разделов: запросы, плеер и другие.

• Запросы: в этой части находится вся информация о фильмах, сериалах, документальных и короткометражных фильмах, упорядоченная по вкладкам. Она состоит из 5 вкладок:
• Общая вкладка (Alt+1): эта вкладка будет открываться каждый раз, когда мы открываем дополнение, оставляя нас в списке последних добавленных фильмов. На этой вкладке нажатие Alt+C приведет нас к комбинированному окну, где мы можем выбрать различные категории. Если мы нажмем Alt+L, то снова перейдем к списку и покажем последние добавленные фильмы в выбранной категории. На эту вкладку можно быстро перейти, нажав Alt+1 из любой точки интерфейса. Если мы нажмем Enter на элементе в списке, откроется диалог с информацией о фильме, сериале, документальном или короткометражном фильме. Все эти диалоги одинаковы, с некоторыми отличиями для каждой категории. Диалоги для документальных и короткометражных фильмов абсолютно одинаковы. Диалог фильма содержит комбинированное поле, позволяющее выбрать часть фильма, которую мы хотим посмотреть, в случае если фильм очень длинный и разделен на несколько частей. Диалог сериала отличается тем, что в нем есть комбинированное поле, в котором можно выбрать сезон, если их несколько, и список эпизодов. Во всех диалогах есть окно редактирования, доступное только для чтения, где мы можем увидеть файл того, что мы выбрали с помощью клавиш. Кроме того, во всех диалогах есть кнопки воспроизведения, загрузки, дополнительной информации на сайте и закрытия. Воспроизведение и загрузка всегда будут происходить на выбранном элементе, например, в случае с сериалами это будет воспроизведение или загрузка эпизода x сезона x, который мы выбрали. Кнопка «Дополнительная информация в Интернете» предоставит нам дополнительную информацию, если таковая имеется в Интернете, в основном на Filmaffinity, хотя она может перенаправить нас на другие сайты, содержащие информацию о выбранном фильме. Эти диалоги одинаковы на всех вкладках, и их можно вызвать только из списка, нажав Enter на каком-либо пункте. Если мы нажмем на кнопку Play, активируется плеер, описанный ниже. Если мы нажмем на кнопку «Загрузить», откроется диалоговое окно, в котором нужно выбрать папку, в которую будет сохранен загруженный файл. За один раз можно загрузить только один файл, и нам всегда придется указывать, куда его сохранить. Это сделано для того, чтобы загрузкой не злоупотребляли. Также на вкладке «Общие» есть кнопка «Не знаете, что посмотреть? Нажмите здесь, и я предложу вам кое-что, давайте посмотрим, прав ли я», которую мы можем вызвать с помощью Alt+P. Эта кнопка откроет диалог с чем-то случайным, если мы не знаем, что посмотреть.
• Вкладки «Фильмы», «Сериалы», «Документальные фильмы» и «Короткометражные фильмы» (Alt+2 - Alt+5): на этих вкладках у нас будет окно редактирования для поиска. Мы можем быстро получить доступ к этому окну с помощью Alt+B. Если в этом окне мы напечатаем что-то и нажмем клавишу Enter, список покажет нам все, что соответствует. Для поиска неважно, в каком регистре написано слово - в нижнем, верхнем или смешанном. При внутреннем поиске все преобразуется в нижний регистр, чтобы облегчить поиск. Если в списке ничего не найдено, он сообщит нам об отсутствии результатов. Если найдет, то покажет все результаты. Если мы нажмем Enter в списке, откроется соответствующий диалог с вкладкой и действиями, описанными выше. Чтобы вернуть весь список, нужно удалить все поле поиска и нажать Enter. Это вернет список ко всем элементам категории, в которой мы находимся. Все списки также имеют 2 клавиши для ориентации в них: Ctrl+I, которая сообщит нам позицию списка, в котором мы находимся, даст нам элемент, в котором мы находимся, и общее количество элементов. И еще одна комбинация - Ctrl+F. Она покажет нам диалог, в котором мы можем задать позицию, на которой будет находиться фокус. Это удобно, например, в фильмах, которых очень много, и если мы не хотим переходить по стрелкам, подниматься или опускаться по странице, это сэкономит нам время. На данный момент поиск осуществляется только по названию, но скоро будут добавлены дополнительные фильтры поиска. Для этого раздела есть еще одна комбинация - Ctrl+Space. Когда мы нажимаем эту комбинацию, она сообщает нам, в какой вкладке мы находимся.

Если мы нажмем Alt+1 - Alt+5, всегда с этими комбинациями, то фокус будет на списке названий выбранной нами вкладки.

Плеер

Когда мы нажмем на кнопку воспроизведения на главном экране в одном из диалогов с вкладками, активируются кнопки плеера: перемотка, воспроизведение или пауза (эта кнопка будет меняться в зависимости от состояния воспроизведения), быстрая перемотка и остановка.

На кнопках перемотки и ускоренной перемотки, если мы нажмем клавишу приложения или Shift+f10, появится меню с временем, которое мы можем назначить этой кнопке. Это время будет сохранено в конфигурации, и будет отмечено то, которое мы выбрали в данный момент. Это также можно изменить в диалоговом окне «Параметры».

Кнопка воспроизведения/паузы будет менять свое название в зависимости от состояния воспроизведения.

Кнопка «Стоп» полностью остановит воспроизведение.

В этой области находятся следующие клавиши:

• F1 и F3: перемотка и перемотка вперед в зависимости от выбранного времени.
• F2: Пауза или воспроизведение в зависимости от статуса.
• F4: Полная остановка воспроизведения.
• F5 и F6: уменьшение и увеличение громкости воспроизведения.
• F7 и F8: Уменьшение и увеличение скорости воспроизведения.
• F9: получение информации об истекшем времени воспроизведения и общем времени воспроизведения.

Функциональные клавиши работают в любом диалоге основного интерфейса, поэтому мы можем продолжить просмотр вкладки фильма и поставить воспроизведение на паузу из диалога вкладки.

Кнопки проигрывателя не имеют сочетаний клавиш , так что нам придется перемещаться по ним с помощью клавиш tab и Shift+TAB.

Пока что-то играет, у нас есть возможность использовать функциональные клавиши.

Функциональные клавиши будут говорить информацию о происходящем каждый раз, когда мы нажимаем их, если мы отметили для этого опции. Единственная клавиша, которая всегда будет что-то говорить и не зависит от того, отмечена ли в Опциях опция Активировать или деактивировать информационные сообщения, - это F9. Эта клавиша всегда будет говорить с нами.

Предупреждение о функциональных клавишах: если нажать их несколько раз и активировать чтение информации, может возникнуть небольшая задержка. Это связано с тем, что для передачи информации необходимо отключить NVDA и отправить информацию через отдельный поток. Если мы видим, что сообщения накладываются друг на друга, мы можем отключить его, нажав Ctrl.

Рекомендуется не оставлять эти функциональные клавиши нажатыми и прослушивать сообщение после каждого нажатия. При деактивации эта задержка больше не появляется, поэтому, если мы хотим быстро уменьшить громкость, мы можем оставить клавишу нажатой.

Другое

В этом разделе находится громкость, которая представляет собой ползунок, скорость, которая является комбобоксом, и, если воспроизведение активно, комбобокс вывода.

Громкость и скорость имеют одно и то же сочетание клавиш, Alt+V, при нажатии которого происходит перемещение между этими двумя элементами управления. Эти два элемента управления можно вызвать из любого места основного интерфейса.

Комбобокс для вывода имеет сочетание клавиш Alt+S и может быть вызван только при активном воспроизведении. В противном случае это поле скрыто. Пока воспроизведение активно, его можно вызвать из любого места основного интерфейса.

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

Аудиовыход воспроизведения не зависит от выхода NVDA, поэтому мы можем слушать NVDA через наушники, а фильм, сериал, документальный фильм или короткометражку - через колонки.

Далее у нас есть кнопка меню с сочетанием клавиш Alt+M. При нажатии на нее появляется меню со следующими пунктами:

• Обновить базу данных: появится диалог для обновления базы данных. В этом диалоге мы будем постоянно получать информацию о том, что происходит и есть ли обновления. Если обновления есть, он сообщит нам об этом, и мы должны будем нажать на кнопку обновления. Нет определенного дня или времени, когда база данных должна быть обновлена. Мы должны сами время от времени проверять ее. В Интернете всегда будут более актуальными те названия, которых еще нет в базе данных, поскольку она обновляется по мере поступления новых материалов. База данных, которую использует плагин, должна создаваться вручную, поэтому разница между веб-базой и плагином может составлять часы или дни. Я надеюсь, что это будет автоматизировано, и мы будем получать новости все раньше и раньше. Однако разница невелика. При каждом обновлении плагин закрывается, и нам приходится вызывать его снова. Если что-то играет, оно будет продолжаться, не затронутое обновлением базы данных.
• Пожертвовать Audiocinemateca: это приведет нас на сайт Audiocinemateca и оставит нас в разделе для пожертвований. Должен сказать, что у этого проекта есть расходы, которые покрываются за счет пожертвований. На сайте все хорошо объяснено. Пожалуйста, как бы мало это ни было, все помогает проекту развиваться.
• Закрыть: Выход из дополнения. Если что-то воспроизводится, оно будет продолжаться, и мы сможем управлять воспроизведением с помощью ярлыков, которые мы настроили в жестах ввода.

Диалог параметров

В этом диалоге есть две вкладки:

Общие

На этой вкладке у нас есть следующие опции:

• Включить или отключить информационные сообщения: если мы отметим эту опцию, у нас будут информационные сообщения в различных действиях дополнения.
• Количество результатов для последних записей: здесь мы можем выбрать, сколько результатов мы хотим видеть на общей вкладке дополнения.
• Кнопка «Вернуться к значениям по умолчанию»: мы вернем настройки дополнения к значениям по умолчанию. Если у вас есть имя пользователя и пароль, они будут удалены, и вам придется заново войти в дополнение. Во всех случаях возврата к значениям по умолчанию база данных никогда не удаляется, если она уже была загружена.

Плеер:

На этой вкладке у нас есть следующие опции:

• Выберите время перемотки воспроизведения: в этом поле мы можем выбрать время перемотки воспроизведения.

У нас есть две кнопки: ОК, которая сохранит изменения, или Отмена, которая ничего не сохранит и оставит настройки плагина в прежнем виде.

Мы также можем закрыть этот диалог с помощью Alt+F4, но это не сохранит изменения, если они были сделаны.

В этом диалоге будут добавляться вкладки и опции по мере добавления новых функций в плагин.

Благодарности:

Я хотел бы поблагодарить Жозе Мануэля Деликадо за его терпение во время разработки дополнения и за то, что он терпел все мои вопросы.

Я также хотел бы поблагодарить его и всех его коллег из Audiocinemateca за их хорошую работу по реализации этого проекта.

Не хочу забыть упомянуть, что, если вы можете пожертвовать что-то, неважно, насколько мало, сделайте это. Я думаю, что этот проект дает нам возможность получить удовольствие, развлечься, и для этого за ним стоят люди, которые тратят много времени своей личной жизни вместе с деньгами, которые стоят инфраструктуры этого проекта.

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

Информация об обновлениях:

Это дополнение будет обновляться по следующему пути:

В этой истории указаны только мажорные.минорные.версии (например, v3.1).

Версии major.minor.x (например, v3.1.2) являются обновлениями, исправляющими ошибки.

Изменения в дополнении будут отражены в этом разделе с пояснениями.

Основной документ останется неизменным, являясь руководством для пользователя.

Пользователь обязан просматривать этот раздел, чтобы быть в курсе изменений.

Версия 1.3.

• Добавлено сохранение позиции воспроизведения.

Теперь при остановке воспроизведения сохраняется отметка с указанием времени.

Если мы снова воспроизведем фильм, сериал (в данном случае главу), документальный или короткометражный фильм и обнаружим, что отметка сохранена, он спросит нас, хотим ли мы начать воспроизведение с того места, где оно было сохранено, или с самого начала.

• Устранение неполадок.

Версия 1.2.

• Добавлена новая загрузка интерфейса при обновлении базы данных.

Теперь при обновлении базы данных интерфейс будет автоматически перезагружаться.

• Добавлен новый немедленный поиск от @javidominguez.

Теперь, когда мы начинаем вводить текст в поиск, будут отображаться подходящие результаты.

• Совместимость с NVDA 2024.1

Версия 1.1.

• Добавлены фильтры поиска.

Добавлены следующие фильтры поиска:

Название, год, жанр, страна, режиссер, сценарий, музыка, фотографии, актерский состав, продюсер, повествование и синопсис.

По умолчанию при запуске дополнения после запуска NVDA фильтр во всех категориях выбирается по названию.

Выбранные фильтры сохраняются в текущей сессии NVDA, то есть пока мы не закроем NVDA, выбранные фильтры будут сохранены независимо от того, закроем ли мы интерфейс Audiocinemateca.

Каждая категория имеет независимые фильтры, что означает, что мы можем искать в фильмах, например, по году, а в сериалах - по рассказу.

Чтобы перейти к выбору фильтров, нужно навести фокус на поле поиска любой из категорий и нажать Ctrl+F. Появится меню со всеми фильтрами, текущий фильтр будет отмечен. Нажатие клавиши Enter на фильтре выделит и отметит этот фильтр.

Также в поле поиска надпись изменится на выбранный фильтр.

• Добавлена комбинация клавиш для быстрого отчищения полей поиска.

Теперь, если в поле поиска любой из категорий нажать Ctrl+B, текстовое поле будет отчищено.

Если в поле уже был произведен поиск, то поведение будет таким, как если бы мы нажали Enter, он удалит текст и покажет нам все названия этой категории.

Если поиск не производился, то будет удален текст в поле поиска и больше ничего не будет сделано.

• Добавлена клавиша F12 для активации или деактивации сообщений на главном и дополнительном экранах.

Теперь мы сможем отключить информационные сообщения, не заходя в диалог опций. Нажатие F12 сообщит нам, деактивированы или активированы сообщения.

• Исправлено нажатие клавиши Enter в текстовом поле в диалоге перехода к позиции.

Было исправлено, что при нажатии клавиши Enter в текстовом поле диалога перехода к позиции иногда, если в нем было ошибочное значение, оно не действовало так, как при касании.

• Исправлен размер главного окна до 800x600.

Исправлено разрешение плагина на 800x600 для поддержки старых мониторов.

Это должно быть оценено в соответствии с отзывами пользователей с нарушениями зрения.

Мы постараемся сделать оптимальное разрешение для всех.

• Исправление внутренних ошибок и орфографических ошибок.

Если вы обнаружили какие-либо орфографические ошибки, пожалуйста, укажите их, и они будут исправлены.

Версия 1.0.

• Начальная версия.

• Audiocinemateca-V.1.3.nvda-addon
• Audiocinemateca-V.1.2.nvda-addon
• Audiocinemateca-V.1.1.nvda-addon