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

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

Режимы

Нажимайте NVDA+shift+d для циклического переключения доступных режимов приглушения:

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

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

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

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

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

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

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

Поскольку Windows группирует аудио по процессам, имейте в виду следующее:

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

Сборка

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

scons

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

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

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

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