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

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

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

Функция ChangeVoiceSetting

Описание: Изменяет настройки активного голоса. В качестве параметров функция принимает голосовой параметр и направление (увеличить/уменьшить) его изменения.Голосовой параметр будет изменён на 10 процентов от своего диапазона допустимых изменений. Если в качестве третьего параметра передаётся TRUE, то это заблокирует сообщение о выполненных изменениях (что бывает необходимо в режиме непрерывного чтения). Эта функция является основной для манипуляции голосовыми параметрами.

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

Параметр 1:

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

Параметр 2:

Int, следует указать константу, определяющую направление изменения голосового параметра. Константы описаны в файле HjConst.jsh и это - V_UP и V_DOWN. Этот параметр является обязательным.

Параметр 3:

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

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

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

Скрипт DecreaseVoicePitch

Описание: Этот скрипт понижает тон активного голоса. При каждом вызове этого скрипта JAWS будет проговаривать "Lower".

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

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

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

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

Скрипт DecreaseVoicePitchSayAll

Описание: Этот скрипт понижает тон активного голоса во время процесса непрерывного чтения (SayAll). JAWS голосом с изменённым тоном повторит текущий фрагмент текста, прочитанный в режиме непрерывного чтения.

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

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

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

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

Скрипт DecreaseVoiceRate

Описание: Этот скрипт снижает темп речи активного голоса. При каждом вызове скрипта, JAWS будет проговаривать "Slower".

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

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

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

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

Скрипт DecreaseVoiceRateSayAll

Описание: Этот скрипт снижает темп речи активного синтезатора во время процесса непрерывного чтения (SayAll). JAWS голосом с изменённым темпом речи повторит текущий фрагмент текста, прочитанный в режиме непрерывного чтения.

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

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

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

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

Скрипт DecreaseVoiceVolume

Описание: Этот скрипт уменьшает громкость активного голоса. При каждом вызове этого скрипта, JAWS будет проговаривать "Softer".

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

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

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

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

Скрипт DecreaseVoiceVolumeSayAll

Описание: Этот скрипт уменьшает громкость активного голоса в процессе непрерывного чтения (SayAll). JAWS голосом с изменённой громкостью повторит текущий фрагмент текста, прочитанный в режиме SayAll.

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

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

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

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

Функция GetActiveSynthInfo

Описание: Это функция возвращает короткое и длинное наименование активного синтезатора (голоса), а также наименование драйвера, который использует JAWS для работы с этим синтезатором.

Возвращаемое значение: Int, TRUE - если удалось получить информацию о синтезаторе, FALSE - в случае ошибки.

Параметр 1:

String, в этом параметре функция возвращает короткое имя синтезатора, указанное в ключе SynthXShortName в файле JFW.ini (где X - номер синтезатора). Этот параметр является обязательным.

Параметр 2:

String, в этом параметре функция возвращает длинное имя синтезатора, указанное в ключе SynthXLongName в файле JFW.ini (где X - номер синтезатора). Этот параметр является обязательным.

Параметр 3:

String, в этом параметре функция возвращает имя драйвера, указанное в ключе SynthXDriver в файле JFW.ini (где X - номер синтезатора). Этот параметр является обязательным.

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

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

Функция GetActiveSynthLanguage

Описание: Эта функция возвращает наименование языка синтезатора.

Возвращаемое значение: String, наименование языка.

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

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

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

Функция GetSynthLanguages

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

Возвращаемое значение: String, список языков синтезатора.

Параметр 1:

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

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

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

Функция GetSynthPitchRange

Описание: Эта функция позволяет узнать минимально и максимально возможные значения высоты тона синтезатора.

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

Параметр 1:

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

Параметр 2:

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

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

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

Функция GetSynthRateRange

Описание: Эта функция позволяет получить минимально и максимально возможные значения темпа речи синтезатора.

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

Параметр 1:

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

Параметр 2:

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

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

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

Функция GetVoiceParameters

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

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

Параметр 1:

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

Параметр 2:

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

Параметр 3:

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

Параметр 4:

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

Параметр 5:

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

Параметр 6:

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

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

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

Функция GetVoicePerson

Описание: Эта функция, используя имя голосового контекста (Voice Context name), возвращает название голоса (имя персоны) активного синтезатора.

Возвращаемое значение: String, название текущего голоса (персоны).

Параметр 1:

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

Параметр 2:

Int, TRUE для настроек из файла приложения. По умолчанию параметры будут взяты из default.jcf. Этот параметр не является обязательным.

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

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

Функция GetVoicePitch

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

Возвращаемое значение: Int, значение высоты тона для текущего голоса.

Параметр 1:

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

Параметр 2:

Int, TRUE для настроек из файла приложения. По умолчанию параметры будут взяты из default.jcf. Этот параметр не является обязательным.

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

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

Функция GetVoicePunctuation

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

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

Параметр 1:

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

Параметр 2:

Int, TRUE для настроек из файла приложения. По умолчанию параметры будут взяты из default.jcf. Этот параметр не является обязательным.

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

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

Функция GetVoiceRate

Описание: Эта функция, используя имя голосового контекста, возвращает значение темпа речи для активного голоса.

Возвращаемое значение: Int, значение темпа речи для текущего голоса.

Параметр 1:

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

Параметр 2:

Int, TRUE для настроек из файла приложения. По умолчанию параметры будут взяты из default.jcf. Этот параметр не является обязательным.

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

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

Функция GetVoiceVolume

Описание: Эта функция, используя имя голосового контекста, возвращает значение громкости для активного голоса.

Возвращаемое значение: Int, значение громкости для текущего голоса.

Параметр 1:

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

Параметр 2:

Int, TRUE для настроек из файла приложения. По умолчанию параметры будут взяты из default.jcf. Этот параметр не является обязательным.

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

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

Функция GetVoiceVolumeRange

Описание: Эта функция позволяет узнать минимально и максимально возможные значения громкости текущего голоса.

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

Параметр 1:

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

Параметр 2:

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

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

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


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