Cuckoo (Кукушка)

Внимание, это дополнение долгое время было заброшено, но по инициативе руководителя русскоязычного сообщества оно было обновлено. В дополнение были добавлены некоторые новые функции.

Первые разработчики этого дополнения:

Первоначальными разработчиками дополнения Cuckoo для NVDA были следующие программисты, после чего от этого дополнения окончательно отказались. В любом случае, этих людей следует помнить, потому что на протяжении многих лет это дополнение было источником радости для пользователей NVDA и пользовалось достаточной популярностью, пока не было выпущено дополнение Clock.

• Alsari2012 ibnomer2011@hotmail.com
• Atair atair1978@gmail.com
• Ashraf Helal ashrafhelal112@gmail.com

Введение

Cuckoo - это дополнение для программы экранного доступа NVDA, которое предоставляет возможность получать регулярные оповещения о текущем времени. Это незаменимый инструмент для людей, которым важно следить за временем в течение дня без постоянной проверки часов.

Дополнение получило свое название в честь традиционных "кукушек" - часов с птичкой, появляющейся каждый час. Как и ее механический прототип, Cuckoo точно и надежно сообщает вам о текущем времени через заданные интервалы.

Основные возможности

✅ Гибкие интервалы оповещений: от каждой минуты до каждого часа
✅ Разнообразные типы оповещений: звук, речь, комбинированные варианты
✅ Множество различных звуков: от традиционных кукушек до современных сигналов с возможностью добавления своих звуков ✅ Тихий час: возможность отключить оповещения в ночное время
✅ Пользовательские фразы: настройка произносимого текста
✅ Пауза речи: автоматическая приостановка текущей речи при оповещении

Быстрый старт

1. Откройте настройки: Сервис → Настройки Кукушки...
2. Выберите интервал: например, "Каждые 30 минут"
3. Выберите тип оповещения: например, "Звук и речь"
4. Нажмите OK: дополнение начнет работать автоматически

Теперь каждые 30 минут вы будете слышать звуковое и голосовое оповещение текущего времени.

Подробное описание функций

Интервалы оповещений

Дополнение предлагает 7 вариантов интервалов:

Типы оповещений

Вы можете выбрать один из девяти типов оповещений:

1. Только звук

• Воспроизводится выбранный звуковой сигнал
• Речь NVDA не прерывается

2. Только речь

• Произносится текущее время
• Текущая речь приостанавливается на время оповещения

3. Звук и речь

• Сначала воспроизводится звук, затем произносится время
• Идеально для людей с ослабленным слухом

4. Речь и звук

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

5. Только пользовательская фраза

• Произносится настраиваемая фраза
• Например: "Время проверить осанку"

6. Пользовательская фраза и звук

• Сначала произносится пользовательская фраза, затем выбранный звук
• Полезно для напоминаний о перерывах

7. Звук и пользовательская фраза

• Сначала воспроизводится выбранный звук, затем произносится пользовательская фраза
• Полезно для напоминаний о перерывах

8. Пользовательская фраза и время

• Произносится фраза и текущее время
• Например: "Время кофе-брейка, сейчас 10:30"

9. Время и пользовательская фраза

• Произносится текущее время и затем фраза
• Например: "Сейчас 10:30, Время кофе-брейка"

Настройка звуков

В комплекте пакет различных коротких и длинных звуков. Можно добавлять свои звуки и удалять не нужные (Поддерживаеться только wav-формат).

Как выбрать звук:

1. Откройте настройки Cuckoo
2. Выберите "Звук оповещения"
3. Прослушайте варианты, нажимая стрелки вверх/вниз
4. Выбранный звук воспроизводится автоматически

Добавление своего звука

Если хотите добавить свой звук или несколько звуков, проделайте следующие:

• Нажмите кнопку «Открыть папку звуков».
• Вставьте в папку свой файл со звуком.
• Закройте папку со звуками и вернитесь в окно настроек Кукушки.
• Затем нажмите кнопку «Обновить список звуков».
• После этого в списке выберите свой звук.

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

Настройка длительности паузы

Позволяет настроить задержку перед возобновлением речи в МС (по умолчанию значение 500 МС).

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

1. Перед воспроизведением оповещения проверяется состояние речи NVDA
2. Если речь активна, она ставится на паузу имитацией нажатия Control
3. После завершения оповещенияКукушки , через заданное время прерваная речь автоматически возобновляется
4. Режим "Читать всё" также корректно обрабатывается

Оповещения Cuckoo не прерывают длинные реплики или чтение в режиме "Say All", а временно приостанавливают их и возобновляют с того же места.

Тихий час

Функция "Тихий час" позволяет отключить оповещения в определенное время суток.

Настройка:

1. Включите "Включить тихий час"
2. Установите время начала (например, 22:00)
3. Установите время окончания (например, 07:00)
4. Нажмите "Применить" или "OK"

Особенности:

• Поддерживает период через полночь (22:00-07:00)
• Время указывается в 24-часовом формате
• Оповещения возобновляются автоматически после окончания тихого часа

Пользовательские фразы

Для типов оповещений 3, 4 и 5 можно настроить собственные фразы:

Примеры использования:

• "Пора сделать перерыв"
• "Проверь осанку"
• "Время выпить воды"
• "Разомнись немного"
• "Проверь почту"
• "Время принять лекарство"

Настройка:

1. Выберите тип оповещения с пользовательской фразой
2. В появившемся поле введите нужную фразу
3. Нажмите "Тест настроек" для проверки

Управление и навигация

Доступ к настройкам

Есть два способа открыть настройки Cuckoo:

1. Через меню: Сервис → Настройки Кукушки...
2. С помощью жеста ввода: Сочетание клавиш не назначено.

Навигация в диалоге настроек

При открытии диалога фокус автоматически устанавливается на первый элемент - выбор интервала. Используйте стандартную навигацию:

• Tab/Shift+Tab: Переход между элементами
• Стрелки вверх/вниз: Выбор в комбинированных списках
• Пробел/Enter: Активация кнопок и чекбоксов
• Escape: Закрытие диалога без сохранения

Кнопки диалога

• Тест настроек: Проверка текущих настроек без сохранения
• Применить: Сохранение настроек без закрытия диалога
• OK: Сохранение и закрытие
• Cancel: Закрытие без сохранения

Настройка жестов ввода

Стандартный метод

1. Откройте NVDA-меню → Настройки → Жесты ввода
2. Найдите категорию "Сервис"
3. Найдите команду "Открыть диалог настроек Кукушки"
4. Нажмите "Добавить" и введите желаемую комбинацию клавиш
5. Нажмите "OK" для сохранения

Рекомендуемые сочетания

• NVDA+Shift+C: Быстрый доступ к настройкам
• NVDA+Alt+T: Для связи с функцией времени
• Ctrl+Shift+C: Простое запоминаемое сочетание

Точность работы

Синхронизация времени

Cuckoo использует точную синхронизацию с системным временем:

• Запуск NVDA: Если NVDA запущена не в начале минуты (например, в 10:00:33), дополнение подождет до следующей целой минуты (10:01:00) перед началом работы
• Включение функции: При включении через настройки синхронизация происходит автоматически
• Ежедневная работа: Проверка происходит каждую секунду, но оповещение срабатывает только в 00 секунд

Особенности работы

• Не создает нагрузки на систему
• Использует отдельный поток для проверки времени
• Автоматически корректирует сдвиги системного времени
• Работает даже при спящем режиме экрана

Решение проблем

Оповещения не работают

1. Проверьте настройки:

   • Убедитесь, что интервал не "Disabled"
   • Проверьте, не включен ли "Тихий час"
   • Убедитесь, что громкость NVDA не отключена

2. Проверьте звук:

   • Нажмите "Тест настроек" в диалоге настроек
   • Если звука нет, проверьте системную громкость
   • Убедитесь, что другие звуки NVDA работают

3. Проверьте журнал NVDA:

   • Откройте журнал (NVDA+F1)
   • Ищите записи с "Cuckoo"
   • Сообщите об ошибках разработчику

Звук есть, но нет речи

1. Проверьте тип оповещения:

   • Выберите "Только речь" или "Звук и речь"
   • Нажмите "Тест настроек"

2. Проверьте настройки речи NVDA:

   • Убедитесь, что синтезатор речи активен
   • Проверьте громкость речи

3. Проверьте паузу речи:

   • Уменьшите значение "Задержка перед возобновлением речи"
   • По умолчанию: 500 мс

Дополнение не появляется в меню

1. Проверьте установку:

   • Убедитесь, что дополнение установлено
   • Перезапустите NVDA

2. Проверьте совместимость:

   • Убедитесь, что версия NVDA не ниже 2024.1
   • Проверьте режим безопасности (не должен быть активен)

Ошибки в журнале

Если в журнале появляются ошибки:

1. Сделайте резервную копию настроек NVDA
2. Переустановите дополнение
3. Обратитесь к разработчику с копией журнала

Часто задаваемые вопросы

Вопрос: Могу ли я добавить свои звуки?

Ответ: Да, для этого:

1. Найдите папку дополнения (обычно в AppData\Roaming\nvda\addons\cuckoo\files)
2. Добавьте свои WAV-файлы (моно, 44100 Гц рекомендуется)
3. Отредактируйте файл __init__.py, добавив имена файлов в список sndMap
4. Перезапустите NVDA

Вопрос: Работает ли дополнение в режиме безопасности?

Ответ: Нет, в режиме безопасности дополнения отключены.

Вопрос: Можно ли иметь разные настройки для разных дней?

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

Вопрос: Влияет ли на точность переход на летнее/зимнее время?

Ответ: Нет, Cuckoo использует системное время, которое автоматически корректируется.

Вопрос: Можно ли отключить паузу речи?

Ответ: Да, установите "Speech pause duration" в 0 мс.

Вопрос: Сохраняются ли настройки при обновлении?

Ответ: Да, настройки хранятся в конфигурации NVDA и сохраняются при обновлении.

Вопрос: Есть ли поддержка 12-часового формата?

Ответ: Да, дополнение использует системный формат времени вашей Windows.

Безопасность и совместимость

Безопасность

• Не требует интернет-соединения
• Не собирает персональные данные
• Работает только с локальными файлами
• Совместимо с брандмауэрами Windows

Принцип работы

1. При запуске создается фоновый поток
2. Поток синхронизируется с системным временем
3. Каждую секунду проверяется текущее время
4. При начале новой минуты проверяются настройки
5. Если нужно - воспроизводится оповещение
6. Все операции в основном потоке NVDA

Потребление ресурсов

• Память: ~5-10 МБ
• ЦП: <0.1% в простое
• Диск: ~20 МБ (в основном звуковые файлы)