Исправлены некоторые проблемы.

EnhancedDuck (Расширенное приглушение звука)

Enhanced Duck — это дополнение для NVDA, которое расширяет приглушение звука NVDA двумя режимами с учётом фокуса. В дополнение к встроенным режимам NVDA оно может автоматически понижать громкость других запущенных приложений в зависимости от того, какое окно находится в фокусе.

Режимы

Нажмите NVDA+shift+d, чтобы переключаться между доступными режимами приглушения:

• Без приглушения
• Приглушать при выводе речи и звуков
• Всегда приглушать
• Приглушать неактивные приложения
• Приглушать активное приложение

Первые три — это стандартные режимы приглушения NVDA. Последние два добавлены этим дополнением:

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

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

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

Режим также можно выбрать в меню NVDA > Параметры > Настройки > Аудио, в комбинированном поле Режим приглушения звука (две новые записи появляются в конце списка). Смена профилей конфигурации также учитывается.

Как работают режимы с учётом фокуса

Два дополнительных режима построены на API звуковых сеансов Windows Core Audio. Дополнение регулирует громкость для каждого приложения, которую Windows предоставляет в своём микшере громкости, поэтому приглушение работает независимо от встроенного приглушения WASAPI в NVDA и не требует установленной копии или доступа к интерфейсу.

Windows группирует звук по процессам, но процесс, воспроизводящий звук, часто не тот, которому принадлежит окно, на которое вы устанавливаете фокус. Веб-браузеры — крайний случай: браузер на основе Chromium воспроизводит свой звук в отдельном изолированном служебном процессе и даёт каждой вкладке собственный отрисовщик, а Firefox распределяет звук по процессам содержимого. Поэтому дополнение определяет, какому приложению принадлежит каждый звуковой сеанс, прослеживая процесс сеанса до принадлежащего ему окна и возвращаясь к сопоставлению исполняемого файла, когда эта связь непригодна. Все процессы браузера рассматриваются как одно приложение, которое представляет его окно, поэтому установка фокуса на окно браузера влияет на весь его звук, а звук от одного из его вспомогательных процессов никогда не принимается за отдельное фоновое приложение.

Учитывайте следующее:

• Приложение затрагивается только тогда, когда у него есть звуковой сеанс, то есть с момента открытия звукового устройства, а не только пока звук слышен.
• Звук, который невозможно проследить до какого-либо окна приложения, не трогается. Звуки, воспроизводимые самой Windows, звуковым движком и NVDA, никогда не понижаются.
• Если запущены две отдельные копии одной программы с собственными окнами, звук от вспомогательного процесса, который невозможно проследить ни до одной из них, приписывается той из них, которая находится в фокусе, а в остальных случаях не трогается.
• Управляется только текущее устройство воспроизведения по умолчанию. Если вы смените устройство вывода, пока приложение приглушено, это приложение может сохранить пониженную громкость на старом устройстве.

Сборка

Установите требования для сборки дополнений NVDA, затем выполните:

scons

Созданный файл enhancedDuck-<version>.nvda-addon использует метаданные из buildVars.py и документацию из этого readme.md.

Примечания для магазина

Метаданные манифеста соответствуют текущей форме проверки Магазина дополнений: уникальное буквенно-цифровое имя дополнения, семантическая версия major.minor.patch и допустимые версии API NVDA для minimumNVDAVersion и lastTestedNVDAVersion.

Перед публикацией укажите реальный URL проекта или поддержки по HTTPS в значении addon_url в buildVars.py.