Руководство по zRadio для NVDA

Важные замечания автора

Это дополнение возникло из-за скуки и желания экспериментировать с NVDA.

zRadio-очень тяжелый плагин, около 120 Мб после установки.

Это имеет место, если вы все еще используете версии плагина zRadio 0.1, 0.2 и 0.3, хотя мы приглашаем пользователей zRadio загрузить новую версию 0.5.4, поскольку она меньше размером и повышает производительность плагина zRadio. Пожалуйста, обратитесь к разделу
“Журнал изменений” для версии 0.5.4 ниже, для более подробной информации.

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

На некоторых компьютерах с ограниченными ресурсами это может замедлить NVDA, поэтому рекомендуется удалить плагин.

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

Автор не несет ответственности ни за использование плагина, ни за любые проблемы, которые могут возникнуть.

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

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

Несколько
заметки на случай удаления плагина.

Плагин сохраняет только 3 файла в каталоге zRadio, который мы находим в каталоге конфигурации NVDA, и они следующие:

Это имеет место, если вы все еще используете версии 0.1, 0.2 и 0.3 плагина zRadio, хотя мы приглашаем пользователей zRadio загрузить новую версию 0.5.4. при установке этой новой версии будут установлены два новых файла с именем:

Теперь плагин сохранит только 5 файлов в каталоге zRadio, который мы находим в каталоге конфигурации NVDA, если используется эта новая версия 0.5.4 плагина zRadio.

Пожалуйста, ознакомьтесь с разделом “журнал изменений” для версии 0.5.4 ниже, для получения более подробной информации.

В версии 0.5 файлы cache.dat и radio_cache.dat заменяются Cache.sqlite.

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

Мой способ программирования это в моей голове, и я не знаю, как объяснить, что весь код у меня в голове, и он внезапно возникает, и я пытался следовать рекомендациям, которые я всегда нарушаю, чтобы не быть продуктивным в моем способе написания.

Но, как я говорю и в свою защиту, это плод скуки и желания экспериментировать с NVDA.

Интерфейс zRadio

Чтобы открыть дополнение, необходимо пройти по пути:
меню NVDA / инструменты и там будет пункт zRadio.

Мы также можем назначить команду клавиш в жестах ввода, которая по умолчанию не задана, чтобы открыть главное окно zRadio.
Перейдя в меню NVDA / настройки / жесты ввода и в раздел zRadio: ярлык “показать главное окно zRadio”.

После открытия вас встретит интерфейс состоящий из древовидного списка с тремя категориями, начиная сверху вниз, мы находим первый экран “Общие”, второй “Избранное” и третий “Поиск”.
Когда мы находимся в древовидном списке, мы можем перемещаться по нему с помощью стрелок вверх и вниз.
Позвольте мне быстро рассказать о этих трёх категориях:

Когда фокус находится на выбранной категории, чтобы активировать ее, мы нажимаем клавишу TAB, и попадаем в поле поиска, либо для поиска станции, либо для выбора категории в комбинированном окне, если мы находимся в категории “Поиск”.

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

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

Если мы вернемся на вкладку и у нас ничего не воспроизводится, мы попадем на полосу громкости, которая по умолчанию в первый раз находится на уровне 50%, если мы что-то воспроизводим, мы попадем на кнопки, управляющие воспроизведением.

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

Если мы снова откроем вкладку, то попадем в панель кнопок, в которой сейчас только одна кнопка выход, но скоро там будет больше опций.

Общий экран

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

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

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

Примечание: Вы также можете нажать клавишу Enter после ввода поиска в этом поле. Поэтому это действие будет таким же, как если бы мы нажали кнопку Search.

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

Экран избранного

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

Рабочая область точно такая же, как и на экране Общие, поэтому я не буду описывать ее снова.

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

Подробную информацию об использовании новых функций смотрите в разделе “Журнал изменений” для версии 0.3.

Экран поиска

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

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

Мы также можем осуществлять поиск по стране, языку или меткам. В случае поиска по меткам:

Если мы выполним поиск по слову Rock, он выдаст нам все теги с этой классификацией.

В любой из предыдущих категорий мы сможем осуществлять поиск, но только в категории “Общие” мы сможем играть прямо из этой категории, а также добавлять в избранное и копировать URL радиостанции.

В остальных категориях мы сможем только добавлять то, что выберем, на экран “Общие” и исследовать это на экране “Общие”.

Связанные с клавишами, жесты и контекстными меню.

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

контекстное меню можно запустить либо с помощью клавиши “Application”, либо с помощью команды Shift+F10 на тех компьютерах, где нет клавиши “Application”.

На экране “Общие” мы сможем взаимодействовать со следующими пунктами, либо в списке станций, либо в поиске:

На экране “Избранное” мы сможем взаимодействовать со следующими элементами:

Список станций:

Перечисление поиска:

На экране “Поиск” мы сможем взаимодействовать со следующими элементами:

После выполнения поиска с помощью категории Общий радиопоиск:

В списке результатов общего поиска:

Уже объяснено выше.

В категориях Поиск по стране, Поиск по языку и Поиск по тегам мы можем использовать только следующее в списке станций, а также в списке поиска:

Если мы посмотрим на эти 3 категории, у них есть номер, который соответствует тому, сколько станций имеют этот выбор.

Иногда, например, если мы выбираем станцию с 9 станциями, а при переходе к экрану “Общие” загружаются только 8, это происходит потому, что недостающая станция плохо связана.

Также в тех экранах, в которых мы можем сфокусировать курсор на станции, если мы нажмем клавишу “Пробел”, то сможем запустить ее воспроизведение.

Быстрые клавиши:

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

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

Вы также можете выйти из окна zRadio, нажав кнопку выхода, Alt+F4 или Escape.

Жесты ввода

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

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

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

Следует также отметить, что эти клавиши можно использовать при открытом или закрытом окне zRadio.

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

Внимание. Назначение станцый в слоты избранного происходит автоматически, в момент добавления станций в избранное.
Первые пять станций занимают позиции от 1 по 5 в порядке их добавления.

Переводчики и соавторы:

журнал изменений

Версия 2026.1.1.

Версия 2026.1.0.

Версия 2024.1.0.

Версия 0.6.

*Добавлена поддержка API NVDA 2023.1.

Версия 0.5.7.

Версия 0.5.6.

Версия 0.5.5.

Версия 0.5.4.

Версия 0.5.3.

Версия 0.5.2.

Исправлены задержки при запуске NVDA из-за zRadio. Теперь запуск NVDA будет происходить немедленно.

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

На данный момент дополнение останется совместимым с версией 2019.3 и далее.

Версия 0.5.1.

Эта новая возможность появится на трех экранах, где мы можем располагать станции: в разделе “Общие”, “Избранное” и в разделе “Поиск” в категории “Общий поиск радиостанций”.

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

Версия 0.5.

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

Благодаря использованию предопределенного кэша загрузка плагина происходит намного быстрее. Иногда он может замедляться из-за соединения с сервером, но теперь в 95% случаев плагин загружается, как будто это просто другой плагин, не замедляя работу NVDA.

Версия 0.4a.

Версия 0.4.

Код был оптимизирован таким образом, что теперь установка стала на 60% меньше. Это лучше сказывается на производительности.

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

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

Файл cache.dat обновляется каждый раз, когда мы перезапускаем NVDA, поскольку именно он содержит счетчик количества запусков, и когда он достигнет 5 - 6-го раза, файл radio_cache.dat также будет обновлен.

Файлы cache.dat и radio_cache.dat хранятся в директории zRadio, находящейся в директории конфигурации NVDA.

По умолчанию zRadio настроен на использование языка “Español, es”, но если вы выбрали “По умолчанию для пользователя” и ваш язык еще не переведен, интерфейс дополнения всегда будет на испанском.

Версия 0.3.

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

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

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

Когда мы находимся в категории “Избранное”, появится новая кнопка “Действие” с горячей клавишей Alt + a.

Эта кнопка появится только тогда, когда вы находитесь в категории “Избранное”.

Кнопка может быть вызвана из любой части интерфейса и состоит из меню, в котором будут отображены следующие опции:

Диалоговое окно для Новой станции и Редактирования станции одинаково для обоих вариантов.

Он состоит из двух полей для редактирования: для названия станции и для URL станции.

Эти поля являются обязательными и не могут быть пустыми.

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

У нас также есть две кнопки, Принять и Отмена.

Если мы соглашаемся, изменения будут сохранены в зависимости от того, что мы делаем - Новая станция или Редактировать станцию.

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

Мы также можем закрыть диалог, нажав Alt + F4 или Escape - эти два действия приведут к потере сделанного.

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

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

Для этой новой опции мы добавили 5 новых жестов ввода, которые нужно настроить, перейдя в меню NVDA / Preferences / Input Gestures… / zRadio.

Новые жесты называются Play station быстро и сопровождаются нумерацией от 1 до 5.

Каждый жест, который мы настроим, будет соответствовать станции, которая находится у нас в избранном.

Если мы настроим Play station быстро 1 и в Избранном у нас будет Test Radio, то когда мы щелкнем в любом месте либо при открытом, либо при закрытом окне zRadio, комбинация клавиш, которую мы назначили этой команде, начнет проигрывать эту станцию.

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

Версия 0.2.

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

Версия 0.1.