Обновление документации и подготовка к отправке в магазин дополнений NVDA.
Никаких функциональных изменений по сравнению с версией 1.0.0.

YoutubeCaptionReader (Чтец субтитров YouTube)

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

Версия 1.0.1

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

• Совместимость с NVDA: 2026.1.1
• Протестированный браузер: Microsoft Edge
• Поддерживаемые страницы: страницы видео и Shorts на YouTube
• Исходный код: https://github.com/sheldon-im/nvda-youtube-caption-reader
• Загрузка релизов: https://github.com/sheldon-im/nvda-youtube-caption-reader/releases

Установка

1. Загрузите youtubeCaptionReader-1.0.1.nvda-addon из релиза 1.0.1.
2. Откройте загруженный файл и подтвердите установку в NVDA.
3. Перезапустите NVDA, когда программа попросит вас об этом.
4. Откройте видео на YouTube, включите субтитры и запустите воспроизведение.

Дополнение запускается с автоматическим чтением субтитров.

Использование с переведёнными субтитрами

Функция Автоперевод YouTube может отображать корейские субтитры для видео, у которого субтитры доступны на другом языке. Включите субтитры и выберите корейский язык в настройках субтитров YouTube. Дополнение читает тот текст, который YouTube предоставляет через Windows API специальных возможностей; оно не выполняет перевод субтитров самостоятельно.

Команды

• NVDA+Shift+Y: Включить или выключить автоматическое чтение субтитров.
• NVDA+Shift+U: Прочитать субтитры, отображаемые в данный момент на экране.
• NVDA+Shift+D: Открыть диагностический отчёт о дереве доступности субтитров YouTube. Эта команда предназначена для поиска и устранения неисправностей.

Как это работает

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

• Завершённые предложения и части предложений озвучиваются по мере их появления.
• Длинные автоматические субтитры без знаков препинания могут озвучивать префикс на границе слова после ожидания до 1,5 секунд.
• Короткий незавершённый суффикс ожидает стабилизации текста. Задержка адаптируется к недавним обновлениям субтитров и составляет от 450 до 1200 миллисекунд.
• Быстрые обновления удерживаются в течение 450 миллисекунд перед отправкой в общую очередь речи NVDA. Отправляется только самый новый ожидающий субтитр, и дополнение никогда не отменяет речь NVDA, не связанную с субтитрами.
• Обнаруженная перемотка видео очищает собранные субтитры и ожидающее состояние перед обработкой новой позиции.
• Когда YouTube убирает старую строку с экрана, дополнение сравнивает только текущее и непосредственно предыдущее состояние субтитров. Это предотвращает блокировку последующих субтитров из-за сократившегося представления.

Чтобы не замедлять работу с другими страницами, опрос субтитров выполняется только тогда, когда NVDA определяет, что активный документ является страницей видео или Shorts на YouTube.

Ограничения и устранение неисправностей

• Дополнение зависит от того, предоставляют ли YouTube, браузер и NVDA субтитры через Windows API специальных возможностей. Изменения в любом из них могут потребовать обновления дополнения.
• Собственные автоматические субтитры YouTube и функция автоперевода уже могут отставать от исходного звука. Дополнение не может устранить эту задержку.
• Очень быстрые субтитры могут объединяться, чтобы речь оставалась ближе к текущей позиции видео. Поэтому некоторые промежуточные фрагменты субтитров могут быть пропущены.
• Если субтитры видны, но не озвучиваются, нажмите NVDA+Shift+U. Если субтитры всё ещё не найдены, нажмите NVDA+Shift+D и приложите диагностический отчёт при сообщении о проблеме.
• Перед сообщением о проблеме с горячими клавишами отключите любые другие дополнения для чтения субтитров YouTube, которые могут использовать те же жесты NVDA.

Пожалуйста, сообщайте о воспроизводимых проблемах в системе отслеживания ошибок. Укажите версию NVDA, браузер, URL видео YouTube (если его можно опубликовать), выбранный язык субтитров и, при наличии, вывод команды NVDA+Shift+D.

Разработка

Этот проект использует официальный шаблон дополнений NVDA.

scons
python -m unittest discover -s tests -v

Сборка создаёт файл youtubeCaptionReader-1.0.1.nvda-addon в корневой папке репозитория. Непрерывная интеграция выполняется в Windows и проверяет форматирование, модульные тесты и упаковку дополнения.

Лицензия

GPL-2.0-or-later. См.