Emulates input to the speech recognizer, using text in place of audio for synchronous speech recognition.

These methods bypass the system audio input and provide text to the recognizer as String objects or as an array of RecognizedWordUnit objects. The SpeechRecognitionEngine matches the input text to its loaded Grammar objects, and returns a RecognitionResult object.

Using the EmulateOptions parameter, you can specify one of three types of recognition operation:

• Emulation. Uses text instead of audio as input to the speech recognition engine to perform recognition.

• IdentifyConfusion. Identifies phrases in a grammar that may generate false acceptances on recognition because of similarity to other phrases in the grammar.

• Simulation. Creates an 'idealized' audio representation of the input phrase (based on the speech recognition engine's lexicon and acoustic model), and then performs recognition on the idealized audio.

See EmulateOptions for more information.

Use the SetInputToNull()()()() method to disable audio input to the speech recognition engine during emulation operations.

The speech recognizer raises the SpeechDetected, SpeechHypothesized, SpeechRecognitionRejected, and SpeechRecognized events as if the recognition operation is not emulated. The recognizer ignores new lines and extra white space and treats punctuation as literal input.

Note
The RecognitionResult object generated by the speech recognizer in response to emulated input has a value of nullNothingnullptrunita null reference (Nothing in Visual Basic) for its Audio property.

To emulate asynchronous recognition, use the EmulateRecognizeAsync method.

In the following example, an application obtains text input through a Textbox, and uses it to emulate speech input.

Copy Code

private void EmulateTextBox_KeyPress(object sender, KeyPressEventArgs eventArgs) { if ((Keys)eventArgs.KeyChar == Keys.Enter) { RecognitionResult result = _recognitionEngine.EmulateRecognize(_emulateTextBox.Text); } } // Emulate a button click in the emulateTextBox. private void _emulateButton_Click(object sender, EventArgs e) { RecognitionResult result = _recognitionEngine.EmulateRecognize(_emulateTextBox.Text); }

Reference

Other Resources