Поделиться через


SpeechRecognizer class

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

Extends

Конструкторы

SpeechRecognizer(SpeechConfig, AudioConfig)

Конструктор SpeechRecognizer.

Свойства

authorizationToken

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

canceled

Событие отменило сигнал об ошибке во время распознавания.

endpointId

Возвращает идентификатор конечной точки настраиваемой модели речи, которая используется для распознавания речи.

internalData
outputFormat

Возвращает выходной формат распознавания.

properties

Коллекция свойств и их значений, определенных для этого speechRecognizer.

recognized

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

recognizing

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

speechRecognitionLanguage

Получает речной язык распознавания.

telemetryEnabled

Этот метод возвращает текущее состояние параметра телеметрии.

Унаследованные свойства

sessionStarted

Определяет обработчик событий для запущенных сеансов.

sessionStopped

Определяет обработчик событий для остановленных событий сеанса.

speechEndDetected

Определяет обработчик событий для остановленных речи событий.

speechStartDetected

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

Методы

close(() => void, (error: string) => void)

закрывает все внешние ресурсы, удерживаемые экземпляром этого класса.

dispose(boolean)

Удаляет все ресурсы, удерживаемые объектом.

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Конструктор SpeechRecognizer.

recognizeOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)

Запускает распознавание речи и останавливается после того, как распознается первое высказывание. Задача возвращает текст распознавания в результате. Примечание. RecognizeOnceAsync() возвращается при обнаружении первого речевых фрагмента, поэтому он подходит только для распознавания одного снимка, например команды или запроса. Для длительного распознавания вместо этого используйте StartContinuousRecognitionAsync().

startContinuousRecognitionAsync(() => void, (e: string) => void)

Запускает распознавание речи до вызова stopContinuousRecognitionAsync(). Пользователь должен подписаться на события для получения результатов распознавания.

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

Запускает распознавание речи с поиском ключевых слов, пока не будет вызван stopKeywordRecognitionAsync(). Пользователь должен подписаться на события для получения результатов распознавания. Примечание. Функции обнаружения ключевых слов доступны только в пакете SDK для речевых устройств. Эта функция в настоящее время не включена в сам пакет SDK.

stopContinuousRecognitionAsync(() => void, (e: string) => void)

Останавливает непрерывное распознавание речи.

stopKeywordRecognitionAsync(() => void)

Останавливает непрерывное распознавание речи. Примечание. Функции обнаружения ключевых слов доступны только в пакете SDK для речевых устройств. Эта функция в настоящее время не включена в сам пакет SDK.

Наследуемые методы

enableTelemetry(boolean)

Этот метод глобально включает или отключает данные телеметрии.

Сведения о конструкторе

SpeechRecognizer(SpeechConfig, AudioConfig)

Конструктор SpeechRecognizer.

new SpeechRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

Параметры

speechConfig
SpeechConfig

набор начальных свойств для распознавателя

audioConfig
AudioConfig

Необязательная конфигурация звука, связанная с распознавательом

Сведения о свойстве

authorizationToken

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

string authorizationToken

Значение свойства

string

Маркер авторизации.

canceled

Событие отменило сигнал об ошибке во время распознавания.

public canceled: (sender: Recognizer, event: SpeechRecognitionCanceledEventArgs) => void

Значение свойства

(sender: Recognizer, event: SpeechRecognitionCanceledEventArgs) => void

endpointId

Возвращает идентификатор конечной точки настраиваемой модели речи, которая используется для распознавания речи.

string endpointId

Значение свойства

string

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

internalData

object internalData

Значение свойства

object

outputFormat

Возвращает выходной формат распознавания.

OutputFormat outputFormat

Значение свойства

Формат вывода распознавания.

properties

Коллекция свойств и их значений, определенных для этого speechRecognizer.

PropertyCollection properties

Значение свойства

Коллекция свойств и их значений, определенных для этого speechRecognizer.

recognized

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

public recognized: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void

Значение свойства

(sender: Recognizer, event: SpeechRecognitionEventArgs) => void

recognizing

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

public recognizing: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void

Значение свойства

(sender: Recognizer, event: SpeechRecognitionEventArgs) => void

speechRecognitionLanguage

Получает речной язык распознавания.

string speechRecognitionLanguage

Значение свойства

string

Речной язык распознавания.

telemetryEnabled

Этот метод возвращает текущее состояние параметра телеметрии.

static boolean telemetryEnabled

Значение свойства

boolean

Значение true, если телеметрия включена, значение false в противном случае.

Сведения об унаследованном свойстве

sessionStarted

Определяет обработчик событий для запущенных сеансов.

public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void

Значение свойства

(sender: Recognizer, event: SessionEventArgs) => void

унаследован отRecognizer.sessionStarted

sessionStopped

Определяет обработчик событий для остановленных событий сеанса.

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

Значение свойства

(sender: Recognizer, event: SessionEventArgs) => void

наследуется отРаспознавателя.sessionStopped

speechEndDetected

Определяет обработчик событий для остановленных речи событий.

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

Значение свойства

(sender: Recognizer, event: RecognitionEventArgs) => void

наследуется отРаспознавателя.speechEndDetected

speechStartDetected

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

public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

Значение свойства

(sender: Recognizer, event: RecognitionEventArgs) => void

наследуется отРаспознавателя.speechStartDetected

Сведения о методе

close(() => void, (error: string) => void)

закрывает все внешние ресурсы, удерживаемые экземпляром этого класса.

function close(cb?: () => void, errorCb?: (error: string) => void)

Параметры

cb

() => void

errorCb

(error: string) => void

dispose(boolean)

Удаляет все ресурсы, удерживаемые объектом.

function dispose(disposing: boolean): Promise<void>

Параметры

disposing

boolean

Значение true, если удаление объекта.

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

Promise<void>

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Конструктор SpeechRecognizer.

static function FromConfig(speechConfig: SpeechConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): SpeechRecognizer

Параметры

speechConfig
SpeechConfig

набор начальных свойств для распознавателя

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

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

audioConfig
AudioConfig

Необязательная конфигурация звука, связанная с распознавательом

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

recognizeOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)

Запускает распознавание речи и останавливается после того, как распознается первое высказывание. Задача возвращает текст распознавания в результате. Примечание. RecognizeOnceAsync() возвращается при обнаружении первого речевых фрагмента, поэтому он подходит только для распознавания одного снимка, например команды или запроса. Для длительного распознавания вместо этого используйте StartContinuousRecognitionAsync().

function recognizeOnceAsync(cb?: (e: SpeechRecognitionResult) => void, err?: (e: string) => void)

Параметры

cb

(e: SpeechRecognitionResult) => void

Обратный вызов, который получил SpeechRecognitionResult.

err

(e: string) => void

Обратный вызов, вызываемый в случае ошибки.

startContinuousRecognitionAsync(() => void, (e: string) => void)

Запускает распознавание речи до вызова stopContinuousRecognitionAsync(). Пользователь должен подписаться на события для получения результатов распознавания.

function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Параметры

cb

() => void

Обратный вызов вызывается после начала распознавания.

err

(e: string) => void

Обратный вызов, вызываемый в случае ошибки.

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

Запускает распознавание речи с поиском ключевых слов, пока не будет вызван stopKeywordRecognitionAsync(). Пользователь должен подписаться на события для получения результатов распознавания. Примечание. Функции обнаружения ключевых слов доступны только в пакете SDK для речевых устройств. Эта функция в настоящее время не включена в сам пакет SDK.

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

Параметры

model
KeywordRecognitionModel

Модель распознавания ключевых слов, указывающая ключевое слово для распознавания.

cb

() => void

Обратный вызов вызывается после начала распознавания.

err

(e: string) => void

Обратный вызов, вызываемый в случае ошибки.

stopContinuousRecognitionAsync(() => void, (e: string) => void)

Останавливает непрерывное распознавание речи.

function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Параметры

cb

() => void

Обратный вызов, вызываемый после остановки распознавания.

err

(e: string) => void

Обратный вызов, вызываемый в случае ошибки.

stopKeywordRecognitionAsync(() => void)

Останавливает непрерывное распознавание речи. Примечание. Функции обнаружения ключевых слов доступны только в пакете SDK для речевых устройств. Эта функция в настоящее время не включена в сам пакет SDK.

function stopKeywordRecognitionAsync(cb?: () => void)

Параметры

cb

() => void

Обратный вызов, вызываемый после остановки распознавания.

Сведения о наследуемом методе

enableTelemetry(boolean)

Этот метод глобально включает или отключает данные телеметрии.

static function enableTelemetry(enabled: boolean)

Параметры

enabled

boolean

Глобальный параметр для сбора данных телеметрии. Если задано значение true, данные телеметрии, такие как ошибки микрофона, собираются и отправляются в корпорацию Майкрософт ошибки распознавания. Если задано значение false, данные телеметрии не отправляются в корпорацию Майкрософт.

наследуется от распознавателя.enableTelemetry