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.

このクラスは、音声認識エンジンをインプロセスで実行するためのもので、次のように音声認識のさまざまな側面を制御します。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では、1つのレコグナイザーを、それを使用するアプリケーションと共有します。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)

同期音声認識にオーディオではなくテキストを使用して、音声認識エンジンに対する特定の語の入力をエミュレートし、語と読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。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)

同期音声認識にオーディオではなくテキストを使用して、音声認識エンジンに対するフレーズの入力をエミュレートし、フレーズと読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。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 の配列を使用して、共有された音声認識エンジンに対する特定の語の入力をエミュレートし、語と読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。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)

非同期音声認識にオーディオではなくテキストを使用して、音声認識エンジンに対するフレーズの入力をエミュレートし、フレーズと読み込まれている音声認識文法との間で認識エンジンが Unicode 比較をどのように行うかを指定します。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)

1 つ以上の非同期音声認識操作を実行します。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)

SpeechRecognitionEngine オブジェクトを、WAVE オーディオ形式 (.wav) ファイルからの入力を受け取るように構成します。Configures the SpeechRecognitionEngine object to receive input from a Waveform audio format (.wav) file.

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

SpeechRecognitionEngine オブジェクトを、WAVE オーディオ形式 (.wav) データを含むストリームからの入力を受け取るように構成します。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.

適用対象

こちらもご覧ください