Менеджер по синтезу речи ссылка

Обсуждение

SetSpeechProperty функция является Базовым Основанным на основе эквивалентом SetSpeechInfo функция.

Посмотрите “Speech-Channel Properties” для получения информации о свойствах можно указать.

Обсуждение

SetSpeechPitch функционируйте изменяет текущую речевую подачу на речевом канале, указанном chan параметр к подаче, указанной pitch параметр. Типичные частоты речевого диапазона располагаются приблизительно от 90 герц для низкого мужского голоса к, возможно, 300 герц для речи высокого дочернего элемента. Эти частоты соответствуют приблизительным значениям подачи в диапазонах 30 000 - 40 000 и 55 000 - 65 000, соответственно. Несмотря на то, что значения фиксированной точки позволяют Вам указывать широкий диапазон передач, не, все синтезаторы будут поддерживать полный спектр передач. Если Ваше приложение указывает подачу, которую не может обработать синтезатор, это может скорректировать подачу для адаптации в приемлемом диапазоне.

Обсуждение

SetSpeechRate функция корректирует речевой уровень на речевом канале, указанном chan параметр к уровню, указанному rate параметр. Как правило говорящие уровни располагаются приблизительно от 150 слов в минуту приблизительно к 220 словам в минуту. Важно иметь в виду, однако, что пользователи будут отличаться значительно по их возможности понять синтезированную речь на определенном уровне, основанном на их уровне опыта, слушая речь и их возможность ожидать типы произнесения, с которым они встретятся.

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

Обсуждение

CopyPhonemesFromText функция является Базовым Основанным на основе эквивалентом TextToPhonemes функция.

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

Данные CopyPhonemesFromText функционируйте хранилища в phonemes параметр соответствует точно фонемам, на которых говорили бы, имел входной текст, отправленный в SpeakCFString вместо этого. Все текущие настройки свойства для речевого канала, указанного chan применяются к преобразованной речи. Никакие обратные вызовы не сгенерированы в то время как CopyPhonemesFromText функция генерирует свой вывод.

Обсуждение

Функция UseSpeechDictionary является Базовым Основанным на основе эквивалентом UseDictionary функция.

UseSpeechDictionary функционируйте регистрируется CFDictionary объект, на который ссылаются speechDictionary параметр с речевым каналом, на который ссылаются chan параметр. Речевые словари позволяют Вашему приложению переопределять произношение синтезатора по умолчанию отдельных слов, такое как имена с необычными написаниями. Синтезатор будет использовать любые элементы словаря, который он считает полезным в речевом процессе преобразования. Некоторые синтезаторы речи могли бы проигнорировать определенные типы словарных статей.

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

Обратите внимание на то, что, потому что речевой словарь является a CFDictionary объект, это может быть загружено из основанного на XML файла списка свойств. Пример такого файла показан ниже:

После UseSpeechDictionary функционируйте возвраты, Ваше приложение является бесплатным выпустить CFDictionary объект, на который ссылаются speechDictionary параметр.

Обсуждение

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

Менеджер по Синтезу речи выпускает любые речевые каналы, от которых явно не избавилось приложение, когда приложение выходит. В целом, однако, Ваше приложение должно избавиться от любых речевых каналов, которые оно создало каждый раз, когда оно получает приостановить событие. Это гарантирует, что другие приложения могут в полной мере воспользоваться менеджером по Синтезу речи и Звуковыми возможностями менеджера.

Обсуждение

NewSpeechChannel функция выделяет память для структуры речевого канала и устанавливает переменную речевого канала, на которую указывают chan параметр для указания на эту структуру речевого канала. Менеджер по Синтезу речи автоматически определяет местоположение и открывает соединение с надлежащим синтезатором для речи, указанной voice параметр.

Нет никакого предопределенного предела числу речевых каналов, которые может создать приложение. Однако системные ограничения на доступный RAM, загрузка процессора и число доступных звуковых каналов ограничивают число фактически возможных речевых каналов.

Ваше приложение не должно пытаться управлять данными, на которые указывает переменная типа SpeechChannel. Внутренний формат, что менеджер по Синтезу речи использование для данных речевых каналов не документируется и может измениться в будущих версиях системного программного обеспечения.

Обсуждение

CopySpeechProperty функция является Базовым Основанным на основе эквивалентом GetSpeechInfo функция.

Обсуждение

Типичные частоты речевого диапазона располагаются приблизительно от 90 герц для низкого мужского голоса к, возможно, 300 герц для речи высокого дочернего элемента. Эти частоты соответствуют приблизительным значениям подачи в диапазонах 30 000 - 40 000 и 55 000 - 65 000, соответственно.

Обсуждение

Эта функция полезна, когда Вы хотите гарантировать, что никакая речь в настоящее время не производится нигде на компьютере Macintosh прежде, чем инициировать речь. Несмотря на то, что менеджер по Синтезу речи позволяет различным приложениям производить речь одновременно, это может сбить с толку пользователю. В результате это часто - хорошая идея для Вашего приложения, чтобы проверить, что никакой другой процесс не производит речь прежде, чем произвести саму речь. Если различие между значениями, возвращенными SpeechBusySystemWide и SpeechBusy функция 0, никакой другой процесс не производит речь.

Обсуждение

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

Обсуждение

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

Каждый раз CountVoices вызывается, менеджер по Синтезу речи поиски новой речи.

Обсуждение

GetIndVoice функционируйте возвраты в речевой структуре спецификации, на которую указывают voice параметр, спецификация речи, индекс которой предоставлен в index параметр. Ваше приложение не должно делать предположения о порядке, в котором индексируется речь.

Ваше приложение не должно добавлять, удалять, или изменять речь и затем вызывать GetIndVoice функция с индексом оценивает кроме 1. Чтобы позволить менеджеру по Синтезу речи обновлять его информацию о речи, Ваше приложение должно всегда или вызывать CountVoices функционируйте или вызовите GetIndVoice функция с индексным значением 1 после добавления, удаления или изменения речи или через некоторое время в котором пользователь, возможно, сделал так.

Если Вы указываете, что индекс оценивает вне числа доступной речи, GetIndVoice функционируйте возвращает a voiceNotFound ошибка.

Обсуждение

GetVoiceDescription функция заполняет речевую структуру описания, на которую указывают info параметр с корректной информацией для речи, указанной voice параметр. Это заполняет length поле речевой структуры описания с числом байтов фактически скопировано. Это значение всегда будет меньше чем или равно значению, в котором передает Ваше приложение infoLength перед вызовом GetVoiceDescription. Эта схема позволяет приложениям, предназначенным для текущей версии менеджера по Синтезу речи работать над будущими версиями, которые могли бы иметь более длинные речевые структуры описания; это также позволяет Вам писать код для будущих версий менеджера по Синтезу речи, который будет также работать на компьютерах, поддерживающих только текущую версию.

Если речевая структура спецификации не идентифицирует доступную речь, GetVoiceDescription возвраты a voiceNotFound ошибка.

Обсуждение

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

GetVoiceInfo функция принимает селектор в selector параметр, определяющий тип информации, которую Вы хотите получить о речи, указанной в voice параметр. Функция тогда заполняет поля структуры данных, надлежащей селектору, который Вы указываете в voiceInfo параметр.

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

Обсуждение

Речевая структура спецификации является уникальной речью ID, используемый менеджером по Синтезу речи. Большинство речевых функций управления ожидает быть переданным указатель на речевую структуру спецификации. Когда Вы уже знаете создателя и ID для речи, необходимо использовать MakeVoiceSpec функция для создания такой структуры вместо того, чтобы заполнить поля одного непосредственно. На выходе, речевая структура спецификации, на которую указывают voice параметр содержит надлежащие значения. Вы никогда не должны устанавливать поля такой структуры непосредственно.

Обсуждение

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

Если PauseSpeechAt функционируйте остановил речь посреди слова, менеджер по Синтезу речи начнет произносить то слово с начала, когда Вы вызовете ContinueSpeech.

Обсуждение

PauseSpeechAt функция делает паузу речеобразования в указанной точке в тексте. PauseSpeechAt возвраты сразу, несмотря на то, что речевой вывод будет продолжаться до указанной точки.

Можно определить, приостановило ли приложение речевой вывод на речевом канале путем получения речевой структуры информации о статусе через GetSpeechInfo функция. В то время как речевой канал приостанавливается, речевая структура информации о статусе указывает это outputBusy и outputPaused оба TRUE.

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

PauseSpeechAt функция отличается от StopSpeech и StopSpeechAt функции в этом последующий вызов к ContinueSpeech, описанный затем, заставляет содержание буфера текущего текста продолжать говориться.

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

Обсуждение

SpeakCFString функция является Базовым Основанным на основе эквивалентом SpeakBuffer функция.

SpeakCFString функция преобразовывает текстовую строку, указанную в aString в речь, с помощью речи и настроек управления в действительности для речевого канала, указанного в chan. (Перед использованием SpeakCFString, поэтому, убедитесь, что Вы создали речевой канал с NewSpeechChannel функция.) SpeakCFString функция генерирует речь асинхронно, что означает, что управление возвращается к Вашему приложению, прежде чем речь закончилась, возможно даже, прежде чем речь является сначала слышимой.

Если SpeakCFString вызывается, в то время как речевой канал в настоящее время говорит содержание другой текстовой строки, речь сразу останавливается, и на новой текстовой строке говорят как можно скорее.

Обсуждение

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

Можно также остановить речь путем передачи строки нулевой длины (или, в C, a null указатель) к одному из SpeakString, SpeakText, или SpeakBuffer функции. Выполнение этого останавливает речь только в указанном речевом канале (или, в случае SpeakString, в речевом канале, которым управляет внутренне менеджер по Синтезу речи).

Прежде, чем вызвать StopSpeech функция, можно использовать SpeechBusy функция, описанная в SpeechBusy, определить, говорит ли все еще синтезатор. Если Вы работаете с многократными речевыми каналами, можно использовать селектор состояния с функцией GetSpeechInfo который описан в GetSpeechInfo, определить, говорит ли все еще определенный канал.

Обсуждение

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

Если Вы вызываете StopSpeechAt функция перед менеджером по Синтезу речи заканчивает обрабатывать входной текст, тогда функция могла бы возвратиться, прежде чем на некотором входном тексте нужно все же говорить. Таким образом, перед избавлением от текстового буфера, Ваше приложение должно ожидать, пока его сделанную текстом функцию обратного вызова не вызвали (если Вы были определены), или пока это не может определить (например получая речевую структуру информации о статусе), что менеджер по Синтезу речи больше не обрабатывает входной текст.

Если конец входного текстового буфера достигнут перед указанной точкой остановки, остановками синтезатора речи в конце буфера, не генерируя ошибку.

Обсуждение

SpeechSynthesisRegisterModuleURL функционируйте регистрирует синтезатор речи или речь, указанную url и делает его доступным для обработки вызовов. Прежде чем речь синтезатора может быть зарегистрирована, синтезатор должен быть зарегистрирован (или загружен автоматически менеджером по Синтезу речи). Если Вы вызываете SpeechSynthesisRegisterModuleURL для регистрации речи и Вы получаете “incompatibleVoice” закончитесь код, вероятно, что должен быть зарегистрирован синтезатор, связанный с речью. Если Вы вызываете эту функцию для регистрации синтезатора или речи, уже зарегистрированной, SpeechSynthesisRegisterModuleURL ничего не делает и возвращает ошибку.

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

Вызвавшее приложение SpeechSynthesisRegisterModuleURL если объем, содержащий синтезатор или речь, собирается быть размонтированным, зарегистрировать синтезатор или речь должно сделать следующий:

• Вызвать DisposeSpeechChannel избавляться от каждого речевого канала, использующего синтезатор или речь

• Вызвать SpeechSynthesisUnregisterModuleURL не зарегистрировать синтезатор или речь

Обсуждение

SpeechSynthesisUnregisterModuleURL функционируйте не регистрирует синтезатор речи или речь, указанную url. Когда синтезатор не зарегистрирован, вся речь, требующая, чтобы синтезатор был автоматически не зарегистрирован.

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

Вызвавшее приложение SpeechSynthesisRegisterModuleURL если объем, содержащий синтезатор или речь, собирается быть размонтированным, зарегистрировать синтезатор или речь должно сделать следующий:

• Вызвать DisposeSpeechChannel избавляться от каждого речевого канала, использующего синтезатор или речь

• Вызвать SpeechSynthesisUnregisterModuleURL не зарегистрировать синтезатор или речь

Если Вы вызываете SpeechSynthesisUnregisterModuleURL чтобы не зарегистрировать синтезатор или речь и Вы принимаете любого “noSynthFound” или “voiceNotFound” закончитесь коды, это означает, что в настоящее время не регистрируются синтезатор или речь.