Команды озвучивания текста

MMB позволяет управлять голосовой библиотекой (TTS) посредством своего языка скриптов. Основными особенностями команд озвучивания текста являются:
  • Установка голосовой библиотеки
  • Озвучивание текста из переменных и объектов
  • Управление частотой и скоростью голоса


InstallTTS()
Пояснение
Устанавливает голосовую библиотеку, если она не была предустановленна в системе пользователя. Команда проверяет состояние голосовой библиотеки и выполняет установку, если это необходимо. Не требует параметров.

При размещении проекта убедитесь, что вы включили установочные файлы библиотеки (msttss22L.exe, spchapi.exe) в каталог TTS, находящийся внутри каталога вашего приложения.

Пример
** Установка голосовой библиотеки (TTS)
InstallTTS()
Дополнительная информация
Если ваш проект использует TTS, то рекомендуется вызывать команду InstallTTS при запуске приложения, для того, чтобы быть уверенным, что голосовая библиотека готова к использованию.

Установочные файлы библиотеки находятся в подкаталоге TTS каталога MMB. Если у вас их нет, то вы можете загрузить их с сайта:

http://www.mediachance.com



InitTTS()
Пояснение
Инициализирует голосовую библиотеку. Не требует параметров.

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

а) использовать эту команду при запуске проекта

б) не использовать голосовую библиотеку в самом начале проекта, а дать ей несколько секунд для инициализации с помощью команд Pause() и ScriptTimer().
Пример
** Инициализация голосовой библиотеки
InitTTS()



Say("Текст$")
Пояснение
Озвучивает текст, указанный в качестве параметра команды или с помощью строковой переменной.

В первом случае текст является фиксированным параметром:

Say("Привет от MMB!")

Во втором случае вы сначала задаете текст с помощью строковой переменной:

text$='Привет от MMB!'

Затем используете ее в качестве параметра команды:

Say("text$")

Голосовая библиотека должна быть установлена и инициализирована.
Примеры
** Озвучивание текста, заданного в параметре команды
Say("Добро пожаловать в мой проект")

** Озвучивание текста, заданного с помощью текстовой переменной
text$='Добро пожаловать в мой проект'
Say("text$")



SpeakText("ИмяОбъекта")
Пояснение
Озвучивает текст из любого текстового объекта или кнопки.

Имя объекта указывается в качестве параметра команды.

Если объект, содержащий текст, имеет имя:

ShoutBox

То команда будет выглядеть так:

SpeakText("ShoutBox")

Голосовая библиотека должна быть установлена и инициализирована.
Пример
** Озвучивание текста из объекта StoryParagraph
SpeakText("StoryParagraph")



StopTTS()
Пояснение
Останавливает озвучивание текста (начатое с помощью команды Say или SpeakText).
Пример
** Остановка озвучивания текста
StopTTS()



PauseTTS()
Пояснение
Приостанавливает озвучивание текста (начатое с помощью команды Say или SpeakText).

Используйте команду ResumeTTS, чтобы продолжить озвучивание.
Пример
** Приостановка озвучивания текста
PauseTTS()



ResumeTTS()
Пояснение
Продолжает озвучивание текста (приостановленное с помощью команды PauseTTS()).
Пример
** Продолжение озвучивания текста
ResumeTTS()



PitchTTS("Частота")
Пояснение
Задает частоту голоса для озвучивания текста.

Параметр команды задает частоту голоса (в Гц), значение указывается либо непосредственно в параметре команды, либо с помощью числовой переменной, в диапазоне:

50-200

Значение по умолчанию - 100.

В первом случае частота является фиксированным параметром:

PitchTTS("80")

Во втором случае вы сначала задаете значение с помощью числовой переменной:

pitch=80

Затем используете ее в качестве параметра команды:

PitchTTS("pitch")
Примеры
** Задает частоту 130 Гц с помощью фиксированного параметра
PitchTTS("130")

** Задает частоту 130 Гц с помощью числовой переменной
pitch=130
PitchTTS("pitch")



SpeedTTS("Скорость")
Пояснение
Задает скорость произношения текста.

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

30-450

Значение по умолчанию - 150 слов в минуту.

В первом случае скорость является фиксированным параметром:

SpeedTTS("300")

Во втором случае вы сначала задаете значение с помощью числовой переменной:

speed=300

Затем используете ее в качестве параметра команды:

SpeedTTS("speed")
Примеры
** Задает скорость 300 слов/мин с помощью фиксированного параметра
SpeedTTS("300")

** Задает скорость 300 слов/мин с помощью числовой переменной
speed=300
SpeedTTS("speed")

MMB Программирование без границ :: dgilmour, перевод на русский язык, 2006 :: Все права защищены :: www.mmbscript.ru