unspoken-ng

Unspoken для современной NVDA, с использованием pyopenal

Версия v1 unspoken-ng использовала steam audio. Однако для этого требовалась компиляция исходного кода на C++ для сборки дополнения, и само дополнение было довольно большим. Версия v2 теперь использует PyOpenAl, что уменьшает размер дополнения и устраняет необходимость в libverb.

Почему?

К сожалению, предыдущие версии Unspoken имели множество серьёзных проблем из-за зависимости от неподдерживаемой аудиобиблиотеки:

• устройство вывода звуков нельзя было изменить
• после нескольких часов работы аудиоустройство начинало издавать писк
• При переходе NVDA на 64-битную версию или на Python новее 3.11, библиотеку больше нельзя будет использовать

Решение

Эта версия Unspoken теперь использует библиотеку 3D-аудио под названием pyopenal. Pyopenal — это хорошо документированная библиотека, используемая во многих приложениях. Это означает, что библиотека проверена в боевых условиях, отлажена и поддерживается.

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

В случае с этим проектом я, по сути, просто релиз-менеджер, документатор и контактное лицо. Unspoken-ng был бы невозможен без:

• Bryan Smart: оригинальная работа над двумя версиями дополнения Unspoken
• Masonasons: обновление дополнения Unspoken с учётом изменений API в 2023 и 2024 годах
• Ambro86: поддержка современных привязок Python для synthizer, а также внесение некоторого кода в unspoken
• Tyler Spivey: за то, что разобрался со steam audio и создал привязки Python, которые делают то, что нам нужно
• AKJ: за преобразование всего на pyopenal
• Я: за острую необходимость в этой функциональности, за то, что делал всё возможное для её поддержки, и за то, что беспокоил других людей, чтобы они помогли со всеми сложными частями

Использование дополнения

После установки дополнение создаст новую категорию в настройках под названием «unspoken». Здесь вы можете включать и отключать звуки, изменять, будет ли NVDA объявлять типы элементов управления в дополнение к воспроизведению звуков, а также настраивать параметры реверберации.

Сборка

Если всё, что вы хотите сделать, это собрать дополнение для NVDA, вы можете сделать это с помощью scons. Если же вы хотите внести изменения в привязки SteamAudio, вам понадобится Steam Audio SDK и компилятор Microsoft Visual C++. Когда всё это у вас будет, вы можете собрать привязки и дополнение, запустив build.bat.

Известные проблемы

Если вы хотите исправить любую из этих проблем, пул-реквесты будут приняты с радостью и благодарностью:

1. В настоящее время unspoken-ng использует libverb для реверберации вместо SteamAudio. Хотя SteamAudio напрямую поддерживает реверберацию, это плохо документировано, и нам не удалось заставить это работать.
2. Отсутствует поддержка перевода: мне неясно, что здесь нужно сделать. Нужно ли мне создать какую-то учётную запись в облаке для какого-то сервиса перевода или что-то в этом роде?
3. Unspoken-ng не воспроизводит звуки при перемещении по некоторым элементам управления в Интернете. Это связано с тем, что мы не можем получить позицию элемента управления, пока фокус не переместится на него, а NVDA больше не перемещает системный фокус с помощью курсора просмотра. Мы должны быть в состоянии исправить это, скопировав части того, как работают звуковые сигналы (earcons). Я просто ещё не дошел до этого.

Обязательства по сопровождению

Я, Сэмюэл Пру (Samuel Proulx) aka fastfinge, публично обязуюсь сопровождать существующую функциональность всех функций дополнения, присутствующих в репозитории fastfinge/unspoken-ng, в будущем, чтобы поддерживать совместимость с изменениями API NVDA. Если я не смогу этого сделать, я найму кого-то другого для выполнения этой работы от моего имени. Я сам завишу от этой функциональности в некоторых критически важных рабочих процессах. Однако дополнение в текущем виде удовлетворяет мои потребности. Если вы захотите решить любую из вышеуказанных известных проблем, я тепло приветствую вас и приглашаю отправить пул-реквест. Когда я приму его, я буду поддерживать добавленную функциональность. Но эти проблемы не влияют на мой рабочий процесс, поэтому я не буду работать над ними самостоятельно.