Менеджер по распознаванию речи ссылка
Менеджер по Распознаванию речи предоставляет поддержку распознавания речи в приложениях.
-
Закрывает систему распознавания, когда Ваше приложение закончено с помощью нее (например, как раз перед выходами приложения).
Объявление
Swift
func SRCloseRecognitionSystem(_system: SRRecognitionSystem) -> OSErrObjective C
OSErr SRCloseRecognitionSystem ( SRRecognitionSystem system );Параметры
systemСистема распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRCloseRecognitionSystemфункционируйте закрывает систему распознавания, указаннуюsystemпараметр. Если какие-либо речевые объекты все еще присоединены к той системе распознавания, от них избавляются, и любые ссылки, которые Вы имеете к тем объектам, таким образом, представляются недопустимые.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Открывает систему распознавания.
Объявление
Swift
func SROpenRecognitionSystem(_system: UnsafeMutablePointer<SRRecognitionSystem>, _systemID: OSType) -> OSErrObjective C
OSErr SROpenRecognitionSystem ( SRRecognitionSystem *system, OSType systemID );Параметры
systemПо возврату, ссылке на систему распознавания, имеющую указанную систему ID.
systemIDСистема распознавания ID.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Обычно необходимо открыть единственную систему распознавания, когда приложение запускает, и закройте его (путем вызывания функции
SRCloseRecognitionSystem) перед Вашими выходами приложения.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Отменяет попытку распознать текущее произнесение.
Объявление
Swift
func SRCancelRecognition(_recognizer: SRRecognizer) -> OSErrObjective C
OSErr SRCancelRecognition ( SRRecognizer recognizer );Параметры
recognizerУстройство распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRCancelRecognitionфункция сообщает устройству распознавания, указанномуrecognizerпараметр, чтобы прекратить распознавать речь. Необходимо вызвать такжеSRContinueRecognitionилиSRCancelRecognitionкаждый раз Ваше приложение уведомляется, что пользователь начал говорить (использование событий Apple или через определенную с помощью приложения подпрограмму обратного вызова).Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Заставляет устройство распознавания продолжать распознавать речь.
Объявление
Swift
func SRContinueRecognition(_recognizer: SRRecognizer) -> OSErrObjective C
OSErr SRContinueRecognition ( SRRecognizer recognizer );Параметры
recognizerУстройство распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Необходимо вызвать также
SRContinueRecognitionилиSRCancelRecognitionкаждый раз Ваше приложение уведомляется, что пользователь начал говорить (использование событий Apple или через определенную с помощью приложения подпрограмму обратного вызова).Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Получает активную языковую модель устройства распознавания.
Объявление
Swift
func SRGetLanguageModel(_recognizer: SRRecognizer, _languageModel: UnsafeMutablePointer<SRLanguageModel>) -> OSErrObjective C
OSErr SRGetLanguageModel ( SRRecognizer recognizer, SRLanguageModel *languageModel );Параметры
recognizerУстройство распознавания.
languageModelПо возврату, ссылке на языковую модель, в настоящее время активную для указанного устройства распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRGetLanguageModelувеличивает подсчет ссылок указанной языковой модели. Необходимо вызватьSRReleaseObjectфункционируйте для выпуска ссылки языковой модели, возвращеннойSRGetLanguageModelкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Время обработки предоставлений менеджеру по Распознаванию речи, если Ваше приложение не вызывает
WaitNextEventчасто.Объявление
Swift
func SRIdle() -> OSErrObjective C
OSErr SRIdle ( void );Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRIdleфункционируйте предоставляет время обработки менеджеру по Распознаванию речи, таким образом позволяя ему обработать входящий звук и отправить результаты распознавания.Большинство приложений не должно вызывать
SRIdleфункция. Необходимо вызвать его, только если приложение делает существенное количество обработки без периодического вызоваWaitNextEvent. Если Вы действительно используетеSRIdleфункция, необходимо вызывать его достаточно часто, что менеджер по Распознаванию речи может выполнить его работу.Отметьте, однако, это, если Вы вызываете
SRIdleи нетWaitNextEvent, Вы даете время устройству распознавания, но не окну обратной связи. Необходимо вызватьWaitNextEventесли устройство распознавания использует стандартное окно обратной связи, периодически для имения анимаций обратной связи работают правильно.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает новое устройство распознавания.
Объявление
Swift
func SRNewRecognizer(_system: SRRecognitionSystem, _recognizer: UnsafeMutablePointer<SRRecognizer>, _sourceID: OSType) -> OSErrObjective C
OSErr SRNewRecognizer ( SRRecognitionSystem system, SRRecognizer *recognizer, OSType sourceID );Параметры
systemСистема распознавания.
recognizerПо возврату ссылка на новое устройство распознавания связалась с указанной системой распознавания и использованием указанного речевого источника.
sourceIDРечевой источник ID. Посмотрите Речевые Исходные Константы.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRNewRecognizerвозможно, должен загрузить значительное количество данных от диска в память. В результате Вы могли бы хотеть изменить курсор на курсор часов перед вызовомSRNewRecognizer.Необходимо вызвать
SRReleaseObjectфункционируйте для выпуска ссылки на объект, возвращеннойSRNewRecognizerкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Устанавливает активную языковую модель устройства распознавания.
Объявление
Swift
func SRSetLanguageModel(_recognizer: SRRecognizer, _languageModel: SRLanguageModel) -> OSErrObjective C
OSErr SRSetLanguageModel ( SRRecognizer recognizer, SRLanguageModel languageModel );Параметры
recognizerУстройство распознавания.
languageModelЯзыковая модель Вы хотите стать активной моделью для указанного устройства распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Если никакие другие ссылки не существуют к языковой модели, использующейся в настоящее время указанным устройством распознавания, вызывая
SRSetLanguageModelс различной языковой моделью заставляет текущую быть выпущенной.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Запускает слушание устройства распознавания и создание отчетов о результатах к Вашему приложению.
Объявление
Swift
func SRStartListening(_recognizer: SRRecognizer) -> OSErrObjective C
OSErr SRStartListening ( SRRecognizer recognizer );Параметры
recognizerУстройство распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRStartListeningфункция сообщает устройству распознавания, указанномуrecognizerпараметр, чтобы начать обрабатывать звук из его речевого источника и сообщать о его результатах Вашему приложению (или использовать события Apple или через подпрограмму обратного вызова распознавания речи).Вы, должно быть, уже создали языковую модель и присоединили ее к устройству распознавания (путем вызова
SRSetLanguageModelфункция) перед вызовомSRStartListening.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Останавливает слушание устройства распознавания и создание отчетов о результатах к Вашему приложению.
Объявление
Swift
func SRStopListening(_recognizer: SRRecognizer) -> OSErrObjective C
OSErr SRStopListening ( SRRecognizer recognizer );Параметры
recognizerУстройство распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRStopListeningфункция сообщает устройству распознавания, указанномуrecognizerпараметр, чтобы прекратить обрабатывать звук из его речевого источника и сообщать о его результатах Вашему приложению.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Получает текущую стоимость свойства речевого объекта.
Объявление
Swift
func SRGetProperty(_srObject: SRSpeechObject, _selector: OSType, _property: UnsafeMutablePointer<Void>, _propertyLen: UnsafeMutablePointer<Size>) -> OSErrObjective C
OSErr SRGetProperty ( SRSpeechObject srObject, OSType selector, void *property, Size *propertyLen );Параметры
srObjectРечевой объект.
selectorСелектор свойства. Посмотрите Свойства Устройства распознавания, Устройство распознавания Слушают Ключевые Свойства, Свойства объектов Языка и Системные Свойства Распознавания для списков доступных селекторов свойства.
propertyУказатель на буфер, в который должно быть скопировано значение указанного свойства.
propertyLenНа записи, указателе на длину, в байтах, указанного буфера. Если значение имеет фиксированный размер, то
propertyLenдолжен указать на переменную типаSizeэто указывает тот размер. Если размер значения может варьироваться (например, если значение является строкой), тоpropertyLenдолжен указать на переменную типаSizeэто указывает число байтов в буфере, на который указываютpropertyпараметр.По возврату, если буфер является достаточно большим для содержания возвращенного значения свойства и никакой ошибки, происходит,
SRGetPropertyнаборыpropertyLenк общему количеству байтов в значении указанного свойства. Если буфер не является достаточно большим для содержания возвращенного значения свойства,SRGetPropertyнаборыpropertyLenк числу байтов, требуемых сохранить требуемое свойство и возвратыkSRBufferTooSmallкод ошибки.Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Не все селекторы допустимы для всех типов речевых объектов. Если селектор свойство указанного речевого объекта, который Вы указываете не указывает
SRGetPropertyвозвращает код результатаkSRCantGetProperty.Если
SRGetPropertyвозвращает ссылку на объект, необходимо удостовериться, что выпустили ту ссылку на объект (путем вызоваSRReleaseObject) когда Вы закончены с помощью него. Большинство селекторов не вызываетSRGetPropertyк ссылкам эхо-сигнала. Например, передача селектораkSRSpellingпричиныSRGetPropertyвозвратить буфер текста, не ссылку на объект.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Получает дополнительную ссылку на речевой объект.
Объявление
Swift
func SRGetReference(_srObject: SRSpeechObject, _newObjectRef: UnsafeMutablePointer<SRSpeechObject>) -> OSErrObjective C
OSErr SRGetReference ( SRSpeechObject srObject, SRSpeechObject *newObjectRef );Параметры
srObjectРечевой объект.
newObjectRefПо возврату, новой ссылке на указанный речевой объект.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Ссылка исходного объекта (содержавшийся в
srObject) и новая ссылка (возвратился вnewObjectRef) может иметь различные значения. Соответственно, Вы не можете просто сравнить две ссылки на объект, чтобы определить, являются ли они ссылками на тот же речевой объект.SRGetReferenceувеличивает подсчет ссылок указанного речевого объекта. Необходимо вызватьSRReleaseObjectфункционируйте для выпуска ссылки на объект, возвращеннойSRGetReferenceкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Выпускает речевой объект.
Объявление
Swift
func SRReleaseObject(_srObject: SRSpeechObject) -> OSErrObjective C
OSErr SRReleaseObject ( SRSpeechObject srObject );Параметры
srObjectРечевой объект.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Если нет никаких других остающихся ссылок на объект,
SRReleaseObjectизбавляется от памяти, занятой объектом.Ваше приложение должно сбалансировать каждый вызов функции, возвращающий ссылку на объект с вызовом к
SRReleaseObject. Это означает, что каждый вызов к функции, имя которой начинаетсяSRNewилиSRGetэто успешно возвращается, ссылка на объект должна быть сбалансирована с вызова кSRReleaseObject.Кроме того, необходимо вызвать
SRReleaseObjectвыпускать ссылки наSRSearchResultобъекты, передающиеся Вашему приложению (через обработчик событий Apple или подпрограмму обратного вызова).Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Устанавливает значение свойства речевого объекта.
Объявление
Swift
func SRSetProperty(_srObject: SRSpeechObject, _selector: OSType, _property: UnsafePointer<Void>, _propertyLen: Size) -> OSErrObjective C
OSErr SRSetProperty ( SRSpeechObject srObject, OSType selector, const void *property, Size propertyLen );Параметры
srObjectРечевой объект.
selectorСелектор свойства. Посмотрите Свойства Устройства распознавания, Устройство распознавания Слушают Ключевые Свойства, Свойства объектов Языка и Системные Свойства Распознавания для списков доступных селекторов свойства.
propertyУказатель на буфер, содержащий значение, в которое должно быть установлено указанное свойство.
propertyLenДлина, в байтах, указанного буфера.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRSetPropertyфункционируйте устанавливает значение свойства речевого объекта, указанногоsrObjectпараметр к значению, указанному черезpropertyпараметр.selectorпараметр указывает, какое свойство должно быть установлено иpropertyLenпараметр указывает его размер в байтах.Не все свойства могут быть установлены. При попытке установить свойство, которое не может быть установлено,
SRSetPropertyвозвращает код результатаkSRCantSetPropertyилиkSRBadSelectorкак его функциональный результат.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Определяет число подэлементов в контейнерном объекте.
Объявление
Swift
func SRCountItems(_container: SRSpeechObject, _count: UnsafeMutablePointer<Int>) -> OSErrObjective C
OSErr SRCountItems ( SRSpeechObject container, long *count );Параметры
containerРечевой объект.
countПо возврату, указателю на длинное, содержащее число подэлементов в указанном речевом объекте.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Эта функция полезна только для речевых объектов, имеющих различимые подэлементы, такие как фразы (которые содержат слова), пути (которые содержат слова, фразы, и языковые модели) и языковые модели (которые содержат слова, фразы, пути, и возможно другие языковые модели).
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Получает подэлемент в контейнерном объекте.
Объявление
Swift
func SRGetIndexedItem(_container: SRSpeechObject, _item: UnsafeMutablePointer<SRSpeechObject>, _index: Int) -> OSErrObjective C
OSErr SRGetIndexedItem ( SRSpeechObject container, SRSpeechObject *item, long index );Параметры
containerРечевой объект.
itemПо возврату, ссылке на подэлемент в указанном речевом объекте, имеющем указанный индекс.
indexЦелое число в пределах от 0 к меньше, чем число подэлементов в указанном речевом объекте. (Можно вызвать
SRCountItemsфункция для определения числа подэлементов, содержавшихся в речевом объекте.), Если индекс Вы указываете, не находится в этом диапазоне,SRGetIndexedItemвозвращает код результатаkSRParamOutOfRange.Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Эта функция полезна для итерации через все подэлементы в контейнерном объекте.
SRGetIndexedItemувеличивает подсчет ссылок указанного речевого объекта. Необходимо вызватьSRReleaseObjectфункционируйте для выпуска ссылки на объект, возвращеннойSRGetIndexedItemкогда Вы сделаны с помощью него. Например, можно получить ссылку на третье слово во фразе путем выполнения этого кода:myErr = SRGetIndexedItem(myPhrase, &myWord, 2)Затем когда Вы закончены с помощью слова, необходимо выполнить этот код:
myErr = SRReleaseObject(myWord);Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Удаляет подэлемент из контейнерного объекта.
Объявление
Swift
func SRRemoveIndexedItem(_container: SRSpeechObject, _index: Int) -> OSErrObjective C
OSErr SRRemoveIndexedItem ( SRSpeechObject container, long index );Параметры
containerРечевой объект.
indexЦелое число в пределах от 0 к меньше, чем число подэлементов в указанном речевом объекте. (Можно вызвать
SRCountItemsфункция для определения числа подэлементов, содержавшихся в речевом объекте.), Если индекс Вы указываете, не находится в этом диапазоне,SRRemoveIndexedItemвозвращает код результатаkSRParamOutOfRange.Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRRemoveIndexedItemфункция удаляет из речевого объекта, указанногоcontainerпараметр подэлемент расположился в позиции, указаннойindexпараметр. ЕслиSRRemoveIndexedItemзавершается успешно, количество подэлементов в контейнерном объекте сокращено 1, и индекс каждого подэлемента, следующего за удаленным элементом, сокращен на 1.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Заменяет подэлемент в контейнерном объекте с некоторым другим объектом.
Объявление
Swift
func SRSetIndexedItem(_container: SRSpeechObject, _item: SRSpeechObject, _index: Int) -> OSErrObjective C
OSErr SRSetIndexedItem ( SRSpeechObject container, SRSpeechObject item, long index );Параметры
containerРечевой объект.
itemРечевой объект.
indexЦелое число в пределах от 0 к меньше, чем число подэлементов в указанном речевом объекте.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRSetIndexedItemфункционируйте заменяет подэлемент, указывающий индексindexпараметр в контейнерном объекте, указанномcontainerпараметр с речевым объектом, указаннымitemпараметр. Ссылка на заменяющий элемент сохраняется отдельно контейнером; в результате можно выпустить любую ссылку на тот элемент, если Вам больше не нужен он. Ссылка на замененный элемент удалена из контейнера; если та ссылка была последней остающейся ссылкой на объект, объект выпущен.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает новую языковую модель.
Объявление
Swift
func SRNewLanguageModel(_system: SRRecognitionSystem, _model: UnsafeMutablePointer<SRLanguageModel>, _name: UnsafePointer<Void>, _nameLength: Int32) -> OSErrObjective C
OSErr SRNewLanguageModel ( SRRecognitionSystem system, SRLanguageModel *model, const void *name, SInt32 nameLength );Параметры
systemСистема распознавания.
modelПо возврату ссылка на новую пустую языковую модель связалась с указанной системой распознавания.
nameУказатель на буфер, содержащий имя языковой модели. Имя языковой модели должно быть уникальным среди всех языковых моделей, которые создает Ваше приложение, и это должно быть понятно пользователям. (Например, языковую модель, определившую список имен, можно было бы вызвать ««Именами»»).
Соглашение, что имена языковой модели начинаются с символа “«” и конца с символом, “»” принято для поддержки будущих утилит, выводящих на экран имена языковых моделей пользователю (возможно, как часть показа пользователя, что он или она может сказать).
nameLengthРазмер, в байтах, указанного имени.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Можно добавить объекты языка (т.е. слова, фразы, пути и другие языковые модели) к языковой модели путем вызова
SRAddTextиSRAddLanguageObjectфункции.SRNewLanguageModelустанавливает подсчет ссылок указанной языковой модели к 1. Необходимо вызватьSRReleaseObjectфункционируйте для выпуска ссылки языковой модели, возвращеннойSRNewLanguageModelкогда Вы сделаны с помощью него.Можно получить или определить имя существующей языковой модели путем вызова
SRGetPropertyилиSRSetPropertyфункции сkSRSpellingселектор свойства.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает новый путь.
Объявление
Swift
func SRNewPath(_system: SRRecognitionSystem, _path: UnsafeMutablePointer<SRPath>) -> OSErrObjective C
OSErr SRNewPath ( SRRecognitionSystem system, SRPath *path );Параметры
systemСистема распознавания.
pathПо возврату ссылка на новый пустой путь связалась с указанной системой распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Можно тогда добавить объекты к пути путем вызова
SRAddTextилиSRAddLanguageObjectфункции.Необходимо вызвать
SRReleaseObjectфункционируйте для выпуска ссылки пути, возвращеннойSRNewPathкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает новую фразу.
Объявление
Swift
func SRNewPhrase(_system: SRRecognitionSystem, _phrase: UnsafeMutablePointer<SRPhrase>, _text: UnsafePointer<Void>, _textLength: Int32) -> OSErrObjective C
OSErr SRNewPhrase ( SRRecognitionSystem system, SRPhrase *phrase, const void *text, SInt32 textLength );Параметры
systemСистема распознавания.
phraseПо возврату ссылка на новую фразу связалась с указанной системой распознавания.
textУказатель на буфер, содержащий слова, включающие фразу.
textLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Содержание фразы (т.е. слова, включающие фразу) указано
textиtextLengthпараметры. При необходимости можно создать новую пустую фразу и затем добавить слова к ней путем вызоваSRAddTextилиSRAddLanguageObjectфункции.Необходимо вызвать
SRReleaseObjectфункционируйте для выпуска ссылки фразы, возвращеннойSRNewPhraseкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает новое слово.
Объявление
Swift
func SRNewWord(_system: SRRecognitionSystem, _word: UnsafeMutablePointer<SRWord>, _text: UnsafePointer<Void>, _textLength: Int32) -> OSErrObjective C
OSErr SRNewWord ( SRRecognitionSystem system, SRWord *word, const void *text, SInt32 textLength );Параметры
systemСистема распознавания.
wordПо возврату ссылка на новое слово связалась с указанной системой распознавания.
textУказатель на буфер, содержащий символы, включающие слово.
textLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Необходимо вызвать
SRReleaseObjectфункционируйте для выпуска ссылки слова, возвращеннойSRNewWordкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Добавляет объект языка к некоторому другому объекту языка.
Объявление
Swift
func SRAddLanguageObject(_base: SRLanguageObject, _addon: SRLanguageObject) -> OSErrObjective C
OSErr SRAddLanguageObject ( SRLanguageObject base, SRLanguageObject addon );Параметры
baseОбъект языка, к которому можно добавить объект языка, указанный
addonпараметр.addonОбъект языка прибавить к объекту языка, указанному в
baseпараметр. Например, еслиaddonуказывает слово иbaseуказывает фразу, тогдаSRAddLanguageObjectдобавляет то слово до конца той фразы.Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRAddLanguageObjectфункция полезна для добавления, что язык возражает против фраз, путей и языковых моделей. Для фразы или пути,SRAddLanguageObjectдобавляет указанный объект до конца фразы или пути. Для языковой модели,SRAddLanguageObjectдобавляет указанный объект к списку альтернативного распознаваемого произнесения.Объект языка, к которому Вы добавляете объект, получает новую ссылку на тот объект. Соответственно, любые изменения, которые Вы впоследствии вносите в добавленный объект, отражаются в любом объекте, к которому Вы добавили его. Когда от базового объекта избавляются, базовый объект выпускает свою ссылку на добавленный объект.
SRAddLanguageObjectне изменяет значение ссылочного постоянного свойства объекта языка, указанногоbaseпараметр.Посмотрите
SRAddTextдля полезной функции ярлыка.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Добавляет текст к содержанию объекта языка.
Объявление
Swift
func SRAddText(_base: SRLanguageObject, _text: UnsafePointer<Void>, _textLength: Int32, _refCon: SRefCon) -> OSErrObjective C
OSErr SRAddText ( SRLanguageObject base, const void *text, SInt32 textLength, SRefCon refCon );Параметры
baseОбъект языка, к которому можно добавить текст.
textУказатель на буфер, содержащий слова или фразу для добавления к содержанию указанного объекта языка.
textLengthРазмер, в байтах, указанного текста.
refConОпределенная с помощью приложения ссылочная константа. Значение ссылочного постоянного свойства нового слова или фразы, представляющей указанный текст, установлено в это значение.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRAddTextфункция полезна для фраз, путей и языковых моделей. Еслиbaseпараметр указывает путь или языковую модель,SRAddTextэквивалентно вызовуSRNewPhrase,SRAddLanguageObject, иSRReleaseObjectдля фразы, указаннойtextпараметр и вызовSRSetPropertyсбрасывать значение ссылочного постоянного свойства новой фразы.Если
baseпараметр указывает фразу,SRAddTextэквивалентно вызовуSRNewPhrase,SRAddLanguageObject, иSRReleaseObjectдля каждого различимого слова вtextпараметр и вызовSRSetPropertyустановить значение ссылочного постоянного свойства новых слов.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Изменяет содержание объекта языка.
Объявление
Swift
func SRChangeLanguageObject(_languageObject: SRLanguageObject, _text: UnsafePointer<Void>, _textLength: Int32) -> OSErrObjective C
OSErr SRChangeLanguageObject ( SRLanguageObject languageObject, const void *text, SInt32 textLength );Параметры
languageObjectОбъект языка.
textУказатель на буфер, содержащий слова или фразу, на которую должно быть изменено содержание указанного объекта языка.
textLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRChangeLanguageObjectудобный ярлык для вызоваSREmptyLanguageObjectи затемSRAddText.SRChangeLanguageObjectне изменяет значение ссылочного постоянного свойства объекта языка, указанногоlanguageObjectпараметр.Если нет никаких других ссылок на объект языка, указанный
languageObjectпараметр, вызываяSRChangeLanguageObjectпричины, возражающие, чтобы быть выпущенными.Если Вы хотите подкачать быстро среди нескольких языковых моделей, необходимо использовать
SRSetLanguageObjectфункция вместоSRChangeLanguageObject. Или, Вы могли использоватьkSREnabledсвойство, чтобы быстро включить и отключить части текущей языковой модели для отражения текущего контекста.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Освобождает содержание объекта языка.
Объявление
Swift
func SREmptyLanguageObject(_languageObject: SRLanguageObject) -> OSErrObjective C
OSErr SREmptyLanguageObject ( SRLanguageObject languageObject );Параметры
languageObjectОбъект языка.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SREmptyLanguageObjectфункциональная порожняя тара содержание объекта языка, указанногоlanguageObjectпараметр. (Например, еслиlanguageObjectуказывает фразу, содержащую два слова, вызываяSREmptyLanguageObjectпривел бы к фразе, не содержащей слов.) Любые свойства того объекта, не связанные с его содержанием, неизменны. В частностиSREmptyLanguageObjectне изменяет значение ссылочного постоянного свойства того объекта языка.Если нет никаких других ссылок на слова, фразы и пути, содержавшиеся в объекте языка, вызывая
SREmptyLanguageObjectзаставляет их быть избавленными.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает объект языка из дескриптора, ранее создаваемого
SRPutLanguageObjectIntoHandleфункция.Объявление
Swift
func SRNewLanguageObjectFromHandle(_system: SRRecognitionSystem, _languageObject: UnsafeMutablePointer<SRLanguageObject>, _lObjHandle: Handle) -> OSErrObjective C
OSErr SRNewLanguageObjectFromHandle ( SRRecognitionSystem system, SRLanguageObject *languageObject, Handle lObjHandle );Параметры
systemСистема распознавания.
languageObjectПо тому, возврату, ссылке на новый объект языка создаваемое и инициализированное использование частных данных, к который
lobjHandleпараметр является дескриптором.lObjHandleДескриптор к объекту языка. Данные, указанные
lobjHandleдолжен был быть создан предыдущим вызовом кSRPutLanguageObjectIntoHandleфункция; если те данные соответственно не отформатированы,SRNewLanguageObjectFromHandleвозвращает код результатаkSRCantReadLanguageObjectкак его функциональный результат.Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Можно использовать эту функцию для загрузки объектов языка из ресурсов (например, при помощи функции Менеджера ресурсов
GetResource).Необходимо вызвать
SRReleaseObjectфункционируйте для выпуска ссылки на объект языка, возвращеннойSRNewLanguageObjectFromHandleкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Читает объект языка из файла данных.
Объявление
Swift
func SRNewLanguageObjectFromDataFile(_system: SRRecognitionSystem, _languageObject: UnsafeMutablePointer<SRLanguageObject>, _fRefNum: Int16) -> OSErrObjective C
OSErr SRNewLanguageObjectFromDataFile ( SRRecognitionSystem system, SRLanguageObject *languageObject, short fRefNum );Параметры
systemСистема распознавания.
languageObjectПо возврату ссылка на новый язык возражает, чье описание сохранено в открытом файле данных, которому указали число ссылки на файл
fRefNumпараметр.fRefNumЧисло ссылки на файл открытого файла данных.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRNewLanguageObjectFromDataFileданные чтений, начинающиеся в текущей метке файла.Если объект языка успешно создается и инициализируется, метку файла сразу оставляют в байте после описания объекта языка. Иначе, если данные объектов языка соответственно не отформатированы,
SRNewLanguageObjectFromDataFileвозвращает код результатаkSRCantReadLanguageObjectкак его функциональный результат и метка файла не перемещен.Необходимо вызвать
SRReleaseObjectфункционируйте для выпуска ссылки на объект языка, возвращеннойSRNewLanguageObjectFromDataFileкогда Вы сделаны с помощью него.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Помещает объект языка (и любые встроенные языки возражает, что он содержит) в дескриптор.
Объявление
Swift
func SRPutLanguageObjectIntoHandle(_languageObject: SRLanguageObject, _lobjHandle: Handle) -> OSErrObjective C
OSErr SRPutLanguageObjectIntoHandle ( SRLanguageObject languageObject, Handle lobjHandle );Параметры
languageObjectОбъект языка.
lobjHandleДескриптор к блоку памяти, в которую должны быть помещены данные, описывающие указанный объект языка. На записи этот дескриптор может иметь длину 0.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRPutLanguageObjectIntoHandleфункция помещает описание объекта языка, указанногоlanguageObjectпараметр в блок памяти, указаннойlobjHandleпараметр. Это заменяет данные в дескрипторе и изменяет размеры дескриптора при необходимости.Можно использовать функции Менеджера ресурсов (такой как
AddResource) хранить объекты языка в ресурсы.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Помещает объект языка (и любой встроенный язык возражает, что содержит) в файл данных.
Объявление
Swift
func SRPutLanguageObjectIntoDataFile(_languageObject: SRLanguageObject, _fRefNum: Int16) -> OSErrObjective C
OSErr SRPutLanguageObjectIntoDataFile ( SRLanguageObject languageObject, short fRefNum );Параметры
languageObjectОбъект языка.
fRefNumЧисло ссылки на файл открытого файла данных, в который должны быть помещены данные, описывающие указанный объект языка.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRPutLanguageObjectIntoDataFileфункция помещает описание объекта языка, указанногоlanguageObjectпараметр в файл данных, указанныйfRefNumпараметр. Данные записаны, запустившись в текущей метке файла, и метка файла перемещена до конца записанных данных.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Удаляет объект языка из другого объекта языка, содержащего его.
Объявление
Swift
func SRRemoveLanguageObject(_base: SRLanguageObject, _toRemove: SRLanguageObject) -> OSErrObjective C
OSErr SRRemoveLanguageObject ( SRLanguageObject base, SRLanguageObject toRemove );Параметры
baseОбъект языка, содержащий язык, возражает для удаления.
toRemoveОбъект языка удалить.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
Объект, указанный
baseпараметр должен быть контейнерным, подэлементов которого объект, указанныйtoRemoveпараметр.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Составляет распознанный текст в окне обратной связи.
Объявление
Swift
func SRDrawRecognizedText(_recognizer: SRRecognizer, _dispText: UnsafePointer<Void>, _dispLength: Int32) -> OSErrObjective C
OSErr SRDrawRecognizedText ( SRRecognizer recognizer, const void *dispText, SInt32 dispLength );Параметры
recognizerУстройство распознавания.
dispTextУказатель на буфер, содержащий текст, который будет нарисован.
dispLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRDrawRecognizedTextфункция составляет текст, указанныйdispTextиdispLengthпараметры в части копии окна обратной связи связались с устройством распознавания, указаннымrecognizerпараметр. Текст составлен в характеристике стиля всего распознанного текста. Вы могли бы хотеть использовать эту функцию для отображения распознанной фразы с помощью различного написания, чем то, используемое в языковой модели.Если значение
kSRWantsResultTextDrawnсвойство указанного устройства распознаванияTRUE(который является значением по умолчанию), копия текста результата распознавания автоматически отправляется непосредственно в окно обратной связи. В результате необходимо вызватьSRDrawRecognizedTextтолько, когда значение устройства распознаванияkSRWantsResultTextDrawnсвойствоFALSE.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Составляет синтезируемый текст в окне обратной связи.
Объявление
Swift
func SRDrawText(_recognizer: SRRecognizer, _dispText: UnsafePointer<Void>, _dispLength: Int32) -> OSErrObjective C
OSErr SRDrawText ( SRRecognizer recognizer, const void *dispText, SInt32 dispLength );Параметры
recognizerУстройство распознавания.
dispTextУказатель на буфер, содержащий текст, который будет нарисован.
dispLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRDrawTextфункция составляет текст, указанныйdispTextиdispLengthпараметры в части копии окна обратной связи связались с устройством распознавания, указаннымrecognizerпараметр. Текст составлен в характеристике стиля всего синтезируемого текста.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Указывает, что обрабатывается результат распознавания.
Объявление
Swift
func SRProcessBegin(_recognizer: SRRecognizer, _failed: Boolean) -> OSErrObjective C
OSErr SRProcessBegin ( SRRecognizer recognizer, Boolean failed );Параметры
recognizerУстройство распознавания.
failedБулево значение, определяющее, как жесты обратной связи должны быть изменены и должен ли звук ответа играться (
FALSE) или не (TRUE).Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRProcessBeginфункционируйте заставляет менеджера по Распознаванию речи обеспечивать соответствующую обратную связь (в окне обратной связи, связанном с устройством распознавания, указаннымrecognizerпараметр) указание, что приложение находится в процессе ответа на речевую команду. В настоящее время жесты символа обратной связи изменяются, чтобы указать, что происходит обработка.Если Вы устанавливаете значение устройства распознавания
kSRWantsAutoFBGesturesсвойство кFALSE, необходимо вызватьSRProcessBeginв начале Вашего ответа на распознавание заканчиваются иSRProcessEndв конце Вашего ответа. Во время интервала, разделяющего два вызова, символьные дисплеи обратной связи надлежащий набор жестов, показывающих пользователю, что обрабатывается задача. Если Вы передаете значениеTRUEвfailedпараметр (указание, что результат распознавания не может успешно быть обработан), хмурые взгляды символьных дисплеев обратной связи, пожатия плеч или другие надлежащие жесты. Кроме того, когдаfailedTRUE, Вы не должны вызыватьSRProcessEndзакончить обработку. Если Вы передаете значениеFALSEвfailedпараметр, но решает впоследствии, что результат распознавания не может успешно быть обработан, необходимо вызватьSRProcessEndсfailedнабор параметра кTRUE.Если значение
kSRWantsAutoFBGesturesсвойство указанного устройства распознаванияTRUE, Вызовы диспетчера Распознавания речиSRProcessBeginвнутренне прежде, чем уведомить Ваше приложение результата распознавания, и это вызываетSRProcessEndвнутренне после того, как Ваше приложение уведомляется. В результате необходимо вызватьSRProcessBeginилиSRProcessEndтолько, когда значение устройства распознаванияkSRWantsAutoFBGesturesсвойствоFALSE.Поскольку значение по умолчанию
kSRWantsAutoFBGesturesсвойствоTRUE, большинство приложений не должно вызыватьSRProcessBegin. ВызовSRProcessBeginполезно, однако, когда Вы знаете, что получающееся действие могло бы занять существенное количество времени.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Указывает, что результат распознавания сделан, будучи обработанным.
Объявление
Swift
func SRProcessEnd(_recognizer: SRRecognizer, _failed: Boolean) -> OSErrObjective C
OSErr SRProcessEnd ( SRRecognizer recognizer, Boolean failed );Параметры
recognizerУстройство распознавания.
failedБулево значение, определяющее, как жесты обратной связи должны быть изменены (
FALSE) или не (TRUE).Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRProcessEndфункционируйте заставляет менеджера по Распознаванию речи обеспечивать соответствующую обратную связь (в окне обратной связи, связанном с устройством распознавания, указаннымrecognizerпараметр) указание, что результат распознавания сделан, будучи обработанным. В настоящее время жесты символа обратной связи изменяются, и звук ответа играется.Если значение
kSRWantsAutoFBGesturesсвойство указанного устройства распознаванияTRUE, Вызовы диспетчера Распознавания речиSRProcessBeginвнутренне прежде, чем уведомить Ваше приложение результата распознавания, и это вызываетSRProcessEndвнутренне после того, как Ваше приложение уведомляется. В результате необходимо вызватьSRProcessBeginилиSRProcessEndтолько, когда значение устройства распознаванияkSRWantsAutoFBGesturesсвойствоFALSE.Поскольку значение по умолчанию
kSRWantsAutoFBGesturesсвойствоTRUE, большинство приложений не должно вызыватьSRProcessBegin. ВызовSRProcessBeginполезно, однако, когда Вы знаете, что получающееся действие могло бы занять существенное количество времени.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Составляет синтезируемый текст в окне обратной связи и заставляет символ обратной связи в окне обратной связи говорить тот текст.
Объявление
Swift
func SRSpeakAndDrawText(_recognizer: SRRecognizer, _text: UnsafePointer<Void>, _textLength: Int32) -> OSErrObjective C
OSErr SRSpeakAndDrawText ( SRRecognizer recognizer, const void *text, SInt32 textLength );Параметры
recognizerУстройство распознавания.
textУказатель на буфер, содержащий текст, который будет рисоваться и говориться.
textLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Заставляет символ обратной связи в окне обратной связи говорить текстовую строку.
Объявление
Swift
func SRSpeakText(_recognizer: SRRecognizer, _speakText: UnsafePointer<Void>, _speakLength: Int32) -> OSErrObjective C
OSErr SRSpeakText ( SRRecognizer recognizer, const void *speakText, SInt32 speakLength );Параметры
recognizerУстройство распознавания.
speakTextУказатель на буфер, содержащий текст, на котором будут говорить. Текст, на который указывают
speakTextпараметр может содержать встроенные речевые команды для улучшения просодии разговорной строки.speakLengthРазмер, в байтах, указанного текста.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
При разговоре, синхронизации выступа символа обратной связи разговорная строка с помощью подпрограмм обратного вызова фонемы менеджера по Синтезу речи.
SRSpeakTextиспользует речь по умолчанию и уровень, выбранный в Речевой панели управления. (Менеджера по Синтезу речи раньше вызвали менеджером по Речи. Его имя было изменено, чтобы отличить его от менеджера по Распознаванию речи и описать его работу более ясно.)Можно использовать
SRSpeechBusyфункция, чтобы определить, говорит ли уже символ обратной связи. Если это, можно вызватьSRStopSpeechфункционируйте для остановки того разговора сразу.SRSpeakTextфункция говорит указанный текст, но не выводит на экран его. ИспользуйтеSRSpeakAndDrawTextфункционируйте, если Вы хотите говорить и вывести на экран текст.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Определяет, говорит ли в настоящее время символ обратной связи в окне обратной связи.
Объявление
Swift
func SRSpeechBusy(_recognizer: SRRecognizer) -> BooleanObjective C
Boolean SRSpeechBusy ( SRRecognizer recognizer );Параметры
recognizerУстройство распознавания.
Возвращаемое значение
По возврату,
trueесли символ обратной связи в окне обратной связи связался с устройством распознавания, указаннымrecognizerпараметр в настоящее время говорит; иначеfalse.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Завершает речь символом обратной связи в окне обратной связи.
Объявление
Swift
func SRStopSpeech(_recognizer: SRRecognizer) -> OSErrObjective C
OSErr SRStopSpeech ( SRRecognizer recognizer );Параметры
recognizerУстройство распознавания.
Возвращаемое значение
Код результата. Посмотрите менеджера по Распознаванию речи Коды Результата.
Обсуждение
SRStopSpeechфункция сразу завершает любой разговор символом обратной связи в окне обратной связи, связанном с устройством распознавания, указаннымrecognizerпараметр.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Создает новый универсальный указатель процедуры (UPP) к функции обратного вызова распознавания речи.
Объявление
Swift
func NewSRCallBackUPP(_userRoutine: SRCallBackProcPtr) -> SRCallBackUPPObjective C
SRCallBackUPP NewSRCallBackUPP ( SRCallBackProcPtr userRoutine );Параметры
userRoutineУказатель на Вашу функцию обратного вызова распознавания речи.
Возвращаемое значение
UPP к функции обратного вызова распознавания речи. См. описание
SRCallBackUPPтип данных.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Избавляется от универсального указателя процедуры (UPP) к функции обратного вызова распознавания речи.
Объявление
Swift
func DisposeSRCallBackUPP(_userUPP: SRCallBackUPP)Objective C
void DisposeSRCallBackUPP ( SRCallBackUPP userUPP );Параметры
userUPPUPP для избавления.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Вызывает Вашу функцию обратного вызова распознавания речи.
Объявление
Swift
func InvokeSRCallBackUPP(_param: UnsafeMutablePointer<SRCallBackStruct>, _userUPP: SRCallBackUPP)Objective C
void InvokeSRCallBackUPP ( SRCallBackStruct *param, SRCallBackUPP userUPP );Обсуждение
Вам не придется вызвать
InvokeSRCallbackUPPфункция, как системные вызовы Ваша функция обратного вызова распознавания речи для Вас.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Определяет указатель на функцию обратного вызова распознавания речи, которую вызывают каждый раз, когда устройство распознавания встречается с одним из событий, указанных в
kSRNotificationParamсвойство.Объявление
Swift
typealias SRCallBackProcPtr = CFunctionPointer<((UnsafeMutablePointer<SRCallBackStruct>) -> Void)>Objective C
typedef void (*SRCallBackProcPtr) ( SRCallBackStruct * param );Параметры
paramУказатель на структуру обратного вызова распознавания речи. Посмотрите
SRCallBackStructдля описания этой структуры.Обсуждение
Можно получить уведомление о событиях устройства распознавания или путем установки обработчика событий Apple или путем установки функции обратного вызова распознавания речи. В целом необходимо использовать обработчик событий Apple для обработки уведомлений распознавания. Необходимо использовать обратные вызовы только для исполняемого кода, который не может легко получить события Apple.
Можно определить то, какое событие заставило функцию быть вызванной путем проверки
whatполе структуры обратного вызова распознавания речи, указаннойparamпараметр.Поскольку менеджер по Распознаванию речи не полностью повторно используем, Вы не должны вызывать ни одну из его функций кроме
SRContinueRecognitionилиSRCancelRecognitionиз Вашего обратного вызова распознавания речи. Соответственно, Ваш обратный вызов должен просто поставить уведомление в очередь для дальнейшей обработки Вашим программным обеспечением (например, когда это получает время фоновой обработки).Если событие имеет тип
kSRNotifyRecognitionBeginning(который происходит, только если Вы запрашиваете начатые речью уведомления), необходимо вызвать такжеSRContinueRecognitionилиSRCancelRecognitionпрежде чем распознавание речи может продолжаться. Устройство распознавания, выпустившее уведомление распознавания, приостанавливает действие, пока Вы не вызываете одну из этих двух функций.В целом, когда Ваш обратный вызов распознавания речи получает
kSRNotifyRecognitionBeginningуведомление, это должно поставить индикацию в очередь для Вашего основного кода оба, чтобы скорректировать текущую языковую модель (если необходимый) и вызватьSRContinueRecognitionфункция. Когда Ваш обратный вызов получаетkSRNotifyRecognitionDoneуведомление, это должно поставить индикацию в очередь для Вашего основного кода для обработки результата распознавания, переданного вmessageполе структуры обратного вызова распознавания речи, указаннойparamпараметр. Необходимо удостовериться, однако, чтоmessageполе содержит действительную ссылку к результату распознавания путем проверкиstatusполе той структуры; еслиstatusсодержит любое значение кромеnoErr, содержаниеmessageполе не определено.Когда Ваш обратный вызов выполняется, Ваше приложение не является текущим процессом. В результате некоторые ограничения применяются; например, текущая цепочка ресурса не могла бы быть цепочкой Вашего приложения.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Определяет структуру параметра обратного вызова распознавания речи.
Объявление
Swift
struct SRCallBackParam { var callBack: SRCallBackUPP var refCon: SRefCon }Objective C
struct SRCallBackParam { SRCallBackUPP callBack; long refCon; }; typedef struct SRCallBackParam SRCallBackParam;Поля
callBackUPP для функции обратного вызова распознавания речи. Можно использовать функцию
NewSRCallBackUPPсоздать этот UPP.refConОпределенная с помощью приложения ссылочная константа. Это значение передается Вашей подпрограмме обратного вызова в
refconполе структуры обратного вызова распознавания речи. Можно передать любое 4-байтовое значение, которого Вы желаете.Обсуждение
Если Вы хотите получить уведомления распознавания с помощью подпрограммы обратного вызова распознавания речи вместо обработчика событий Apple, необходимо изменить значение
kSRCallBackParamсвойство текущего устройства распознавания. ЗначениеkSRCallBackParamсвойство является адресом структуры параметра функции обратного вызова, определеннойSRCallBackParamтип данных.Доступность
Доступный в OS X v10.0 и позже.
-
Определяет структуру, отправленную в Вашу функцию обратного вызова распознавания речи.
Объявление
Swift
struct SRCallBackStruct { var what: UInt32 var message: Int var instance: SRRecognizer var status: OSErr var flags: Int16 var refCon: SRefCon }Objective C
struct SRCallBackStruct { long what; long message; SRRecognizer instance; OSErr status; short flags; long refCon; }; typedef struct SRCallBackStruct SRCallBackStruct;Поля
whatФлаг уведомления, указывающий вид события, заставившего это уведомление быть выпущенным. Это поле содержит также
kSRNotifyRecognitionBeginningилиkSRNotifyRecognitionDone. Посмотрите Флаги Уведомления для полных подробных данных о доступных флагах уведомления.messageЕсли значение
statusполеnoErrи значениеwhatполеkSRNotifyRecognitionDone, это поле содержит ссылку на результат распознавания. Ваша подпрограмма обратного вызова может проверить свойства этого результата распознавания определить то, что сказал пользователь.Обратите внимание на то, что Ваша подпрограмма обратного вызова должна выпустить эту ссылку (путем вызова
SRReleaseObject) когда это закончено с помощью него. Если значениеstatusполе неnoErr, значение этого поля не определено.instanceСсылка на устройство распознавания, выпустившее это уведомление. Вы не должны вызывать
SRReleaseObjectна этой ссылке устройства распознавания в ответ на уведомление распознавания.statusКод ошибки, указывающий состояние распознавания. Если значение этого поля
noErr,messageполе содержит ссылку на результат распознавания. Если значение этого поляkSRRecognitionDoneи значениеwhatполеkSRNotifyRecognitionDone, устройство распознавания закончилось без ошибки, но ничто принадлежащее тому устройству распознавания не было распознано; в этом случае,messageполе не содержит ссылку на результат распознавания. Если значение этого поля является каким-либо другим значением, некоторая другая ошибка произошла.flagsЗарезервированный для использования Apple Computer, Inc.
refConОпределенная с помощью приложения ссылочная константа. Значение в этом поле является значением, которое Вы передали в
refconполе структуры параметра функции обратного вызова (типаSRCallBackParam).Обсуждение
Когда Вы получаете уведомление о результатах распознавания через определенную с помощью приложения функцию обратного вызова (вместо того, чтобы использовать обработчик событий Apple), менеджер по Распознаванию речи отправляет Вашей функции обратного вызова указатель на структуру обратного вызова распознавания речи, определенную
SRCallBackStructтип данных.Для получения информации о записи функции обратного вызова распознавания речи посмотрите
SRCallBackProcPtr.Доступность
Доступный в OS X v10.0 и позже.
-
Определяет универсальный указатель процедуры (UPP) к функции обратного вызова распознавания речи.
Объявление
Swift
typealias SRCallBackUPP = SRCallBackProcPtrObjective C
typedef SRCallBackProcPtr SRCallBackUPP;Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет языковую модель.
Объявление
Swift
typealias SRLanguageModel = SRLanguageObjectObjective C
typedef SRLanguageObject SRLanguageModel;Обсуждение
Языковая модель является списком нуля или большего количества слов, фраз или путей.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет объект языка.
Объявление
Swift
typealias SRLanguageObject = SRSpeechObjectObjective C
typedef SRSpeechObject SRLanguageObject;Обсуждение
Языковая модель создается с помощью четырех видов объектов, коллективно вызванных объектов языка: слова, фразы, пути и языковые модели.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет объект языка идентификация пути.
Обсуждение
Путь является последовательностью нуля или большего количества слов, фраз или языковых моделей.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет объект языка идентификация фразы.
Объявление
Swift
typealias SRPhrase = SRLanguageObjectObjective C
typedef SRLanguageObject SRPhrase;Обсуждение
Фраза является последовательностью нуля или большего количества слов.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет результат распознавания, содержащий информацию о распознанном произнесении.
Объявление
Swift
typealias SRRecognitionResult = SRSpeechSourceObjective C
typedef SRSpeechSource SRRecognitionResult;Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет речевой объект идентификация системы распознавания.
Объявление
Swift
typealias SRRecognitionSystem = SRSpeechObjectObjective C
typedef SRSpeechObject SRRecognitionSystem;Обсуждение
Речевой объект является экземпляром речевого класса, определяющего ряд свойств для объектов в классе. Поведение речевого объекта определяется набором свойств, связанных с классом объекта. Системам распознавания связали свойства с
SRRecognitionSystemкласс речевых объектов.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет речевой объект идентификация устройства распознавания речи.
Объявление
Swift
typealias SRRecognizer = SRSpeechObjectObjective C
typedef SRSpeechObject SRRecognizer;Обсуждение
Речевой объект является экземпляром речевого класса, определяющего ряд свойств для объектов в классе. Поведение речевого объекта определяется набором свойств, связанных с классом объекта. Устройствам распознавания речи связали свойства с
SRRecognizerкласс речевых объектов.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Объявление
Swift
typealias SRRejectionLevel = UInt16Objective C
typedef SRRejectionLevel;Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Определяет ссылку на речевой объект.
Объявление
Swift
typealias SRSpeechObject = COpaquePointerObjective C
typedef struct OpaqueSRSpeechObject * SRSpeechObject;Обсуждение
Менеджер по Распознаванию речи объектно-ориентирован в том смысле, что ко многим его возможностям получают доступ путем создания и управления речевыми объектами. Речевой объект является экземпляром речевого класса, определяющего ряд свойств для объектов в классе. Поведение речевого объекта определяется набором свойств, связанных с классом объекта.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет речевой объект идентификация речевого источника.
Объявление
Swift
typealias SRSpeechSource = SRSpeechObjectObjective C
typedef SRSpeechObject SRSpeechSource;Обсуждение
Речевой объект является экземпляром речевого класса, определяющего ряд свойств для объектов в классе. Поведение речевого объекта определяется набором свойств, связанных с классом объекта. Речевым источникам связали свойства с
SRSpeechSourceкласс речевых объектов.Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Объявление
Swift
typealias SRSpeedSetting = UInt16Objective C
typedef SRSpeedSetting;Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Представляет объект языка идентификация слова.
Обсуждение
Слово представляет единственное speakable слово.
Оператор импорта
Objective C
@import Carbon;Swift
import CarbonДоступность
Доступный в OS X v10.0 и позже.
-
Идентифицируйте обратную связь и режимы слушания системы распознавания.
Объявление
Swift
var kSRNoFeedbackNoListenModes: Int { get } var kSRHasFeedbackHasListenModes: Int { get } var kSRNoFeedbackHasListenModes: Int { get }Objective C
enum { kSRNoFeedbackNoListenModes = 0, kSRHasFeedbackHasListenModes = 1, kSRNoFeedbackHasListenModes = 2 };Константы
-
kSRNoFeedbackNoListenModeskSRNoFeedbackNoListenModesЕсли значение режимов обратной связи и слушания системы распознавания установлено в
kSRNoFeedbackNoListenModes, следующее создаваемое устройство распознавания не имеет никакого окна обратной связи и не использует режимы слушания, выбранные пользователем в Речевой панели управления. (Например, услуга «Нажми и говори» является режимом слушания.)Доступный в OS X v10.0 и позже.
-
kSRHasFeedbackHasListenModeskSRHasFeedbackHasListenModesЕсли значение режимов обратной связи и слушания системы распознавания установлено в
kSRHasFeedbackHasListenModes, следующее создаваемое устройство распознавания открывает окно обратной связи, использующее режимы слушания, выбранные пользователем в Речевой панели управления.Доступный в OS X v10.0 и позже.
-
kSRNoFeedbackHasListenModeskSRNoFeedbackHasListenModesЕсли значение режимов обратной связи и слушания системы распознавания установлено в
kSRNoFeedbackHasListenModes, следующее создаваемое устройство распознавания не имеет никакого окна обратной связи, но действительно использует режимы слушания, выбранные пользователем в Речевой панели управления.Доступный в OS X v10.0 и позже.
-
-
Определите селекторы, которые можно использовать для обработки уведомлений распознавания в обработчике событий Apple.
Объявление
Swift
var kAESpeechDone: Int { get } var kAESpeechDetected: Int { get } var kAESpeechSuite: Int { get } var keySRRecognizer: Int { get } var keySRSpeechResult: Int { get } var keySRSpeechStatus: Int { get } var typeSRRecognizer: Int { get } var typeSRSpeechResult: Int { get }Objective C
enum { kAESpeechDone = 'srsd', kAESpeechDetected = 'srbd' }; enum { kAESpeechSuite = 'sprc' }; enum { keySRRecognizer = 'krec', keySRSpeechResult = 'kspr', keySRSpeechStatus = 'ksst' }; enum { typeSRRecognizer = 'trec', typeSRSpeechResult = 'tspr' };Константы
-
kAESpeechDonekAESpeechDoneИдентификатор сообщения для сделанного речью события.
Доступный в OS X v10.0 и позже.
-
kAESpeechDetectedkAESpeechDetectedИдентификатор сообщения для обнаруженного речью события.
Доступный в OS X v10.0 и позже.
-
kAESpeechSuitekAESpeechSuiteКомплект события Apple для событий распознавания речи.
Доступный в OS X v10.0 и позже.
-
keySRRecognizerkeySRRecognizerID для параметра устройства распознавания.
Доступный в OS X v10.0 и позже.
-
keySRSpeechResultkeySRSpeechResultID для параметра результата распознавания.
Доступный в OS X v10.0 и позже.
-
keySRSpeechStatuskeySRSpeechStatusID для речевого параметра состояния, имеющего тип
typeSInt16.Доступный в OS X v10.0 и позже.
-
typeSRRecognizertypeSRRecognizerТип для параметра устройства распознавания.
Доступный в OS X v10.0 и позже.
-
typeSRSpeechResulttypeSRSpeechResultТип для параметра результата распознавания.
Доступный в OS X v10.0 и позже.
-
-
Представляет уровень отклонения по умолчанию.
Объявление
Swift
var kSRDefaultRejectionLevel: Int { get }Objective C
enum { kSRDefaultRejectionLevel = 50 };Константы
-
Определите селекторы свойства для объектов языка.
Объявление
Swift
var kSRSpelling: Int { get } var kSRLMObjType: Int { get } var kSRRefCon: Int { get } var kSROptional: Int { get } var kSREnabled: Int { get } var kSRRepeatable: Int { get } var kSRRejectable: Int { get } var kSRRejectionLevel: Int { get }Objective C
enum { kSRSpelling = 'spel', kSRLMObjType = 'lmtp', kSRRefCon = 'refc', kSROptional = 'optl', kSREnabled = 'enbl', kSRRepeatable = 'rptb', kSRRejectable = 'rjbl', kSRRejectionLevel = 'rjct' };Константы
-
kSRSpellingkSRSpellingНаписание объекта языка. Значение этого свойства является строкой переменной длины символов. Для объекта типа
SRWord, значение является произнесенным словом по буквам. Для объекта типаSRPhrase, значение является связью написаний каждого слова во фразе, разделенной языковозависимым разделительным символом (например, пробелом). Для объекта типаSRPath, значение является связью написаний каждого слова и имени языковой модели по пути. Для объекта типаSRLanguageModel, значение является именем языковой модели. Для любого объекта строковое значение не включает ни одного байт длины (как в строках Паскаля) или нулевой оконечный знак (как в струнах до).Доступный в OS X v10.0 и позже.
-
kSRLMObjTypekSRLMObjTypeТип объекта языка. Значение этого свойства является четырьмя символьными константами типа
OSType; посмотрите раздел Language Object Types для значений, определяющихся для этого свойства. Вы не можете установить свойство этого типа.Доступный в OS X v10.0 и позже.
-
kSRRefConkSRRefConСсылочная константа. Значение этого свойства является 4-байтовым значением, указанным Вашим приложением. По умолчанию значение ссылочного постоянного свойства является нулем (0).
Доступный в OS X v10.0 и позже.
-
kSROptionalkSROptionalДополнительный флаг. Значение этого свойства является булевым значением, указывающим, являются ли, произнося слова, фразы, пути и языковые модели, представленные объектом, дополнительными (
TRUE) или требуемый (FALSE). Пользователь не обязан произносить дополнительные слова, фразы или языковые модели. По умолчанию значение дополнительного флага объектаFALSE.Доступный в OS X v10.0 и позже.
-
kSREnabledkSREnabledВключенный флаг. Значение этого свойства является булевым значением, указывающим, включен ли объект (
TRUE) или отключенный (FALSE). Отключенные объекты проигнорированы во время распознавания речи. По умолчанию значение включенного флага объектаTRUE.Доступный в OS X v10.0 и позже.
-
kSRRepeatablekSRRepeatableПовторимый флаг. Значение этого свойства является булевым значением, указывающим, повторим ли объект (
TRUE) или не (FALSE). Пользователь может произнести повторяющийся объект несколько раз. По умолчанию значение повторимого флага объектаFALSE.Доступный в OS X v10.0 и позже.
-
kSRRejectablekSRRejectableОтклоняемый флаг. Значение этого свойства является булевым значением, указывающим, отклоняем ли объект (
TRUE) или не (FALSE). Если система распознавания может возвратить отклоненное слово вместо того объекта, объект отклоняем. (Отклоненное слово является значениемkSRRejectedWordсвойство системы распознавания.) По умолчанию значение отклоняемого флага объектаFALSE. Однако, если все произнесение отклоняется, можно все еще получить отклоненное слово. Посмотрите Свойства Результата Распознавания.Доступный в OS X v10.0 и позже.
-
kSRRejectionLevelkSRRejectionLevelУровень отклонения. Значение этого свойства является 2-байтовым целым без знака типа
SRRejectionLevelмежду 0 и 100, включительно, который определяет, как, вероятно, устройство распознавания должно отклонить объект языка чейkSRRejectableсвойствоTRUE. Если уровень отклонения объекта будет близко к 0, то устройство распознавания, менее вероятно, отклонит произнесение (и следовательно более вероятно возвратить результат с фразами от текущей языковой модели, сказал ли пользователь фактически что-то в той языковой модели), если уровень отклонения объекта близко к 100, устройство распознавания, более вероятно, отклонит произнесение. Можно установить флаг отклонения объекта вTRUEи его уровень отклонения к некоторому надлежащему значению для сокращения вероятности, что устройство распознавания по ошибке распознает случайное пользовательское произнесение как часть активной языковой модели. По умолчанию значение уровня отклонения объекта50.Доступный в OS X v10.0 и позже.
Обсуждение
Каждый объект языка (т.е. любой экземпляр подкласса
SRLanguageObjectкласс), имеет ряд свойств, которые можно проверить и изменить путем вызоваSRGetPropertyиSRSetPropertyфункции. Вы указываете свойство путем передачи селектора свойства тем функциям. -
-
Идентифицируйте четыре подкласса
SRLanguageObjectкласс.Объявление
Swift
var kSRLanguageModelType: Int { get } var kSRPathType: Int { get } var kSRPhraseType: Int { get } var kSRWordType: Int { get }Objective C
enum { kSRLanguageModelType = 'lmob', kSRPathType = 'path', kSRPhraseType = 'phra', kSRWordType = 'word' };Константы
-
kSRLanguageModelTypekSRLanguageModelTypeЯзыковая модель (т.е. объект типа
SRLanguageModel).Доступный в OS X v10.0 и позже.
-
kSRPathTypekSRPathTypeПуть (т.е. объект типа
SRPath).Доступный в OS X v10.0 и позже.
-
kSRPhraseTypekSRPhraseTypeФраза (т.е. объект типа
SRPhrase).Доступный в OS X v10.0 и позже.
-
kSRWordTypekSRWordTypeСлово (т.е. объект типа
SRWord).Доступный в OS X v10.0 и позже.
Обсуждение
Можно использовать эти константы, например, чтобы помочь интерпретировать значение объекта языка
kSRLMObjTypeсвойство. -
-
Идентифицируйте слушают ключевые режимы.
Объявление
Objective C
enum { kSRUseToggleListen = 0, kSRUsePushToTalk = 1 };Константы
-
kSRUseToggleListenkSRUseToggleListenУстройство распознавания интерпретирует нажатия на слушать ключе как переключатель для включения или выключения слушания.
Доступный в OS X v10.0 и позже.
-
kSRUsePushToTalkkSRUsePushToTalkУстройство распознавания слушает только, когда удерживается слушать ключ.
Доступный в OS X v10.0 и позже.
Обсуждение
Можно получить (но не установить), устройство распознавания слушает ключевой режим путем доступа к его свойству типа
kSRListenKeyMode. Значение того свойства является 2-байтовым целым без знака, определяющим, работает ли слушать ключ в услуге «Нажми и говори» или слушающем переключатель режиме. -
-
Идентифицируйте события устройства распознавания, которые могут быть отправлены в приложение.
Объявление
Objective C
enum { kSRNotifyRecognitionBeginning = 1L << 0, kSRNotifyRecognitionDone = 1L << 1 };Константы
-
kSRNotifyRecognitionBeginningkSRNotifyRecognitionBeginningЕсли этот бит будет установлен, то Ваше приложение будет уведомлено, когда пользователь начнет говорить, и распознавание готово начаться. Когда Ваше приложение получает это уведомление, оно должно вызвать также
SRContinueRecognitionилиSRCancelRecognitionдля распознавания или чтобы продолжаться или быть отмененными. Если Вы не вызовете одну из этих функций, то устройство распознавания будет просто ожидать, пока Вы не сделаете (и следовательно, кажись, вышли из работы). Обратите внимание на то, что вызовSRCancelRecognitionотменяет распознавание только для приложения, запросившего его, не для всех приложений.Доступный в OS X v10.0 и позже.
-
kSRNotifyRecognitionDonekSRNotifyRecognitionDoneЕсли этот бит будет установлен, то Ваше приложение будет уведомлено, когда распознавание будет закончено, и результат (если таковые имеются) того распознавания доступен.
Доступный в OS X v10.0 и позже.
Обсуждение
Можно указать, относительно каких событий устройства распознавания Вы хотите свое приложение быть к уведомленному из путем установки свойства уведомления устройства распознавания, которое является свойством типа
kSRNotificationParam. Значение того свойства является 4-байтовым целым без знака. Менеджер по Распознаванию речи определяет эти маски для битов в том значении. -
-
Идентифицируйте селекторы свойства для результатов распознавания.
Объявление
Swift
var kSRTEXTFormat: Int { get } var kSRPhraseFormat: Int { get } var kSRPathFormat: Int { get } var kSRLanguageModelFormat: Int { get }Objective C
enum { kSRTEXTFormat = 'TEXT', kSRPhraseFormat = 'lmph', kSRPathFormat = 'lmpt', kSRLanguageModelFormat = 'lmfm' };Константы
-
kSRTEXTFormatkSRTEXTFormatТекстовый формат. Значение этого свойства является строкой переменной длины символов, которая является текстом распознанного произнесения. Если произнесение было отклонено, этот текст является написанием отклоненного слова. Строковое значение не включает ни одного байт длины (как в строках Паскаля) или нулевой оконечный знак (как в струнах до).
Доступный в OS X v10.0 и позже.
-
kSRPhraseFormatkSRPhraseFormatФормат фразы. Значение этого свойства является фразой, содержащей одно слово (типа
SRWord) для каждого слова в распознанном произнесении. Если произнесение было отклонено, этот путь или фраза содержат один объект, отклоненное слово. Ссылочное постоянное значение фразы всегда 0, но каждое слово во фразе сохраняет свое собственное ссылочное постоянное значение свойства.Доступный в OS X v10.0 и позже.
-
kSRPathFormatkSRPathFormatФормат пути. Значение этого свойства является путем, содержащим последовательность слов (типа
SRWord) и фразы (типаSRPhrase) представление текста распознанного произнесения. Если произнесение было отклонено, этот путь или фраза содержат один объект, отклоненное слово. Ссылочное постоянное значение пути всегда 0, но каждое слово или фраза по пути сохраняют свое собственное ссылочное постоянное значение свойства.Доступный в OS X v10.0 и позже.
-
kSRLanguageModelFormatkSRLanguageModelFormatФормат языковой модели. Значение этого свойства является языковой моделью, содержащей копию каждого слова, фразы, пути и языковой модели, используемой в распознанном произнесении. Если произнесение было отклонено, значение этого свойства является отклоненным словом (т.е.
kSRRejectedWordсвойство системы распознавания). Имя и ссылочная константа этой языковой модели совпадают с именем и ссылочной константой активной языковой модели, и каждый подэлемент в языковой модели сохраняет свое собственное ссылочное постоянное значение свойства.Доступный в OS X v10.0 и позже.
Обсуждение
Каждый объект результата распознавания имеет ряд свойств, которые можно проверить путем вызова
SRGetPropertyфункция. Вы указываете свойство путем передачи селектора свойства тем функциям.SRGetPropertyвозвращает ссылку на объект как значение результата распознаванияkSRPhraseFormat,kSRPathFormat, илиkSRLanguageModelFormatсвойство. Необходимо удостовериться, что выпустили ту ссылку на объект (путем вызоваSRReleaseObject) когда Вы закончены с помощью него. -
-
Определяет систему распознавания ID.
Объявление
Swift
var kSRDefaultRecognitionSystemID: Int { get }Objective C
enum { kSRDefaultRecognitionSystemID = 0 };Константы
-
kSRDefaultRecognitionSystemIDkSRDefaultRecognitionSystemIDСистема распознавания речи по умолчанию.
Доступный в OS X v10.0 и позже.
Обсуждение
Когда Вы вызываете
SROpenRecognitionSystemдля открытия системы распознавания Вы указываете систему для открытия путем передачи системы распознавания ID. -
-
Определите селекторы свойства для систем распознавания.
Объявление
Swift
var kSRFeedbackAndListeningModes: Int { get } var kSRRejectedWord: Int { get } var kSRCleanupOnClientExit: Int { get }Objective C
enum { kSRFeedbackAndListeningModes = 'fbwn', kSRRejectedWord = 'rejq', kSRCleanupOnClientExit = 'clup' };Константы
-
kSRFeedbackAndListeningModeskSRFeedbackAndListeningModesОбратная связь и режимы слушания системы распознавания. Значение этого свойства является целым числом, определяющим некоторые функции устройства распознавания, впоследствии создаваемого Вашим приложением. Посмотрите Режимы Обратной связи и Слушания для описания значений, возможных здесь.
Значение по умолчанию для версии 1.5
kSRNoFeedbackNoListenModes, но большинство приложений должно установить это вkSRHasFeedbackHasListenModes.Доступный в OS X v10.0 и позже.
-
kSRRejectedWordkSRRejectedWordОтклоненное слово системы распознавания. Значение этого свойства является значением типа
SRWordкогда устройство распознавания встретится с неузнаваемым произнесением, это будет возвращено в объекте результата распознавания. Например, если произнесение отклоняется,kSRLMObjTypeсвойство результата отклонения является отклоненным словом. По умолчанию отклоненное слово по буквам системы распознавания произнесено “???” и имеет ссылочную константу 0.Доступный в OS X v10.0 и позже.
-
kSRCleanupOnClientExitkSRCleanupOnClientExitРежим очистки системы распознавания. Приложения никогда не должны устанавливать это свойство. Если, однако, у Вас нет процесса ID (как выпущено Диспетчером процессов), необходимо установить это свойство в
FALSEтак, чтобы речь возразила, что Вы выделяете, не будет связан ни с каким другим процессом. По умолчанию значение режима очистки системы распознаванияTRUE.Доступный в OS X v10.0 и позже.
Обсуждение
Система распознавания (т.е. экземпляр
SRRecognitionSystemкласс), имеет ряд свойств, которые можно проверить и изменить путем вызоваSRGetPropertyиSRSetPropertyфункции. Вы указываете свойство путем передачи селектора свойства тем функциям. -
-
Определите слушают ключевые селекторы свойства для устройств распознавания.
Объявление
Swift
var kSRListenKeyMode: Int { get } var kSRListenKeyCombo: Int { get } var kSRListenKeyName: Int { get } var kSRKeyWord: Int { get } var kSRKeyExpected: Int { get }Objective C
enum { kSRListenKeyMode = 'lkmd', kSRListenKeyCombo = 'lkey', kSRListenKeyName = 'lnam', kSRKeyWord = 'kwrd', kSRKeyExpected = 'kexp' };Константы
-
kSRListenKeyModekSRListenKeyModeСлушать ключевой режим. Значение этого свойства является 2-байтовым целым без знака, указывающим, работает ли слушать ключ в услуге «Нажми и говори» или слушающем переключатель режиме. Посмотрите Слушают, Ключевые Режимы для описания доступного слушают ключевые режимы. Значение устройства распознавания слушает, ключевой режим - то, что пользователь выбрал в Речевой панели управления. Это свойство только для чтения, Вы не можете установить свойство этого типа.
Доступный в OS X v10.0 и позже.
-
kSRListenKeyCombokSRListenKeyComboСлушать свойство сочетания клавиш. Значение этого свойства является 2-байтовым целым без знака, указывающим сочетание клавиш, которое пользователь должен нажать для слушать ключа. Старший байт этого значения имеет тот же формат как старший байт
modifiersполе записи события. Байт младшего разряда этого значения имеет тот же формат как код клавиши, содержавшийся вmessageполе записи события. Значение устройства распознавания слушает, свойство сочетания клавиш - то, что пользователь выбрал в Речевой панели управления. Это свойство только для чтения, Вы не можете установить свойство этого типа.Доступный в OS X v10.0 и позже.
-
kSRListenKeyNamekSRListenKeyNameСлушать ключевое свойство имени. Значение этого свойства является строкой (типа
Str63) это представляет слушать сочетание клавиш, указанноеkSRListenKeyComboсвойство. Значение устройства распознавания слушает, ключевое свойство имени - то, что пользователь выбрал в Речевой панели управления. Это свойство только для чтения, Вы не можете установить свойство этого типа.Доступный в OS X v10.0 и позже.
-
kSRKeyWordkSRKeyWordСвойство ключевого слова. Значение этого свойства является строкой (типа
Str255) это представляет ключевое слово, которое должно предшествовать произнесению, когда устройство распознавания находится в режиме прослушивания переключателя. Значение свойства ключевого слова устройства распознавания - то, что пользователь выбрал в Речевой панели управления. Это свойство только для чтения, Вы не можете установить свойство этого типа.Доступный в OS X v10.0 и позже.
-
kSRKeyExpectedkSRKeyExpectedКлюч ожидал флаг. Значение этого свойства является булевым значением, указывающим, ожидает ли устройство распознавания, что пользователь удержит клавишу или произнесет ключевое слово, для имения устройства распознавания, начинают слушать (
TRUE) или не (FALSE). Значение ключа устройства распознавания ожидало, что флаг является функцией Речевых выборов панели управления пользователя. Это свойствоTRUEкаждый раз, когда текст видим ниже символа обратной связи в нижнем левом углу окна обратной связи. Это свойство только для чтения.Доступный в OS X v10.0 и позже.
Обсуждение
Каждое устройство распознавания имеет ряд свойств, которые можно проверить и изменить путем вызова
SRGetPropertyиSRSetPropertyфункции. Вы указываете свойство путем передачи селектора свойства тем функциям.Слушать ключевые свойства предоставлены для использования приложениями, хотящими обеспечить их собственную визуальную обратную связь. Если Ваше приложение использует механизмы обратной связи по умолчанию, Вы не должны получать доступ к тем свойствам.
-
-
Определите селекторы свойства для устройств распознавания.
Объявление
Swift
var kSRNotificationParam: Int { get } var kSRCallBackParam: Int { get } var kSRSearchStatusParam: Int { get } var kSRAutoFinishingParam: Int { get } var kSRForegroundOnly: Int { get } var kSRBlockBackground: Int { get } var kSRBlockModally: Int { get } var kSRWantsResultTextDrawn: Int { get } var kSRWantsAutoFBGestures: Int { get } var kSRSoundInVolume: Int { get } var kSRReadAudioFSSpec: Int { get } var kSRCancelOnSoundOut: Int { get } var kSRSpeedVsAccuracyParam: Int { get }Objective C
enum { kSRNotificationParam = 'noti', kSRCallBackParam = 'call', kSRSearchStatusParam = 'stat', kSRAutoFinishingParam = 'afin', kSRForegroundOnly = 'fgon', kSRBlockBackground = 'blbg', kSRBlockModally = 'blmd', kSRWantsResultTextDrawn = 'txfb', kSRWantsAutoFBGestures = 'dfbr', kSRSoundInVolume = 'volu', kSRReadAudioFSSpec = 'aurd', kSRCancelOnSoundOut = 'caso', kSRSpeedVsAccuracyParam = 'sped' };Константы
-
kSRNotificationParamkSRNotificationParamСвойство уведомления. Значение этого свойства является 4-байтовым целым без знака, биты которого кодируют виды событий, относительно которых устройство распознавания уведомит Ваше приложение. Посмотрите раздел Notification Flags для битовых масок, определяющихся для этого свойства. По умолчанию значение свойства уведомления устройства распознавания
kSRNotifyRecognitionDone.Доступный в OS X v10.0 и позже.
-
kSRCallBackParamkSRCallBackParamСвойство обратного вызова. Значение этого свойства имеет тип
SRCallBackParamэто определяет, отправляются ли уведомления распознавания в Ваше приложение через события Apple или через определенную с помощью приложения подпрограмму обратного вызова. Для указания подпрограммы обратного вызова установите значение этого свойства к адресу структуры параметра подпрограммы обратного вызова. По умолчанию значение свойства обратного вызова устройства распознаванияNULL, указание, что события Apple должны использоваться для создания отчетов о событиях устройства распознавания.Доступный в OS X v10.0 и позже.
-
kSRSearchStatusParamkSRSearchStatusParamПоисковое состояние. Значение этого свойства является 4-байтовым целым без знака, биты которого указывают текущее состояние устройства распознавания. Посмотрите раздел Search Status Flags для битовых масок, определяющихся для этого свойства. Это свойство только для чтения; Вы не можете установить свойство этого типа.
Доступный в OS X v10.0 и позже.
-
kSRAutoFinishingParamkSRAutoFinishingParamАвтозаканчивающийся параметр.
Доступный в OS X v10.0 и позже.
-
kSRForegroundOnlykSRForegroundOnlyФлаг только для переднего плана. Значение этого свойства является булевым значением, указывающим, включено ли устройство распознавания только, когда Ваше приложение является приоритетным приложением (
TRUE) или не (FALSE). По умолчанию значение флага устройства распознавания только для переднего планаTRUE.Доступный в OS X v10.0 и позже.
-
kSRBlockBackgroundkSRBlockBackgroundБлокирующий фон флаг. Значение этого свойства является булевым значением, указывающим, отключены ли все устройства распознавания, принадлежавшие другим приложениям автоматически, каждый раз, когда Ваше приложение является приоритетным приложением (
TRUE) или автоматически не отключены (FALSE). По умолчанию значение блокирующего фон флага устройства распознаванияFALSE.Доступный в OS X v10.0 и позже.
-
kSRBlockModallykSRBlockModallyМодально блокирующий флаг. Значение этого свойства является булевым значением, указывающим, является ли языковая модель, связанная с этим устройством распознавания, единственной активной языковой моделью (
TRUE) или не (FALSE). Когда этот флагTRUE, устройство распознавания Вашего приложения блокирует те из других приложений, даже когда это не приоритетное приложение, кроме того, окно обратной связи скрыто, если Вы не используете его. Установка этого свойства кTRUEпрепятствует тому, чтобы распознавание речи работало на другие приложения, таким образом, Вы хотите использовать это свойство, только если Ваше приложение занимает компьютер (как некоторые игры) или кратко пытается ограничить языковую модель сильно. По умолчанию значение модально блокирующего флага устройства распознаванияFALSE.Доступный в OS X v10.0 и позже.
-
kSRWantsResultTextDrawnkSRWantsResultTextDrawnТекстовый флаг обратной связи. Значение этого свойства является булевым значением, указывающим, состоят ли результаты поиска в том, чтобы быть автоматически выведены на экран как текст в окне обратной связи (
TRUE) или не (FALSE). Если Вы устанавливаете значение этого свойства кFALSE, необходимо вызватьSRDrawRecognizedTextсо строковым представлением, что сказал пользователь. По умолчанию значение текстового флага обратной связи устройства распознаванияTRUE.Доступный в OS X v10.0 и позже.
-
kSRWantsAutoFBGestureskSRWantsAutoFBGesturesАвтоматический флаг жестов обратной связи. Значение этого свойства является булевым значением, определяющим, нарисованы ли жесты обратной связи автоматически (
TRUE) или не (FALSE). Если Вы хотите больше управления поведением обратной связи, необходимо установить это свойство вFALSE; тогда вызовитеSRProcessBeginкогда Вы хотите начать отвечать на разговорный запрос иSRProcessEndкогда Вы закончены. В течение того времени, символьные дисплеи обратной связи надлежащие анимированные жесты, чтобы указать, что это занято, выполняя задачу. По умолчанию значение автоматического флага жестов обратной связи устройства распознаванияTRUE.Доступный в OS X v10.0 и позже.
-
kSRSoundInVolumekSRSoundInVolumeЗвуковой входной объем. Значение этого свойства является 2-байтовым целым без знака между 0 и 100, включительно, который указывает текущий звуковой входной объем. Это свойство только для чтения; Вы не можете установить свойство этого типа.
Доступный в OS X v10.0 и позже.
-
kSRReadAudioFSSpeckSRReadAudioFSSpecСвойство аудиофайла. Можно использовать это свойство для выполнения распознавания речи от аудиофайла. Значение этого свойства является указателем на спецификацию файловой системы (структура типа
FSSpec). Спецификация файловой системы указывает файл AIFF, содержащий необработанные аудиоданные (16-разрядные аудиоданные, выбранные в 22,050 кГц). После создания нового устройства распознавания с помощью речевого источника IDkSRCanned22kHzSpeechSource, необходимо установить это свойство устройства распознавания для выполнения распознавания от аудиофайла. Установка источника аудиосигналов к файлу также позволяет менеджеру по Распознаванию речи обрабатывать звуковые данные в системное фоновое время, а не во время прерывания или задержанное время задачи.Доступный в OS X v10.0 и позже.
-
kSRCancelOnSoundOutkSRCancelOnSoundOutОтмена во время флага звукового вывода. Значение этого свойства является булевым значением, указывающим, отменяется ли распознавание речи каждый раз, когда любой звук выводится компьютером во время произнесения (
TRUE) или ли распознавание речи продолжается (FALSE). По умолчанию значение отмены устройства распознавания во время флага звукового выводаTRUE.Доступный в OS X v10.0 и позже.
-
kSRSpeedVsAccuracyParamkSRSpeedVsAccuracyParamСкорость по сравнению с параметром точности.
Доступный в OS X v10.0 и позже.
Обсуждение
Каждое устройство распознавания имеет ряд свойств, которые можно проверить и изменить путем вызова
SRGetPropertyиSRSetPropertyфункции. Вы указываете свойство путем передачи селектора свойства тем функциям. -
-
Укажите состояние поиска устройства распознавания.
Объявление
Swift
var kSRIdleRecognizer: Int { get } var kSRSearchInProgress: Int { get } var kSRSearchWaitForAllClients: Int { get } var kSRMustCancelSearch: Int { get } var kSRPendingSearch: Int { get }Objective C
enum { kSRIdleRecognizer = 1L << 0, kSRSearchInProgress = 1L << 1, kSRSearchWaitForAllClients = 1L << 2, kSRMustCancelSearch = 1L << 3, kSRPendingSearch = 1L << 4 };Константы
-
kSRIdleRecognizerkSRIdleRecognizerЕсли этот бит установлен, поисковая система не активна, и пользователь в состоянии сделать новое произнесение.
Доступный в OS X v10.0 и позже.
-
kSRSearchInProgresskSRSearchInProgressЕсли этот бит установлен, поиск в настоящее время происходит.
Доступный в OS X v10.0 и позже.
-
kSRSearchWaitForAllClientskSRSearchWaitForAllClientsЕсли этот бит установлен, поиск не в настоящее время происходит, но начнется, как только каждое устройство распознавания с помощью речевого источника, используемого этим устройством распознавания, вызвало
SRContinueRecognitionуказать, что должен начаться поиск.Доступный в OS X v10.0 и позже.
-
kSRMustCancelSearchkSRMustCancelSearchЕсли этот бит установлен, поиск собирается, отменяются (например, потому что устройство распознавания определило звук, чтобы быть неречью).
Доступный в OS X v10.0 и позже.
-
kSRPendingSearchkSRPendingSearchЕсли этот бит установлен, поиск собирается начаться.
Доступный в OS X v10.0 и позже.
Обсуждение
Можно определить текущий статус поиска устройства распознавания путем получения поискового состояния устройства распознавания, которое является свойством типа
kSRSearchStatusParam. Значение того свойства является 4-байтовым целым без знака. Менеджер по Распознаванию речи определяет эти маски для битов в том значении. -
-
Идентифицируйте Распознавание речи поддерживаемые менеджерами речевые источники.
Объявление
Swift
var kSRDefaultSpeechSource: Int { get } var kSRLiveDesktopSpeechSource: Int { get } var kSRCanned22kHzSpeechSource: Int { get }Objective C
enum { kSRDefaultSpeechSource = 0, kSRLiveDesktopSpeechSource = 'dklv', kSRCanned22kHzSpeechSource = 'ca22' };Константы
-
kSRDefaultSpeechSourcekSRDefaultSpeechSourceРечевой источник по умолчанию.
Доступный в OS X v10.0 и позже.
-
kSRLiveDesktopSpeechSourcekSRLiveDesktopSpeechSourceЖивой настольный звуковой ввод.
Доступный в OS X v10.0 и позже.
-
kSRCanned22kHzSpeechSourcekSRCanned22kHzSpeechSourceФайл AIFF базировал 16 битов, 22,050 кГц звучат введенными.
Доступный в OS X v10.0 и позже.
Обсуждение
Менеджер по Распознаванию речи поддерживает несколько речевых источников, которые можно указать использование этих констант. В версии 1.5 речевой источник по умолчанию
kSRLiveDesktopSpeechSource. -
Наиболее распространенные коды результата, возвращенные менеджером по Распознаванию речи, упоминаются ниже.
-
Требуемая служба, не доступная или применимая
Значение
- 5100
Описание
Требуемая служба, не доступная или применимая
Доступный в OS X v10.0 и позже.
-
Внутренняя система или условие аппаратной ошибки
Значение
- 5101
Описание
Внутренняя система или условие аппаратной ошибки
Доступный в OS X v10.0 и позже.
-
Требуемый компонент не может быть расположен
Значение
- 5102
Описание
Требуемый компонент не может быть расположен
Доступный в OS X v10.0 и позже.
-
Недостаточно доступной памяти
Значение
- 5103
Описание
Недостаточно доступной памяти
Доступный в OS X v10.0 и позже.
-
Объект не допустим
Значение
- 5104
Описание
Объект не допустим
Доступный в OS X v10.0 и позже.
-
Недопустимый параметр указан
Значение
- 5105
Описание
Недопустимый параметр указан
Доступный в OS X v10.0 и позже.
-
Параметр вне допустимого диапазона
Значение
- 5106
Описание
Параметр вне допустимого диапазона
Доступный в OS X v10.0 и позже.
-
Нераспознанный селектор указан
Значение
- 5107
Описание
Нераспознанный селектор указан
Доступный в OS X v10.0 и позже.
-
Буфер является слишком маленьким
Значение
- 5108
Описание
Буфер является слишком маленьким
Доступный в OS X v10.0 и позже.
-
Указанный объект не является системой распознавания
Значение
- 5109
Описание
Указанный объект не является системой распознавания
Доступный в OS X v10.0 и позже.
-
Никакое окно обратной связи не связалось с устройством распознавания
Значение
- 5110
Описание
Никакое окно обратной связи не связалось с устройством распознавания
Доступный в OS X v10.0 и позже.
-
Не может установить указанное свойство
Значение
- 5111
Описание
Не может установить указанное свойство
Доступный в OS X v10.0 и позже.
-
Не может получить указанное свойство
Значение
- 5112
Описание
Не может получить указанное свойство
Доступный в OS X v10.0 и позже.
-
Не может установить свойство во время распознавания
Значение
- 5113
Описание
Не может установить свойство во время распознавания
Доступный в OS X v10.0 и позже.
-
Система уже слушает
Значение
- 5114
Описание
Система уже слушает
Доступный в OS X v10.0 и позже.
-
Система не слушает
Значение
- 5115
Описание
Система не слушает
Доступный в OS X v10.0 и позже.
-
Никакие акустические модели, доступные для соответствия запроса
Значение
- 5116
Описание
Никакие акустические модели, доступные для соответствия запроса
Доступный в OS X v10.0 и позже.
-
Не может получить доступ к указанной языковой модели
Значение
- 5117
Описание
Не может получить доступ к указанной языковой модели
Доступный в OS X v10.0 и позже.
-
Никакое произнесение для поиска
Значение
- 5118
Описание
Никакое произнесение для поиска
Доступный в OS X v10.0 и позже.
-
Поиск был отменен
Значение
- 5119
Описание
Поиск был отменен
Доступный в OS X v10.0 и позже.
-
Поиск закончился, но ничто не было распознано
Значение
- 5120
Описание
Поиск закончился, но ничто не было распознано
Доступный в OS X v10.0 и позже.
-
Другое устройство распознавания уже работает модально
Значение
- 5121
Описание
Другое устройство распознавания уже работает модально
Доступный в OS X v10.0 и позже.
-
Указанный объект не имеет никаких подэлементов
Значение
- 5122
Описание
Указанный объект не имеет никаких подэлементов
Доступный в OS X v10.0 и позже.
-
Указанный подэлемент не может быть расположен
Значение
- 5123
Описание
Указанный подэлемент не может быть расположен
Доступный в OS X v10.0 и позже.
-
Языковая модель, слишком большая, чтобы быть созданным
Значение
- 5124
Описание
Языковая модель, слишком большая, чтобы быть созданным
Доступный в OS X v10.0 и позже.
-
Указанный объект был уже выпущен
Значение
- 5125
Описание
Указанный объект был уже выпущен
Доступный в OS X v10.0 и позже.
-
Указанная языковая модель была уже закончена
Значение
- 5126
Описание
Указанная языковая модель была уже закончена
Доступный в OS X v10.0 и позже.
-
Написание не могло быть найдено
Значение
- 5127
Описание
Написание не могло быть найдено
Доступный в OS X v10.0 и позже.
-
Языковая модель, не законченная с отклонением
Значение
- 5128
Описание
Языковая модель, не законченная с отклонением
Доступный в OS X v10.0 и позже.
-
Языковая модель является леворекурсивной или встраивается слишком много уровней
Значение
- 5129
Описание
Языковая модель является леворекурсивной или встраивается слишком много уровней
Доступный в OS X v10.0 и позже.
-
Слишком много элементов добавили к фразе, пути или другому объекту языка
Значение
- 5130
Описание
Слишком много элементов добавили к фразе, пути или другому объекту языка
Доступный в OS X v10.0 и позже.
-
Не может добавить указанный тип объекта к основному объекту языка
Значение
- 5131
Описание
Не может добавить указанный тип объекта к основному объекту языка
Доступный в OS X v10.0 и позже.
-
Звучите введенный источник разъединяется
Значение
- 5132
Описание
Звучите введенный источник разъединяется
Доступный в OS X v10.0 и позже.
-
Не может создать объект языка из файла или указателя
Значение
- 5133
Описание
Не может создать объект языка из файла или указателя
Доступный в OS X v10.0 и позже.
-
Опция еще не реализована
Значение
- 5199
Описание
Опция еще не реализована
Доступный в OS X v10.0 и позже.
Константы гештальта
Можно проверить на версию и информацию о доступности функции при помощи менеджера по Распознаванию речи селекторы, определенные в менеджере по Гештальту. Для получения дополнительной информации посмотрите Внутренний OS X: менеджер по Гештальту Ссылка.
