RecognizerState Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Enumerates values of the recognizer's state.
public enum class RecognizerStatepublic enum RecognizerStatetype RecognizerState = Public Enum RecognizerState- Inheritance
Fields
| Name | Value | Description |
|---|---|---|
| Stopped | 0 | The recognition engine is not receiving or analyzing audio input. |
| Listening | 1 | The recognition engine is available to receive and analyze audio input. |
Examples
In the example below, an application displays the state of a recognizer in its implementation of a handler for the StateChanged event.
_recognizer.StateChanged +=
delegate(object sender, StateChangedEventArgs eventArgs) {
_recognizerStateLabel.Text = "Speech Recognizer State: " + eventArgs.RecognizerState.ToString();
};
Remarks
RecognizerState encapsulates the running state of the default speech recognition engine for clients using SpeechRecognizer to access the Windows Desktop Speech Recognition Technology service.
Applications can obtain the current state of the desktop recognition engine as a RecognizerState object by querying the State property on a SpeechRecognizer instance. To obtain the state of the desktop recognition engine after it changes, applications can query the RecognizerState property of the StateChangedEventArgs object passed to a handler for StateChanged events.
Note
SpeechRecognitionEngine instances run in-process and their running state is under the control of the application. Therefore, SpeechRecognitionEngine does not contain a property to return a RecognizerState object.
The state of a desktop speech recognition server is a read-only property and cannot be controlled programmatically. Users can change a shared speech recognizer's state using the Speech Recognition user interface (UI) or through the Speech Recognition member of the Windows Control Panel.
Both the On and Sleep settings in the Speech Recognition UI correspond to the Listening state. The Off setting in the Speech Recognition UI corresponds to Stopped.
Enabled is the other property that affects the readiness of a shared speech recognition engine to receive and process speech input. You can use Enabled to control whether or not a shared speech recognition engine's grammars are active for recognition. However, changing the Enabled property has no effect on the RecognizerState property.
Information such as the description, the supported culture and audio formats, and the recognition engine name is encapsulated in the RecognizerInfo type.
