SpeechRecognitionEngine Класс

Определение

Предоставляет средства доступа и управления механизмом распознавания речи внутри процесса.Provides the means to access and manage an in-process speech recognition engine.

public ref class SpeechRecognitionEngine : IDisposable
public class SpeechRecognitionEngine : IDisposable
type SpeechRecognitionEngine = class
    interface IDisposable
Public Class SpeechRecognitionEngine
Implements IDisposable
Наследование
SpeechRecognitionEngine
Реализации

Примеры

В следующем примере показана часть консольного приложения, демонстрирующее базовое распознавание речи.The following example shows part of a console application that demonstrates basic speech recognition. Поскольку в этом примере используется Multiple режим RecognizeAsync метода, он выполняет распознавание до закрытия окна консоли или завершения отладки.Because this example uses the Multiple mode of the RecognizeAsync method, it performs recognition until you close the console window or stop debugging.

using System;  
using System.Speech.Recognition;  

namespace SpeechRecognitionApp  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Create an in-process speech recognizer for the en-US locale.  
      using (  
      SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(  
          new System.Globalization.CultureInfo("en-US")))  
      {  

        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Add a handler for the speech recognized event.  
        recognizer.SpeechRecognized +=   
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Start asynchronous, continuous speech recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  

        // Keep the console window open.  
        while (true)  
        {  
          Console.ReadLine();  
        }  
      }  
    }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Recognized text: " + e.Result.Text);  
    }  
  }  
}  

Комментарии

Экземпляр этого класса можно создать для любого из установленных распознавателей речи.You can create an instance of this class for any of the installed speech recognizers. Чтобы получить сведения об установленных распознавателях, используйте статический InstalledRecognizers метод.To get information about which recognizers are installed, use the static InstalledRecognizers method.

Этот класс предназначен для запуска модулей распознавания речи в процессе и предоставляет контроль над различными аспектами распознавания речи следующим образом.This class is for running speech recognition engines in-process, and provides control over various aspects of speech recognition, as follows:

SpeechRecognitionEngineОбъект предназначен для единственного использования процесса, создающего экземпляр объекта.The SpeechRecognitionEngine object is for the sole use of the process that instantiated the object. И наоборот, SpeechRecognizer использует один распознаватель с любым приложением, которое хочет его использовать.By contrast, the SpeechRecognizer shares a single recognizer with any application that wants to use it.

Примечание

Всегда вызывайте, Dispose прежде чем вы освободите последнюю ссылку на распознаватель речи.Always call Dispose before you release your last reference to the speech recognizer. В противном случае ресурсы, которые он использует, не будут освобождены до тех пор, пока сборщик мусора не вызовет метод объекта распознавателя Finalize .Otherwise, the resources it is using will not be freed until the garbage collector calls the recognizer object's Finalize method.

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

SpeechRecognitionEngine()

Инициализирует новый экземпляр класса SpeechRecognitionEngine, используя распознаватель речи по умолчанию для системы.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

SpeechRecognitionEngine(CultureInfo)

Инициализирует новый экземпляр класса SpeechRecognitionEngine, используя распознаватель речи по умолчанию для указанного языкового стандарта.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

SpeechRecognitionEngine(RecognizerInfo)

Инициализирует новый экземпляр класса SpeechRecognitionEngine, используя информацию в объекте RecognizerInfo для указания средства распознавания, которое необходимо использовать.Initializes a new instance of the SpeechRecognitionEngine using the information in a RecognizerInfo object to specify the recognizer to use.

SpeechRecognitionEngine(String)

Инициализирует новый экземпляр класса SpeechRecognitionEngine с заданным строковым параметром, задающим имя средства распознавания, которое необходимо использовать.Initializes a new instance of the SpeechRecognitionEngine class with a string parameter that specifies the name of the recognizer to use.

Свойства

AudioFormat

Получает формат аудио, принимаемого объектом SpeechRecognitionEngine.Gets the format of the audio being received by the SpeechRecognitionEngine.

AudioLevel

Получает уровень звука, принимаемого объектом SpeechRecognitionEngine.Gets the level of the audio being received by the SpeechRecognitionEngine.

AudioPosition

Получает текущую позицию в аудиопотоке, создаваемом устройством, которое предоставляет входные данные для SpeechRecognitionEngine.Gets the current location in the audio stream being generated by the device that is providing input to the SpeechRecognitionEngine.

AudioState

Получает состояние звука, принимаемого объектом SpeechRecognitionEngine.Gets the state of the audio being received by the SpeechRecognitionEngine.

BabbleTimeout

Получает или задает интервал времени, в течение которого SpeechRecognitionEngine принимает входные данные, содержащие только фоновый шум, прежде чем финализировать распознавание.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only background noise, before finalizing recognition.

EndSilenceTimeout

Получает или задает интервал молчания, который SpeechRecognitionEngine будет принимать в конце однозначных вводных данных, прежде чем финализировать операцию распознавания.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of unambiguous input before finalizing a recognition operation.

EndSilenceTimeoutAmbiguous

Получает или задает интервал молчания, который SpeechRecognitionEngine будет принимать в конце неоднозначных входных данных, прежде чем финализировать операцию распознавания.Gets or sets the interval of silence that the SpeechRecognitionEngine will accept at the end of ambiguous input before finalizing a recognition operation.

Grammars

Получает коллекцию объектов Grammar, загруженных в данных экземпляр SpeechRecognitionEngine.Gets a collection of the Grammar objects that are loaded in this SpeechRecognitionEngine instance.

InitialSilenceTimeout

Получает или задает интервал времени, в течение которого SpeechRecognitionEngine принимает входные данные, содержащие только молчание, прежде чем финализировать распознавание.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only silence before finalizing recognition.

MaxAlternates

Получает или задает максимальное количество альтернативных результатов распознавания, которые SpeechRecognitionEngine возвращает для каждой операции распознавания.Gets or sets the maximum number of alternate recognition results that the SpeechRecognitionEngine returns for each recognition operation.

RecognizerAudioPosition

Получает текущую позицию SpeechRecognitionEngine в обрабатываемых им входных аудиоданных.Gets the current location of the SpeechRecognitionEngine in the audio input that it is processing.

RecognizerInfo

Получает сведения о текущем экземпляре SpeechRecognitionEngine.Gets information about the current instance of SpeechRecognitionEngine.

Методы

Dispose()

Удаляет объект SpeechRecognitionEngine.Disposes the SpeechRecognitionEngine object.

Dispose(Boolean)

Удаляет объект SpeechRecognitionEngine и освобождает ресурсы, используемые во время сеанса.Disposes the SpeechRecognitionEngine object and releases resources used during the session.

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Эмулирует ввод конкретных слов в распознаватель речи, используя текст вместо аудио для синхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между словами и загруженными грамматиками распознавания речи.Emulates input of specific words to the speech recognizer, using text in place of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the words and the loaded speech recognition grammars.

EmulateRecognize(String)

Эмулирует ввод фразы в распознаватель речи, используя текст вместо аудио для синхронного распознавания речи.Emulates input of a phrase to the speech recognizer, using text in place of audio for synchronous speech recognition.

EmulateRecognize(String, CompareOptions)

Эмулирует ввод фразы в распознаватель речи, используя текст вместо аудио для синхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между фразой и загруженными грамматиками распознавания речи.Emulates input of a phrase to the speech recognizer, using text in place of audio for synchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the phrase and the loaded speech recognition grammars.

EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)

Эмулирует ввод конкретных слов в общий распознаватель речи, используя массив объектов RecognizedWordUnit вместо аудио для асинхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между словами и загруженными грамматиками распознавания речи.Emulates input of specific words to the speech recognizer, using an array of RecognizedWordUnit objects in place of audio for asynchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the words and the loaded speech recognition grammars.

EmulateRecognizeAsync(String)

Эмулирует ввод фразы в распознаватель речи, используя текст вместо аудио для асинхронного распознавания речи.Emulates input of a phrase to the speech recognizer, using text in place of audio for asynchronous speech recognition.

EmulateRecognizeAsync(String, CompareOptions)

Эмулирует ввод фразы в распознаватель речи, используя текст вместо аудио для асинхронного распознавания речи, и указывает способ обработки распознавателем сравнения Юникода между фразой и загруженными грамматиками распознавания речи.Emulates input of a phrase to the speech recognizer, using text in place of audio for asynchronous speech recognition, and specifies how the recognizer handles Unicode comparison between the phrase and the loaded speech recognition grammars.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InstalledRecognizers()

Возвращает сведения для всех установленных распознавателей речи в текущей системе.Returns information for all of the installed speech recognizers on the current system.

LoadGrammar(Grammar)

Выполняет синхронную загрузку объекта Grammar.Synchronously loads a Grammar object.

LoadGrammarAsync(Grammar)

Выполняет асинхронную загрузку грамматики распознавания речи.Asynchronously loads a speech recognition grammar.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
QueryRecognizerSetting(String)

Возвращает значения параметров для распознавателя.Returns the values of settings for the recognizer.

Recognize()

Выполняет синхронную операцию распознавания речи.Performs a synchronous speech recognition operation.

Recognize(TimeSpan)

Выполняет синхронную операцию распознавания речи с указанным начальным временем ожидания бездействия.Performs a synchronous speech recognition operation with a specified initial silence timeout period.

RecognizeAsync()

Выполняет одиночную, асинхронную операцию распознавания речи.Performs a single, asynchronous speech recognition operation.

RecognizeAsync(RecognizeMode)

Выполняет одну или несколько асинхронных операций распознавания речи.Performs one or more asynchronous speech recognition operations.

RecognizeAsyncCancel()

Останавливает асинхронное распознавание без ожидания завершения текущей операции распознавания.Terminates asynchronous recognition without waiting for the current recognition operation to complete.

RecognizeAsyncStop()

Останавливает асинхронное распознавание после завершения текущей операции распознавания.Stops asynchronous recognition after the current recognition operation completes.

RequestRecognizerUpdate()

Запрашивает, чтобы распознаватель приостановил обновления состояния.Requests that the recognizer pauses to update its state.

RequestRecognizerUpdate(Object)

Запрашивает, чтобы распознаватель приостановил обновление состояния и предоставил токен пользователя для связанного события.Requests that the recognizer pauses to update its state and provides a user token for the associated event.

RequestRecognizerUpdate(Object, TimeSpan)

Запрашивает, чтобы распознаватель приостановил обновление состояния и предоставил смещение и токен пользователя для связанного события.Requests that the recognizer pauses to update its state and provides an offset and a user token for the associated event.

SetInputToAudioStream(Stream, SpeechAudioFormatInfo)

Настраивает объект SpeechRecognitionEngine для получения входных данных из аудиопотока.Configures the SpeechRecognitionEngine object to receive input from an audio stream.

SetInputToDefaultAudioDevice()

Настраивает объект SpeechRecognitionEngine для получения входных данных от аудиоустройства по умолчанию.Configures the SpeechRecognitionEngine object to receive input from the default audio device.

SetInputToNull()

Отключает ввод в распознаватель речи.Disables the input to the speech recognizer.

SetInputToWaveFile(String)

Настраивает объект SpeechRecognitionEngine для получения входных данных из файла аудиоформата WAV.Configures the SpeechRecognitionEngine object to receive input from a Waveform audio format (.wav) file.

SetInputToWaveStream(Stream)

Настраивает объект SpeechRecognitionEngine для получения входных данных от потока, содержащего аудиоформата WAV.Configures the SpeechRecognitionEngine object to receive input from a stream that contains Waveform audio format (.wav) data.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
UnloadAllGrammars()

Выгружает все объекты Grammar из распознавателя.Unloads all Grammar objects from the recognizer.

UnloadGrammar(Grammar)

Выгружает заданный объект Grammar из экземпляра SpeechRecognitionEngine.Unloads a specified Grammar object from the SpeechRecognitionEngine instance.

UpdateRecognizerSetting(String, Int32)

Обновляет заданный параметр для SpeechRecognitionEngine с указанным целым числом.Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

UpdateRecognizerSetting(String, String)

Обновляет указанный параметр механизма распознавания речи с заданным стоковым значением.Updates the specified speech recognition engine setting with the specified string value.

События

AudioLevelUpdated

Возникает, когда SpeechRecognitionEngine сообщает об уровне аудиовхода.Raised when the SpeechRecognitionEngine reports the level of its audio input.

AudioSignalProblemOccurred

Возникает, когда SpeechRecognitionEngine обнаруживает проблему в аудиосигнале.Raised when the SpeechRecognitionEngine detects a problem in the audio signal.

AudioStateChanged

Возникает, когда меняется состояние получаемого объектом SpeechRecognitionEngine аудио.Raised when the state changes in the audio being received by the SpeechRecognitionEngine.

EmulateRecognizeCompleted

Возникает, если SpeechRecognitionEngine оформляет асинхронную операцию распознавания эмулированного ввода.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation of emulated input.

LoadGrammarCompleted

Возникает при завершении SpeechRecognitionEngine асинхронной загрузки объекта Grammar.Raised when the SpeechRecognitionEngine finishes the asynchronous loading of a Grammar object.

RecognizeCompleted

Возникает, если SpeechRecognitionEngine оформляет асинхронную операцию распознавания.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation.

RecognizerUpdateReached

Вызывается, когда исполняемый механизм SpeechRecognitionEngine приостанавливается, чтобы принять изменения.Raised when a running SpeechRecognitionEngine pauses to accept modifications.

SpeechDetected

Возникает, когда SpeechRecognitionEngine обнаруживает введенные данные, которые могут быть идентифицированы как речь.Raised when the SpeechRecognitionEngine detects input that it can identify as speech.

SpeechHypothesized

Возникает, когда SpeechRecognitionEngine распознал слово или слова, которые могут являться нескольких составных фраз в грамматике.Raised when the SpeechRecognitionEngine has recognized a word or words that may be a component of multiple complete phrases in a grammar.

SpeechRecognitionRejected

Возникает, когда SpeechRecognitionEngine получает ввод, не соответствующий ни одному из загруженных и включенных объектов Grammar.Raised when the SpeechRecognitionEngine receives input that does not match any of its loaded and enabled Grammar objects.

SpeechRecognized

Возникает, когда SpeechRecognitionEngine получает ввод, соответствующий любому из загруженных и включенных объектов Grammar.Raised when the SpeechRecognitionEngine receives input that matches any of its loaded and enabled Grammar objects.

Применяется к

См. также раздел