Note
Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.
SpeechRecognitionEngine.RequestRecognizerUpdate Method
Include Protected Members
Include Inherited Members
Requests that the recognizer pauses to update its state.
Overload List
| Name | Description | |
|---|---|---|
.gif "Public method") |
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. |
Top
Remarks
Use this method to synchronize changes to the recognizer. For example, if you load or unload a speech recognition grammar while the recognizer is processing input, use this method and the RecognizerUpdateReached event to synchronize your application behavior with the state of the recognizer.
When this method is called, the recognizer pauses or completes asynchronous operations and generates a RecognizerUpdateReached event. A RecognizerUpdateReached event handler can then modify the state of the recognizer in between recognition operations. When handling RecognizerUpdateReached events, a speech recognition engine pauses until the event handler returns.
Note
If the input to the recognizer is changed before the recognizer raises the RecognizerUpdateReached event, the request is discarded.
When this method is called:
If the recognizer is not processing input, the recognizer immediately generates the RecognizerUpdateReached event.
If the recognizer is processing input that consists of silence or background noise, the recognizer pauses the recognition operation and generates the RecognizerUpdateReached event.
If the recognizer is processing input that does not consist of silence or background noise, the recognizer completes the recognition operation and then generates the RecognizerUpdateReached event.
While the recognizer is handling the RecognizerUpdateReached event:
The recognizer does not process input, and the value of the RecognizerAudioPosition property remains the same.
The recognizer continues to collect input, and the value of the AudioPosition property can change.