Управление голосовыми настройками (3)

(По материалам Freedom Scientific Devel oper Network)
Дата публикации:2005
Twitter Facebook Vkontakte

Описание встроенных функций и скриптов языка сценариев JAWS для управления параметрами синтезаторов речи и голосовыми настройками.

Скрипт SelectASynthesizer

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

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetActiveVoiceProfileByIndex

Описание: Устанавливает голосовой профиль по указанному индексу.

Возвращаемое значение: Void

Параметр 1:

Int, индекс голосового профиля. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. • JAWS 7.10 и более поздних

Функция SetAllVoicesToGlobals

Описание: Устанавливает указанный параметр голосовых контекстов в значение, сохранённое в глобальных переменных.

Возвращаемое значение: Void

Параметр 1:

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

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetSynth

Описание: Переключает JAWS на указанный речевой синтезатор.

Возвращаемое значение: Int, TRUE - если смена синтезатора была успешной, FALSE - в противном случае.

Параметр 1:

String, короткое имя синтезатора, указанное в файле JFW.INI. Это имя должно быть заключено в двойные кавычки. Например, вы можете отыскать короткое имя для Eloquence в файле JFW.INI в строке Synth1Name=eloq. Затем в вашем скрипте или функции вы можете использовать SetSynth("eloq"). Этот параметр является обязательным. Недокументированная возможность: вместо короткого имени можно в кавычках указать порядковый номер синтезатора и получить тот же результат, то есть предыдущий пример может выглядеть так:SetSynth("1")

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetSynthLanguage

Описание: Для синтезаторов, поддерживающих несколько языков, эта функция позволяет выбрать нужный язык синтеза.

Возвращаемое значение: Int, TRUE - если изменение было успешным, FALSE - если возникла ошибка.

Параметр 1:

String, наименование языка, на который нужно переключить синтезатор (в точности такое наименование языка, которое появляется в подменю Synthesizer Language в меню Language). Например:SetSynthLanguage ("American English"). Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoiceGlobalSettings

Описание: Сохраняет указанный параметр голосовых контекстов в глобальных переменных. Если этого не сделать до манипулирования голосовыми параметрами, то нельзя будет восстановить указанный параметр голосового контекста.

Возвращаемое значение: Void

Параметр 1:

Int, константа, сопоставленная с сохраняемым голосовым параметром. Такие константы определены в файле HjConst.jsh, например, V_RATE и V_PITCH. Этот параметр является обязательным.

Параметр 2:

String, строка, строковая константа или переменная, содержащая наименование голосового контекста, для которого нужно сохранить указанный параметр. Этот параметр является обязательным.

Параметр 3:

Int, текущее значение параметра данного голосового контекста. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoiceParameters

Описание: Устанавливает параметры голосового контекста. К параметрам относятся громкость, темп речи, высота тона, уровень проговаривания пунктуации и наименование голоса (персоны).

Возвращаемое значение: Void

Параметр 1:

String, константа с префиксом "VCTX_", обозначающая голосовой контекст и определённая в файле HjConst.jsh. Этот параметр является обязательным.

Параметр 2:

Int, устанавливаемое значение громкости. Этот параметр является обязательным.

Параметр 3:

Int, устанавливаемое значение темпа речи. Этот параметр является обязательным.

Параметр 4:

Int, устанавливаемое значение высоты тона. Этот параметр является обязательным.

Параметр 5:

Int, устанавливаемое значение уровня проговаривания пунктуации. Этот параметр является обязательным.

Параметр 6:

String, устанавливаемое наименование голоса (персоны). Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoicePerson

Описание: Устанавливает голос (персону) для указанного голосового контекста.

Возвращаемое значение: Void

Параметр 1:

String, константа с префиксом "VCTX_", обозначающая голосовой контекст и определённая в файле HjConst.jsh. Этот параметр является обязательным.

Параметр 2:

String, наименование нового голоса (персоны). Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoicePitch

Описание: Функция устанавливает высоту тона для указанного голосового контекста.

Возвращаемое значение: Void

Параметр 1:

String, константа с префиксом "VCTX_", обозначающая голосовой контекст и определённая в файле HjConst.jsh. Этот параметр является обязательным.

Параметр 2:

Int, новое значение высоты тона. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoicePunctuation

Описание: Функция устанавливает значение уровня проговаривания пунктуации для указанного голосового контекста.

Возвращаемое значение: Void

Параметр 1:

String, константа с префиксом "VCTX_", обозначающая голосовой контекст и определённая в файле HjConst.jsh. Этот параметр является обязательным.

Параметр 2:

Int, новое значение уровня проговаривания пунктуации. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoiceRate

Описание: Функция устанавливает значение темпа речи для указанного голосового контекста.

Возвращаемое значение: Void

Параметр 1:

String, константа с префиксом "VCTX_", обозначающая голосовой контекст и определённая в файле HjConst.jsh. Этот параметр является обязательным.

Параметр 2:

Int, новое значение темпа речи. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoiceSetting

Описание: Устанавливает параметры указанного голосового контекста. Рекомендуется использовать ChangeVoiceSetting, если необходимо просто изменить настройки.

Возвращаемое значение: Void

Параметр 1:

Int, константа, определяющая голосовой параметр, который нужно установить. Список констант можно найти в файле HjConst.jsh. Например: V_PITCH и V_RATE. Этот параметр является обязательным.

Параметр 2:

Int, новое значение для указанного голосового параметра. См. исходный код функции ChangeVoiceSetting в файле default.jss, чтобы узнать, как вычислить величину необходимых изменений. Этот параметр является обязательным.

Параметр 3:

String, название голосового контекста. Этот параметр является обязательным.

Параметр 4:

Int, одна из констант V_UP или V_DOWN, указывающая направление изменения. Это значение используется только для того, чтобы должным образом озвучить производимые изменения голосового параметра. Этот параметр является обязательным.

Параметр 5:

Int, true если нужно указать, что функция выполняется во время процесса непрерывного чтения (SayAll), false - в противном случае. Если указано true, то сообщение о производимых изменениях озвучено не будет. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SetVoiceVolume

Описание: Функция устанавливает громкость голоса для указанного голосового контекста.

Возвращаемое значение: Void

Параметр 1:

String, константа с префиксом "VCTX_", обозначающая голосовой контекст и определённая в файле HjConst.jsh. Этот параметр является обязательным.

Параметр 2:

Int, новое значение громкости. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SpeechInUse

Описание: Функция проверяет, используется ли в данный момент речевой вывод.

Возвращаемое значение: Int, TRUE - если синтезатор активен, FALSE - в противном случае.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SpeechOff

Описание: Отключает синтезатор. Это бывает особенно полезно, когда надо освободить звуковую карту, например, для проигрывания звукового файла, также бывает необходимо заблокировать речевой вывод во время выполнения скрипта или функции. Синтезатор можно включить с помощью функции SpeechOn.

Возвращаемое значение: Void

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SpeechOn

Описание: Восстанавливает работу синтезатора. Действие этой функции противоположно функции SpeechOff.

Возвращаемое значение: Void

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Функция SpeechToggledEvent

Описание: Событийная функция срабатывает всякий раз, когда произойдёт выключение (SpeechOff) или включение (SpeechOn)синтезатора речи.

Возвращаемое значение: Void

Параметр 1:

Int, TRUE - если синтезатор был включен, FALSE - если был выключен. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

  1. • JAWS 7.10 и более поздних

Функция StopSpeech

Описание: Прерывает синтез речи. Аналогична нажатию клавиши CTRL.

Возвращаемое значение: Void

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

  1. PAC Mate 1.10 и более поздних
  2. JAWS 4.51 и более поздних

Скрипт StopSpeech

Описание: Прерывает речевой вывод. Если этот скрипт вызывается во время процесса непрерывного чтения, то чтение будет остановлено и курсор будет находиться на последнем произнесённом слове.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

  1. PAC Mate 1.10 и более поздних


Распространение материалов сайта означает, что распространитель принял условия лицензионного соглашения.
Идея и реализация: © Владимир Довыденков и Анатолий Камынин,  2004-2019