Руководство пользователя дополнения WebDataSSML для NVDA

Введение

WebDataSSML — это дополнение для программы экранного доступа NVDA, которое позволяет веб-разработчикам использовать SSML (Speech Synthesis Markup Language) разметку для улучшения звукового воспроизведения контента.
Дополнение распознает специальные атрибуты в HTML-коде и преобразует их в команды синтеза речи.
Дополнение обрабатывает атрибуты data-ssml на веб-страницах в соответствии с https://www.w3.org/TR/spoken-html

Настройка

Дополнение настраивается через диалог настроек NVDA:

1. Откройте меню NVDA → Параметры → Настройки
2. Найдите раздел “Data-SSML” в списке категорий
3. Доступные параметры:
   • Профилирование — включение замера времени выполнения операций (для разработчиков)
   • Логирование Брайля — запись в лог информации о выводе на брайлевский дисплей
   • Сочетание клавиш для переключения синтезатора — добавление горячей клавиши для быстрой смены синтезатора речи

Использование на веб-страницах

Дополнение автоматически активируется при посещении веб-страниц, содержащих разметку data-ssml. Поддерживаются три техники внедрения SSML:

1. Inline-техника (встроенная)

SSML-команды встраиваются непосредственно в текст с использованием специальных невидимых символов.

2. Index-техника (индексная)

SSML-команды хранятся в скрытом контейнере и ссылаются по индексу.

3. Page-wide техника (общестраничная)

Создается глобальный словарь соответствий обычного текста и SSML-представлений.

Поддерживаемые SSML-команды

<say-as>

Управляет способом произношения текста:
- characters или spell — побуквенное произношение
- Автоматически использует команду CharacterModeCommand когда возможно

<sub>

Замещение текста:

<span data-ssml='{"sub": {"alias": "произносимый текст"}}'>исходный текст</span>

<phoneme>

Фонетическое произношение с использованием IPA:

<span data-ssml='{"phoneme": {"ph": "θ"}}'>th</span>

<break>

Вставка паузы:

<span data-ssml='{"break": {"time": "500ms"}}'> </span>

Технические особенности

Совместимость с синтезаторами

Дополнение тестировалось с:

• oneCore
• SAPI5
• eSpeak

Некоторые команды (особенно PhonemeCommand) могут работать по-разному в разных синтезаторах.

Обработка брайля

При включенной опции логирования брайля, дополнение записывает в лог информацию о выводе на брайлевский дисплей, что помогает в отладке.

Горячие клавиши

При включении соответствующей опции становится доступно сочетание клавиш NVDA+Ctrl+Alt+N для циклического переключения между доступными синтезаторами речи.

Устранение неполадок

Включение логирования

Для диагностики проблем включите ведение логов:

1. Откройте меню NVDA → Сервис → Просмотр лога
2. Ищите записи с префиксом “data-ssml”

Частые проблемы

1. Команды не работают — проверьте совместимость вашего синтезатора речи
2. Текст произносится неправильно — убедитесь в правильности SSML-разметки
3. Паузы неправильной длительности — длительность пауз может зависеть от синтезатора и скорости речи

Перезагрузка дополнения

При возникновении проблем попробуйте:

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

Примечание: Для полной функциональности дополнения веб-страницы должны содержать соответствующий JavaScript код, обрабатывающий атрибуты data-ssml.