v1.7

• ОБНОВЛЕНИЕ АРХИТЕКТУРЫ: Дополнение стало полностью совместимым с NVDA 2026.1, 64-битной архитектурой и стандартами Python 3.13.


• УЛУЧШЕНИЕ: Все компоненты интерфейса и диалоговые окна обновлены в соответствии с высшими стандартами доступности WCAG для экранных дикторов.


• ИСПРАВЛЕНИЕ: Ошибка недопустимого вызова «PostPopup», которая приводила к сбою NVDA при открытии главного окна чата и после сохранения настроек, полностью устранена.


• УЛУЧШЕНИЕ: Инфраструктура кода переведена на строгую модульную структуру, полностью изолирующую логику интерфейса (frontend) и ядра (backend).


• УЛУЧШЕНИЕ: Все наименования переменных, функций, классов и файлов переорганизованы в соответствии со стандартами PascalCase без использования турецких символов.


• ОБНОВЛЕНИЕ: В каждую строку архитектуры кода без исключения добавлены подробные комментарии на турецком языке, что максимально повышает читаемость для разработчиков.


• ОБНОВЛЕНИЕ: Подробно обновлено руководство по получению API-ключа.


• ОБНОВЛЕНИЕ: Файл readme визуально улучшен, добавлена контактная информация.

YoutubeChatClientForNVDA (Клиент чата YouTube Live)

Версия: 1.7 (2026.06.06)

Разработчик: Adem ERDOĞAN

Авторские права: Copyright © 2026, Adem ERDOĞAN (Erdoğan Teknoloji ve Programcılık).

Это дополнение позволяет незрячим пользователям отслеживать сообщения чата прямых трансляций YouTube, пожертвования Super Chat и события участия в сообществах через экранный диктор NVDA, предоставляя 100% доступный интерфейс.
Полностью совместимо с NVDA 2026.1 и более поздними 64-битными версиями.

Установка и первые шаги

1. Перезапустите NVDA после установки дополнения.
   Дополнение автоматически определит язык NVDA (турецкий, английский или немецкий).

2. Нажмите клавиши NVDA + Shift + CTRL + Y или запустите дополнение из меню «Сервис» (Tools) NVDA.

3. При первом запуске вас попросят ввести API-ключ.
   Система автоматически направит вас в окно настроек.

4. Вставьте полученный в Google Cloud Console ключ YouTube Data v3 API в соответствующее поле и нажмите кнопку «Сохранить настройки».

Как получить API-ключ? (Подробное руководство)

Это руководство шаг за шагом объясняет, как получить бесплатный API-ключ, необходимый дополнению для подключения к чатам YouTube.
Даже если у вас нет технических знаний, вы можете легко создать свой ключ, следуя этим шагам по порядку.
Примечание: Не сообщайте свой API-ключ никому.

Шаг 1: Вход в Google Cloud Platform

1. Нажмите кнопку «Открыть консоль Google Cloud в браузере» в дополнении или перейдите по адресу https://console.cloud.google.com в вашем браузере.
2. Войдите, используя существующую учетную запись Google (Gmail).
   Если вы входите в систему впервые, может появиться экран с условиями использования или приветствием; подтвердите, чтобы продолжить.

Шаг 2: Создание нового проекта

1. Нажмите кнопку «Выбрать проект» в верхней части экрана. Найдите и нажмите кнопку «Новый проект» в правом верхнем углу открывшегося окна.
2. В поле «Имя проекта» введите простое имя, которое поможет вам запомнить дополнение (Например: «NVDA Youtube Chat»).
3. Нажмите кнопку «Создать» внизу. Создание проекта может занять несколько секунд; дождитесь его завершения.

Шаг 3: Включение YouTube API

1. После создания проекта нажмите «API и сервисы» в левом навигационном меню, затем перейдите на вкладку «Библиотека».
2. В появившемся поле поиска введите «YouTube Data API v3» и выполните поиск.
3. Нажмите на ссылку «YouTube Data API v3» в результатах поиска.
4. На открывшейся странице нажмите кнопку «Включить».
   Этот процесс предоставит вашему созданному проекту разрешение на получение данных чата YouTube.

Шаг 4: Создание API-ключа

1. После включения API нажмите на вкладку «Учетные данные» на странице, на которую вы будете перенаправлены, или в левом меню.
2. Нажмите кнопку «Создать учетные данные» в верхней части экрана.
3. В открывшемся небольшом меню выберите опцию «Ключ API».

Шаг 5: Копирование ключа и добавление его в дополнение

1. На экране откроется окно с сообщением «Ключ API создан», и появится сложный длинный код, начинающийся с букв «AIza».

2. Этот длинный текст и есть ваш API-ключ.
   Скопируйте его, нажав кнопку копирования рядом с текстом или выделив текст полностью.

3. Теперь вернитесь в настройки дополнения NVDA, вставьте скопированный ключ в поле «Ключ Google API» и сохраните настройки.

ВАЖНОЕ ЗАМЕЧАНИЕ ПО БЕЗОПАСНОСТИ:
Этот ключ является полностью конфиденциальным. Пожалуйста, не делитесь им с другими и не публикуйте его на открытых платформах.
Google предоставляет эту услугу полностью бесплатно для личного использования, и ежедневной квоты, выделенной для получения сообщений дополнением, более чем достаточно для личного использования.

Использование главного окна

• Поле URL: Вставьте сюда ссылку на прямую трансляцию YouTube, которую хотите отслеживать.

• Меню «Параметры»: Из этого меню вы можете быстро получить доступ ко всем дополнительным окнам, таким как «Настройки», «История версий», «Руководство по API», «О программе» и «Веб-сайт».

• Старт/Стоп: Запускает или останавливает поток сообщений чата.
  Поток работает в фоновом режиме, не нагружая NVDA.

• Список чата: Входящие сообщения попадают сюда в доступный список.
  Вы можете перемещаться между сообщениями с помощью клавиш со стрелками.

Меню настроек

• Ключ API: В целях безопасности отображается замаскированным (звездочками).
  Вы можете прочитать содержимое с помощью кнопки «Показать» и мгновенно очистить его с помощью кнопки «Очистить».

• Временная метка: Определяет, будет ли время отправки написано в начале сообщений.

• Автоматическое чтение: Управляет тем, будет ли экранный диктор автоматически зачитывать сообщение при поступлении нового сообщения.

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

• Интервал запроса API: Определяет, как часто (в секундах) будут запрашиваться данные с серверов YouTube (По умолчанию: 10 секунд).
  Если установить это значение слишком низким, ваш дневной лимит API будет исчерпан очень быстро.
  Рекомендуется использовать значение в диапазоне от 5 до 15 секунд.

• Сбросить к настройкам по умолчанию: Сбрасывает все ваши изменения, возвращая настройки к состоянию, которое было сразу после установки.

Контакты и социальные сети

__YouTube Канал __Instagram Аккаунт __WhatsApp Канал __Github Аккаунт __Электронная почта __Веб-сайт

Разработчик: Adem ERDOĞAN (ERDOĞAN TEKNOLOJİ VE PROGRAMCILIK).

Copyright © 2026 Adem ERDOĞAN (ERDOĞAN TEKNOLOJİ VE PROGRAMCILIK) Все права защищены.