SpeechRecognitionEngine SpeechRecognitionEngine SpeechRecognitionEngine SpeechRecognitionEngine Class

정의

프로세스에서 음성 인식 엔진을 관리 하 고 액세스할 수 있는 방법을 제공 합니다.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
상속
SpeechRecognitionEngineSpeechRecognitionEngineSpeechRecognitionEngineSpeechRecognitionEngine
구현

예제

다음 예제에서는 기본 음성 인식 기능을 보여 주는 콘솔 애플리케이션 부분을 보여 줍니다.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.

이 클래스는를 음성 인식 엔진 in-process로 실행 하 고 다음과 같은 음성 인식의 다양 한 측면에 대 한 제어를 제공 합니다.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() SpeechRecognitionEngine() SpeechRecognitionEngine()

시스템에 대한 기본 음성 인식기를 사용하여 SpeechRecognitionEngine 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for the system.

SpeechRecognitionEngine(CultureInfo) SpeechRecognitionEngine(CultureInfo) SpeechRecognitionEngine(CultureInfo) SpeechRecognitionEngine(CultureInfo)

지정된 로캘에 대한 기본 음성 인식기를 사용하여 SpeechRecognitionEngine 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the SpeechRecognitionEngine class using the default speech recognizer for a specified locale.

SpeechRecognitionEngine(RecognizerInfo) SpeechRecognitionEngine(RecognizerInfo) SpeechRecognitionEngine(RecognizerInfo) 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(String) SpeechRecognitionEngine(String) 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 AudioFormat AudioFormat AudioFormat

SpeechRecognitionEngine이 수신하는 오디오의 형식을 가져옵니다.Gets the format of the audio being received by the SpeechRecognitionEngine.

AudioLevel AudioLevel AudioLevel AudioLevel

SpeechRecognitionEngine이 수신하는 오디오의 수준을 가져옵니다.Gets the level of the audio being received by the SpeechRecognitionEngine.

AudioPosition AudioPosition AudioPosition AudioPosition

SpeechRecognitionEngine에 입력을 공급하는 디바이스가 생성하고 있는 오디오 스트림에서 현재 위치를 가져옵니다.Gets the current location in the audio stream being generated by the device that is providing input to the SpeechRecognitionEngine.

AudioState AudioState AudioState AudioState

SpeechRecognitionEngine이 수신하는 오디오의 상태를 가져옵니다.Gets the state of the audio being received by the SpeechRecognitionEngine.

BabbleTimeout BabbleTimeout BabbleTimeout BabbleTimeout

인식을 완료하기 전에 SpeechRecognitionEngine에서 배경 잡음만 포함된 입력만 허용할 시간 간격을 가져오거나 설정합니다.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only background noise, before finalizing recognition.

EndSilenceTimeout EndSilenceTimeout EndSilenceTimeout 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 EndSilenceTimeoutAmbiguous EndSilenceTimeoutAmbiguous 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 Grammars Grammars Grammars

Grammar 인스턴스에 로드된 SpeechRecognitionEngine 개체의 컬렉션을 가져옵니다.Gets a collection of the Grammar objects that are loaded in this SpeechRecognitionEngine instance.

InitialSilenceTimeout InitialSilenceTimeout InitialSilenceTimeout InitialSilenceTimeout

인식을 완료하기 전에 SpeechRecognitionEngine에서 무음만 포함된 입력만 허용할 시간 간격을 가져오거나 설정합니다.Gets or sets the time interval during which a SpeechRecognitionEngine accepts input containing only silence before finalizing recognition.

MaxAlternates MaxAlternates MaxAlternates MaxAlternates

각 인식 작업을 위해 SpeechRecognitionEngine에서 반환하는 대체 인식 결과의 최대 개수를 가져오거나 설정합니다.Gets or sets the maximum number of alternate recognition results that the SpeechRecognitionEngine returns for each recognition operation.

RecognizerAudioPosition RecognizerAudioPosition RecognizerAudioPosition RecognizerAudioPosition

처리하고 있는 오디오 입력 SpeechRecognitionEngine의 현재 위치를 가져옵니다.Gets the current location of the SpeechRecognitionEngine in the audio input that it is processing.

RecognizerInfo RecognizerInfo RecognizerInfo RecognizerInfo

SpeechRecognitionEngine의 현재 인스턴스에 대한 정보를 가져옵니다.Gets information about the current instance of SpeechRecognitionEngine.

메서드

Dispose() Dispose() Dispose() Dispose()

SpeechRecognitionEngine 개체를 삭제합니다.Disposes the SpeechRecognitionEngine object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

SpeechRecognitionEngine 개체를 삭제하고 세션 중에 사용되는 리소스를 해제합니다.Disposes the SpeechRecognitionEngine object and releases resources used during the session.

EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions) EmulateRecognize(RecognizedWordUnit[], CompareOptions) 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) EmulateRecognize(String) EmulateRecognize(String) EmulateRecognize(String)

동기 음성 인식용 오디오 대신 텍스트를 사용하여 음성 인식기에 구 입력을 에뮬레이션합니다.Emulates input of a phrase to the speech recognizer, using text in place of audio for synchronous speech recognition.

EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions) EmulateRecognize(String, CompareOptions) 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) EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions) 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) EmulateRecognizeAsync(String) EmulateRecognizeAsync(String) EmulateRecognizeAsync(String)

비동기 음성 인식용 오디오 대신 텍스트를 사용하여 음성 인식기에 구 입력을 에뮬레이션합니다.Emulates input of a phrase to the speech recognizer, using text in place of audio for asynchronous speech recognition.

EmulateRecognizeAsync(String, CompareOptions) EmulateRecognizeAsync(String, CompareOptions) EmulateRecognizeAsync(String, CompareOptions) 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) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
InstalledRecognizers() InstalledRecognizers() InstalledRecognizers() InstalledRecognizers()

현재 시스템에 설치된 음성 인식기의 모든 정보를 반환합니다.Returns information for all of the installed speech recognizers on the current system.

LoadGrammar(Grammar) LoadGrammar(Grammar) LoadGrammar(Grammar) LoadGrammar(Grammar)

Grammar 개체를 동기적으로 로드합니다.Synchronously loads a Grammar object.

LoadGrammarAsync(Grammar) LoadGrammarAsync(Grammar) LoadGrammarAsync(Grammar) LoadGrammarAsync(Grammar)

음성 인식 문법을 비동기적으로 로드합니다.Asynchronously loads a speech recognition grammar.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
QueryRecognizerSetting(String) QueryRecognizerSetting(String) QueryRecognizerSetting(String) QueryRecognizerSetting(String)

인식기에 대한 설정의 값을 반환합니다.Returns the values of settings for the recognizer.

Recognize() Recognize() Recognize() Recognize()

동기 음성 인식 작업을 실행합니다.Performs a synchronous speech recognition operation.

Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan) Recognize(TimeSpan)

지정한 초기 대기 시간을 사용 하 여 동기 음성 인식 작업을 수행합니다.Performs a synchronous speech recognition operation with a specified initial silence timeout period.

RecognizeAsync() RecognizeAsync() RecognizeAsync() RecognizeAsync()

단일 비동기 음성 인식 작업을 실행합니다.Performs a single, asynchronous speech recognition operation.

RecognizeAsync(RecognizeMode) RecognizeAsync(RecognizeMode) RecognizeAsync(RecognizeMode) RecognizeAsync(RecognizeMode)

비동기 음성 인식 작업을 실행합니다.Performs one or more asynchronous speech recognition operations.

RecognizeAsyncCancel() RecognizeAsyncCancel() RecognizeAsyncCancel() RecognizeAsyncCancel()

현재 인식 작업이 완료되기를 기다리지 않고 비동기 인식을 종료합니다.Terminates asynchronous recognition without waiting for the current recognition operation to complete.

RecognizeAsyncStop() RecognizeAsyncStop() RecognizeAsyncStop() RecognizeAsyncStop()

현재 인식 작업을 종료한 후 비동기 인식을 중지합니다.Stops asynchronous recognition after the current recognition operation completes.

RequestRecognizerUpdate() RequestRecognizerUpdate() RequestRecognizerUpdate() RequestRecognizerUpdate()

인식기가 상태 업데이트를 멈출 것을 요청합니다.Requests that the recognizer pauses to update its state.

RequestRecognizerUpdate(Object) RequestRecognizerUpdate(Object) RequestRecognizerUpdate(Object) RequestRecognizerUpdate(Object)

인식기가 상태를 업데이트하기 위해 일시 중지되고 관련된 이벤트에 대한 사용자 토큰을 제공하도록 요청합니다.Requests that the recognizer pauses to update its state and provides a user token for the associated event.

RequestRecognizerUpdate(Object, TimeSpan) RequestRecognizerUpdate(Object, TimeSpan) RequestRecognizerUpdate(Object, TimeSpan) 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) SetInputToAudioStream(Stream, SpeechAudioFormatInfo) SetInputToAudioStream(Stream, SpeechAudioFormatInfo) SetInputToAudioStream(Stream, SpeechAudioFormatInfo)

오디오 스트림에서 입력을 받도록 SpeechRecognitionEngine 개체를 구성합니다.Configures the SpeechRecognitionEngine object to receive input from an audio stream.

SetInputToDefaultAudioDevice() SetInputToDefaultAudioDevice() SetInputToDefaultAudioDevice() SetInputToDefaultAudioDevice()

기본 오디오 디바이스에서 입력을 받도록 SpeechRecognitionEngine 개체를 구성합니다.Configures the SpeechRecognitionEngine object to receive input from the default audio device.

SetInputToNull() SetInputToNull() SetInputToNull() SetInputToNull()

음성 인식기에서 입력을 사용할 수 없습니다.Disables the input to the speech recognizer.

SetInputToWaveFile(String) SetInputToWaveFile(String) SetInputToWaveFile(String) SetInputToWaveFile(String)

Waveform 오디오 형식(.wav) 파일에서 입력을 받도록 SpeechRecognitionEngine 개체를 구성합니다.Configures the SpeechRecognitionEngine object to receive input from a Waveform audio format (.wav) file.

SetInputToWaveStream(Stream) SetInputToWaveStream(Stream) SetInputToWaveStream(Stream) SetInputToWaveStream(Stream)

Waveform 오디오 형식(.wav) 데이터가 포함된 스트림에서 입력을 받도록 SpeechRecognitionEngine 개체를 구성합니다.Configures the SpeechRecognitionEngine object to receive input from a stream that contains Waveform audio format (.wav) data.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
UnloadAllGrammars() UnloadAllGrammars() UnloadAllGrammars() UnloadAllGrammars()

모든 Grammar 개체를 인식기에서 언로드합니다.Unloads all Grammar objects from the recognizer.

UnloadGrammar(Grammar) UnloadGrammar(Grammar) UnloadGrammar(Grammar) UnloadGrammar(Grammar)

지정된 Grammar 개체를 SpeechRecognitionEngine 인스턴스에서 언로드합니다.Unloads a specified Grammar object from the SpeechRecognitionEngine instance.

UpdateRecognizerSetting(String, Int32) UpdateRecognizerSetting(String, Int32) UpdateRecognizerSetting(String, Int32) UpdateRecognizerSetting(String, Int32)

SpeechRecognitionEngine에 지정된 설정을 지정된 정수 값으로 업데이트합니다.Updates the specified setting for the SpeechRecognitionEngine with the specified integer value.

UpdateRecognizerSetting(String, String) UpdateRecognizerSetting(String, String) UpdateRecognizerSetting(String, String) UpdateRecognizerSetting(String, String)

지정된 음성 인식 엔진 설정을 지정된 문자열 값으로 업데이트합니다.Updates the specified speech recognition engine setting with the specified string value.

이벤트

AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated AudioLevelUpdated

SpeechRecognitionEngine가 오디오 입력 수준을 보고할 때 발생했습니다.Raised when the SpeechRecognitionEngine reports the level of its audio input.

AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred AudioSignalProblemOccurred

SpeechRecognitionEngine가 오디오 신호에서 문제를 감지했을 때 발생했습니다.Raised when the SpeechRecognitionEngine detects a problem in the audio signal.

AudioStateChanged AudioStateChanged AudioStateChanged AudioStateChanged

SpeechRecognitionEngine가 수신하는 오디오의 상태가 변경되었을 때 발생했습니다.Raised when the state changes in the audio being received by the SpeechRecognitionEngine.

EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted EmulateRecognizeCompleted

SpeechRecognitionEngine가 에뮬레이트된 입력에 대한 비동기 인식 작업을 종결할 때 발생했습니다.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation of emulated input.

LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted LoadGrammarCompleted

SpeechRecognitionEngineGrammar 개체의 비동기 로딩을 완료했을 때 발생했습니다.Raised when the SpeechRecognitionEngine finishes the asynchronous loading of a Grammar object.

RecognizeCompleted RecognizeCompleted RecognizeCompleted RecognizeCompleted

SpeechRecognitionEngine가 에뮬레이트된 입력에 대한 비동기 인식 작업을 종결할 때 발생했습니다.Raised when the SpeechRecognitionEngine finalizes an asynchronous recognition operation.

RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached RecognizerUpdateReached

실행이 SpeechRecognitionEngine 수정을 적용하기 위해 일시 중지될 때 발생했습니다.Raised when a running SpeechRecognitionEngine pauses to accept modifications.

SpeechDetected SpeechDetected SpeechDetected SpeechDetected

SpeechRecognitionEngine가 음성으로 식별할 수 있는 입력을 감지할 때 발생했습니다.Raised when the SpeechRecognitionEngine detects input that it can identify as speech.

SpeechHypothesized SpeechHypothesized SpeechHypothesized 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 SpeechRecognitionRejected SpeechRecognitionRejected SpeechRecognitionRejected

SpeechRecognitionEngine에서 로드하고 활성화한 어떤 Grammar 개체와도 일치하지 않는 입력을 받을 때 발생Raised when the SpeechRecognitionEngine receives input that does not match any of its loaded and enabled Grammar objects.

SpeechRecognized SpeechRecognized SpeechRecognized SpeechRecognized

SpeechRecognitionEngine에서 로드하고 활성화한 어떤 Grammar 개체와 일치하는 입력을 받을 때 발생Raised when the SpeechRecognitionEngine receives input that matches any of its loaded and enabled Grammar objects.

적용 대상

추가 정보