Code:
/ Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / WIN_WINDOWS / lh_tools_devdiv_wpf / Windows / wcp / Speech / Src / Recognition / SpeechRecognizer.cs / 1 / SpeechRecognizer.cs
//------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------
#if !SPEECHSERVER
using System;
using System.Globalization;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;
using System.Runtime.Serialization;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Speech.Internal;
using System.Speech.Internal.SapiInterop;
using System.Speech.AudioFormat;
namespace System.Speech.Recognition
{
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer"]/*' />
public class SpeechRecognizer : IDisposable
{
//*******************************************************************
//
// Constructors
//
//*******************************************************************
#region Constructors
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechRecognizer"]/*' />
public SpeechRecognizer ()
{
_sapiRecognizer = new SapiRecognizer (SapiRecognizer.RecognizerType.Shared);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Dispose1"]/*' />
public void Dispose ()
{
Dispose (true);
GC.SuppressFinalize (this);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Dispose2"]/*' />
protected virtual void Dispose (bool disposing)
{
if (disposing && !_disposed)
{
if (_recognizerBase != null)
{
_recognizerBase.Dispose();
_recognizerBase = null;
}
if (_sapiRecognizer != null)
{
_sapiRecognizer.Dispose();
_sapiRecognizer = null;
}
_disposed = true; // Don't set RecognizerBase to null as every method will then need to throw ObjectDisposedException.
}
}
#endregion
//********************************************************************
//
// Public Properties
//
//*******************************************************************
#region public Properties
// Determines whether the recognizer is listening or not.
//
public RecognizerState State
{
get { return RecoBase.State; }
}
// Are the grammars attached to this SpeechRecognizer active? Default = true
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Enabled"]/*' />
public bool Enabled
{
get { return RecoBase.Enabled; }
set { RecoBase.Enabled = value; }
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.PauseRecognizerOnRecognition"]/*' />
public bool PauseRecognizerOnRecognition
{
get { return RecoBase.PauseRecognizerOnRecognition; }
set { RecoBase.PauseRecognizerOnRecognition = value; }
}
// Gives access to the collection of grammars that are currently active. Read-only.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Grammars"]/*' />
public ReadOnlyCollection Grammars
{
get { return RecoBase.Grammars; }
}
// Gives access to the set of attributes exposed by this recognizer.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RecognizerInfo"]/*' />
public RecognizerInfo RecognizerInfo
{
get { return RecoBase.RecognizerInfo; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public AudioState AudioState
{
get { return RecoBase.AudioState; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public int AudioLevel
{
get { return RecoBase.AudioLevel; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public TimeSpan AudioPosition
{
get { return RecoBase.AudioPosition; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public TimeSpan RecognizerAudioPosition
{
get { return RecoBase.RecognizerAudioPosition; }
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioFormat"]/*' />
public SpeechAudioFormatInfo AudioFormat
{
get { return RecoBase.AudioFormat; }
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.MaxAlternates"]/*' />
public int MaxAlternates
{
get { return RecoBase.MaxAlternates; }
set { RecoBase.MaxAlternates = value; }
}
/*
*/
#endregion
//********************************************************************
//
// Public Methods
//
//********************************************************************
#region public Methods
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.LoadGrammar"]/*' />
public void LoadGrammar (Grammar grammar)
{
RecoBase.LoadGrammar (grammar);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.LoadGrammarAsync"]/*' />
public void LoadGrammarAsync (Grammar grammar)
{
RecoBase.LoadGrammarAsync (grammar);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.UnloadGrammar"]/*' />
public void UnloadGrammar (Grammar grammar)
{
RecoBase.UnloadGrammar (grammar);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.UnloadAllGrammars"]/*' />
public void UnloadAllGrammars ()
{
RecoBase.UnloadAllGrammars ();
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize1"]/*' />
public RecognitionResult EmulateRecognize (string inputText)
{
if (Enabled)
{
return RecoBase.EmulateRecognize (inputText);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public RecognitionResult EmulateRecognize (string inputText, CompareOptions compareOptions)
{
if (Enabled)
{
return RecoBase.EmulateRecognize (inputText, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public RecognitionResult EmulateRecognize (RecognizedWordUnit [] wordUnits, CompareOptions compareOptions)
{
if (Enabled)
{
return RecoBase.EmulateRecognize (wordUnits, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize1"]/*' />
public void EmulateRecognizeAsync (string inputText)
{
if (Enabled)
{
RecoBase.EmulateRecognizeAsync (inputText);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public void EmulateRecognizeAsync (string inputText, CompareOptions compareOptions)
{
if (Enabled)
{
RecoBase.EmulateRecognizeAsync (inputText, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public void EmulateRecognizeAsync (RecognizedWordUnit [] wordUnits, CompareOptions compareOptions)
{
if (Enabled)
{
RecoBase.EmulateRecognizeAsync (wordUnits, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
// Methods to pause the recognizer to do atomic updates:
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RequestRecognizerUpdate1"]/*' />
public void RequestRecognizerUpdate ()
{
RecoBase.RequestRecognizerUpdate ();
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RequestRecognizerUpdate2"]/*' />
public void RequestRecognizerUpdate (object userToken)
{
RecoBase.RequestRecognizerUpdate (userToken);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RequestRecognizerUpdate3"]/*' />
public void RequestRecognizerUpdate (object userToken, TimeSpan audioPositionAheadToRaiseUpdate)
{
RecoBase.RequestRecognizerUpdate (userToken, audioPositionAheadToRaiseUpdate);
}
#endregion
//*******************************************************************
//
// Public Events
//
//********************************************************************
#region public Events
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.StateChanged"]/*' />
public event EventHandler StateChanged;
// Fired when the RecognizeAsync process completes.
/// TODOC <_include file='doc\SpeechRecognitionEngine.uex' path='docs/doc[@for="SpeechRecognitionEngine.RecognizeCompleted"]/*' />
public event EventHandler EmulateRecognizeCompleted;
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.LoadGrammarCompleted"]/*' />
public event EventHandler LoadGrammarCompleted;
// The event fired when speech is detected. Used for barge-in.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechDetected"]/*' />
public event EventHandler SpeechDetected;
// The event fired on a recognition.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechRecognized"]/*' />
public event EventHandler SpeechRecognized;
// The event fired on a no recognition
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechRecognitionRejected"]/*' />
public event EventHandler SpeechRecognitionRejected;
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RecognizerUpdateReached"]/*' />
public event EventHandler RecognizerUpdateReached;
// Occurs when a spoken phrase is partially recognized.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechHypothesized"]/*' />
public event EventHandler SpeechHypothesized
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_speechHypothesizedDelegate == null)
{
RecoBase.SpeechHypothesized += SpeechHypothesizedProxy;
}
_speechHypothesizedDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_speechHypothesizedDelegate -= value;
if (_speechHypothesizedDelegate == null)
{
RecoBase.SpeechHypothesized -= SpeechHypothesizedProxy;
}
}
}
/// TODOC
public event EventHandler AudioSignalProblemOccurred
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_audioSignalProblemOccurredDelegate == null)
{
RecoBase.AudioSignalProblemOccurred += AudioSignalProblemOccurredProxy;
}
_audioSignalProblemOccurredDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_audioSignalProblemOccurredDelegate -= value;
if (_audioSignalProblemOccurredDelegate == null)
{
RecoBase.AudioSignalProblemOccurred -= AudioSignalProblemOccurredProxy;
}
}
}
/// TODOC
public event EventHandler AudioLevelUpdated
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_audioLevelUpdatedDelegate == null)
{
RecoBase.AudioLevelUpdated += AudioLevelUpdatedProxy;
}
_audioLevelUpdatedDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_audioLevelUpdatedDelegate -= value;
if (_audioLevelUpdatedDelegate == null)
{
RecoBase.AudioLevelUpdated -= AudioLevelUpdatedProxy;
}
}
}
/// TODOC
public event EventHandler AudioStateChanged
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_audioStateChangedDelegate == null)
{
RecoBase.AudioStateChanged += AudioStateChangedProxy;
}
_audioStateChangedDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_audioStateChangedDelegate -= value;
if (_audioStateChangedDelegate == null)
{
RecoBase.AudioStateChanged -= AudioStateChangedProxy;
}
}
}
#endregion
//*******************************************************************
//
// Private Methods
//
//*******************************************************************
#region Private Methods
// Proxy event handlers used to translate the sender from the RecognizerBase to this class:
private void StateChangedProxy (object sender, StateChangedEventArgs e)
{
EventHandler stateChangedHandler = StateChanged;
if (stateChangedHandler != null)
{
stateChangedHandler (this, e);
}
}
private void EmulateRecognizeCompletedProxy (object sender, EmulateRecognizeCompletedEventArgs e)
{
EventHandler emulateRecognizeCompletedHandler = EmulateRecognizeCompleted;
if (emulateRecognizeCompletedHandler != null)
{
emulateRecognizeCompletedHandler (this, e);
}
}
private void LoadGrammarCompletedProxy (object sender, LoadGrammarCompletedEventArgs e)
{
EventHandler loadGrammarCompletedHandler = LoadGrammarCompleted;
if (loadGrammarCompletedHandler != null)
{
loadGrammarCompletedHandler (this, e);
}
}
private void SpeechDetectedProxy (object sender, SpeechDetectedEventArgs e)
{
EventHandler speechDetectedHandler = SpeechDetected;
if (speechDetectedHandler != null)
{
speechDetectedHandler (this, e);
}
}
private void SpeechRecognizedProxy (object sender, SpeechRecognizedEventArgs e)
{
EventHandler speechRecognizedHandler = SpeechRecognized;
if (speechRecognizedHandler != null)
{
speechRecognizedHandler (this, e);
}
}
private void SpeechRecognitionRejectedProxy (object sender, SpeechRecognitionRejectedEventArgs e)
{
EventHandler speechRecognitionRejectedHandler = SpeechRecognitionRejected;
if (speechRecognitionRejectedHandler != null)
{
speechRecognitionRejectedHandler (this, e);
}
}
private void RecognizerUpdateReachedProxy (object sender, RecognizerUpdateReachedEventArgs e)
{
EventHandler recognizerUpdateReachedHandler = RecognizerUpdateReached;
if (recognizerUpdateReachedHandler != null)
{
recognizerUpdateReachedHandler (this, e);
}
}
private void SpeechHypothesizedProxy (object sender, SpeechHypothesizedEventArgs e)
{
EventHandler speechHypothesizedHandler = _speechHypothesizedDelegate;
if (speechHypothesizedHandler != null)
{
speechHypothesizedHandler (this, e);
}
}
private void AudioSignalProblemOccurredProxy (object sender, AudioSignalProblemOccurredEventArgs e)
{
EventHandler audioSignalProblemOccurredHandler = _audioSignalProblemOccurredDelegate;
if (audioSignalProblemOccurredHandler != null)
{
audioSignalProblemOccurredHandler (this, e);
}
}
private void AudioLevelUpdatedProxy (object sender, AudioLevelUpdatedEventArgs e)
{
EventHandler audioLevelUpdatedHandler = _audioLevelUpdatedDelegate;
if (audioLevelUpdatedHandler != null)
{
audioLevelUpdatedHandler (this, e);
}
}
private void AudioStateChangedProxy (object sender, AudioStateChangedEventArgs e)
{
EventHandler audioStateChangedHandler = _audioStateChangedDelegate;
if (audioStateChangedHandler != null)
{
audioStateChangedHandler (this, e);
}
}
#endregion
//*******************************************************************
//
// Private Properties
//
//********************************************************************
#region Private Properties
private RecognizerBase RecoBase
{
get
{
if (_disposed)
{
throw new ObjectDisposedException("SpeechRecognitionEngine");
}
if (_recognizerBase == null)
{
_recognizerBase = new RecognizerBase();
try
{
_recognizerBase.Initialize(_sapiRecognizer, false);
}
catch (COMException e)
{
throw RecognizerBase.ExceptionFromSapiCreateRecognizerError(e);
}
// This means the SpeechRecognizer will, by default, not pause after every recognition to allow updates.
PauseRecognizerOnRecognition = false;
// We always have an input on the SpeechRecognizer.
_recognizerBase._haveInputSource = true;
// If audio is already being processed then update AudioState.
if (AudioPosition != TimeSpan.Zero)
{
_recognizerBase.AudioState = AudioState.Silence; // Technically it might be Speech but that's okay.
}
// For the SpeechRecognizer the RecoState is never altered:
// - By default that will mean recognition will progress as long as one grammar is loaded and enabled.
// - If Hoolie is running it will control the RecoState.
// Add event handlers for low-overhead events:
_recognizerBase.StateChanged += StateChangedProxy;
_recognizerBase.EmulateRecognizeCompleted += EmulateRecognizeCompletedProxy;
_recognizerBase.LoadGrammarCompleted += LoadGrammarCompletedProxy;
_recognizerBase.SpeechDetected += SpeechDetectedProxy;
_recognizerBase.SpeechRecognized += SpeechRecognizedProxy;
_recognizerBase.SpeechRecognitionRejected += SpeechRecognitionRejectedProxy;
_recognizerBase.RecognizerUpdateReached += RecognizerUpdateReachedProxy;
}
return _recognizerBase;
}
}
#endregion
//*******************************************************************
//
// Private Fields
//
//********************************************************************
#region Private Fields
private bool _disposed;
private RecognizerBase _recognizerBase;
private SapiRecognizer _sapiRecognizer;
private EventHandler _audioSignalProblemOccurredDelegate;
private EventHandler _audioLevelUpdatedDelegate;
private EventHandler _audioStateChangedDelegate;
private EventHandler _speechHypothesizedDelegate;
#endregion
}
}
#endif
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------
#if !SPEECHSERVER
using System;
using System.Globalization;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;
using System.Runtime.Serialization;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Speech.Internal;
using System.Speech.Internal.SapiInterop;
using System.Speech.AudioFormat;
namespace System.Speech.Recognition
{
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer"]/*' />
public class SpeechRecognizer : IDisposable
{
//*******************************************************************
//
// Constructors
//
//*******************************************************************
#region Constructors
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechRecognizer"]/*' />
public SpeechRecognizer ()
{
_sapiRecognizer = new SapiRecognizer (SapiRecognizer.RecognizerType.Shared);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Dispose1"]/*' />
public void Dispose ()
{
Dispose (true);
GC.SuppressFinalize (this);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Dispose2"]/*' />
protected virtual void Dispose (bool disposing)
{
if (disposing && !_disposed)
{
if (_recognizerBase != null)
{
_recognizerBase.Dispose();
_recognizerBase = null;
}
if (_sapiRecognizer != null)
{
_sapiRecognizer.Dispose();
_sapiRecognizer = null;
}
_disposed = true; // Don't set RecognizerBase to null as every method will then need to throw ObjectDisposedException.
}
}
#endregion
//********************************************************************
//
// Public Properties
//
//*******************************************************************
#region public Properties
// Determines whether the recognizer is listening or not.
//
public RecognizerState State
{
get { return RecoBase.State; }
}
// Are the grammars attached to this SpeechRecognizer active? Default = true
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Enabled"]/*' />
public bool Enabled
{
get { return RecoBase.Enabled; }
set { RecoBase.Enabled = value; }
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.PauseRecognizerOnRecognition"]/*' />
public bool PauseRecognizerOnRecognition
{
get { return RecoBase.PauseRecognizerOnRecognition; }
set { RecoBase.PauseRecognizerOnRecognition = value; }
}
// Gives access to the collection of grammars that are currently active. Read-only.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.Grammars"]/*' />
public ReadOnlyCollection Grammars
{
get { return RecoBase.Grammars; }
}
// Gives access to the set of attributes exposed by this recognizer.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RecognizerInfo"]/*' />
public RecognizerInfo RecognizerInfo
{
get { return RecoBase.RecognizerInfo; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public AudioState AudioState
{
get { return RecoBase.AudioState; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public int AudioLevel
{
get { return RecoBase.AudioLevel; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public TimeSpan AudioPosition
{
get { return RecoBase.AudioPosition; }
}
// Data on the audio stream the recognizer is processing
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioStatus"]/*' />
public TimeSpan RecognizerAudioPosition
{
get { return RecoBase.RecognizerAudioPosition; }
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.AudioFormat"]/*' />
public SpeechAudioFormatInfo AudioFormat
{
get { return RecoBase.AudioFormat; }
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.MaxAlternates"]/*' />
public int MaxAlternates
{
get { return RecoBase.MaxAlternates; }
set { RecoBase.MaxAlternates = value; }
}
/*
*/
#endregion
//********************************************************************
//
// Public Methods
//
//********************************************************************
#region public Methods
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.LoadGrammar"]/*' />
public void LoadGrammar (Grammar grammar)
{
RecoBase.LoadGrammar (grammar);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.LoadGrammarAsync"]/*' />
public void LoadGrammarAsync (Grammar grammar)
{
RecoBase.LoadGrammarAsync (grammar);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.UnloadGrammar"]/*' />
public void UnloadGrammar (Grammar grammar)
{
RecoBase.UnloadGrammar (grammar);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.UnloadAllGrammars"]/*' />
public void UnloadAllGrammars ()
{
RecoBase.UnloadAllGrammars ();
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize1"]/*' />
public RecognitionResult EmulateRecognize (string inputText)
{
if (Enabled)
{
return RecoBase.EmulateRecognize (inputText);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public RecognitionResult EmulateRecognize (string inputText, CompareOptions compareOptions)
{
if (Enabled)
{
return RecoBase.EmulateRecognize (inputText, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public RecognitionResult EmulateRecognize (RecognizedWordUnit [] wordUnits, CompareOptions compareOptions)
{
if (Enabled)
{
return RecoBase.EmulateRecognize (wordUnits, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize1"]/*' />
public void EmulateRecognizeAsync (string inputText)
{
if (Enabled)
{
RecoBase.EmulateRecognizeAsync (inputText);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public void EmulateRecognizeAsync (string inputText, CompareOptions compareOptions)
{
if (Enabled)
{
RecoBase.EmulateRecognizeAsync (inputText, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.EmulateRecognize2"]/*' />
public void EmulateRecognizeAsync (RecognizedWordUnit [] wordUnits, CompareOptions compareOptions)
{
if (Enabled)
{
RecoBase.EmulateRecognizeAsync (wordUnits, compareOptions);
}
else
{
throw new InvalidOperationException (SR.Get (SRID.RecognizerNotEnabled));
}
}
// Methods to pause the recognizer to do atomic updates:
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RequestRecognizerUpdate1"]/*' />
public void RequestRecognizerUpdate ()
{
RecoBase.RequestRecognizerUpdate ();
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RequestRecognizerUpdate2"]/*' />
public void RequestRecognizerUpdate (object userToken)
{
RecoBase.RequestRecognizerUpdate (userToken);
}
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RequestRecognizerUpdate3"]/*' />
public void RequestRecognizerUpdate (object userToken, TimeSpan audioPositionAheadToRaiseUpdate)
{
RecoBase.RequestRecognizerUpdate (userToken, audioPositionAheadToRaiseUpdate);
}
#endregion
//*******************************************************************
//
// Public Events
//
//********************************************************************
#region public Events
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.StateChanged"]/*' />
public event EventHandler StateChanged;
// Fired when the RecognizeAsync process completes.
/// TODOC <_include file='doc\SpeechRecognitionEngine.uex' path='docs/doc[@for="SpeechRecognitionEngine.RecognizeCompleted"]/*' />
public event EventHandler EmulateRecognizeCompleted;
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.LoadGrammarCompleted"]/*' />
public event EventHandler LoadGrammarCompleted;
// The event fired when speech is detected. Used for barge-in.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechDetected"]/*' />
public event EventHandler SpeechDetected;
// The event fired on a recognition.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechRecognized"]/*' />
public event EventHandler SpeechRecognized;
// The event fired on a no recognition
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechRecognitionRejected"]/*' />
public event EventHandler SpeechRecognitionRejected;
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.RecognizerUpdateReached"]/*' />
public event EventHandler RecognizerUpdateReached;
// Occurs when a spoken phrase is partially recognized.
/// TODOC <_include file='doc\SpeechRecognizer.uex' path='docs/doc[@for="SpeechRecognizer.SpeechHypothesized"]/*' />
public event EventHandler SpeechHypothesized
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_speechHypothesizedDelegate == null)
{
RecoBase.SpeechHypothesized += SpeechHypothesizedProxy;
}
_speechHypothesizedDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_speechHypothesizedDelegate -= value;
if (_speechHypothesizedDelegate == null)
{
RecoBase.SpeechHypothesized -= SpeechHypothesizedProxy;
}
}
}
/// TODOC
public event EventHandler AudioSignalProblemOccurred
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_audioSignalProblemOccurredDelegate == null)
{
RecoBase.AudioSignalProblemOccurred += AudioSignalProblemOccurredProxy;
}
_audioSignalProblemOccurredDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_audioSignalProblemOccurredDelegate -= value;
if (_audioSignalProblemOccurredDelegate == null)
{
RecoBase.AudioSignalProblemOccurred -= AudioSignalProblemOccurredProxy;
}
}
}
/// TODOC
public event EventHandler AudioLevelUpdated
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_audioLevelUpdatedDelegate == null)
{
RecoBase.AudioLevelUpdated += AudioLevelUpdatedProxy;
}
_audioLevelUpdatedDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_audioLevelUpdatedDelegate -= value;
if (_audioLevelUpdatedDelegate == null)
{
RecoBase.AudioLevelUpdated -= AudioLevelUpdatedProxy;
}
}
}
/// TODOC
public event EventHandler AudioStateChanged
{
[MethodImplAttribute (MethodImplOptions.Synchronized)]
add
{
Helpers.ThrowIfNull (value, "value");
if (_audioStateChangedDelegate == null)
{
RecoBase.AudioStateChanged += AudioStateChangedProxy;
}
_audioStateChangedDelegate += value;
}
[MethodImplAttribute (MethodImplOptions.Synchronized)]
remove
{
Helpers.ThrowIfNull (value, "value");
_audioStateChangedDelegate -= value;
if (_audioStateChangedDelegate == null)
{
RecoBase.AudioStateChanged -= AudioStateChangedProxy;
}
}
}
#endregion
//*******************************************************************
//
// Private Methods
//
//*******************************************************************
#region Private Methods
// Proxy event handlers used to translate the sender from the RecognizerBase to this class:
private void StateChangedProxy (object sender, StateChangedEventArgs e)
{
EventHandler stateChangedHandler = StateChanged;
if (stateChangedHandler != null)
{
stateChangedHandler (this, e);
}
}
private void EmulateRecognizeCompletedProxy (object sender, EmulateRecognizeCompletedEventArgs e)
{
EventHandler emulateRecognizeCompletedHandler = EmulateRecognizeCompleted;
if (emulateRecognizeCompletedHandler != null)
{
emulateRecognizeCompletedHandler (this, e);
}
}
private void LoadGrammarCompletedProxy (object sender, LoadGrammarCompletedEventArgs e)
{
EventHandler loadGrammarCompletedHandler = LoadGrammarCompleted;
if (loadGrammarCompletedHandler != null)
{
loadGrammarCompletedHandler (this, e);
}
}
private void SpeechDetectedProxy (object sender, SpeechDetectedEventArgs e)
{
EventHandler speechDetectedHandler = SpeechDetected;
if (speechDetectedHandler != null)
{
speechDetectedHandler (this, e);
}
}
private void SpeechRecognizedProxy (object sender, SpeechRecognizedEventArgs e)
{
EventHandler speechRecognizedHandler = SpeechRecognized;
if (speechRecognizedHandler != null)
{
speechRecognizedHandler (this, e);
}
}
private void SpeechRecognitionRejectedProxy (object sender, SpeechRecognitionRejectedEventArgs e)
{
EventHandler speechRecognitionRejectedHandler = SpeechRecognitionRejected;
if (speechRecognitionRejectedHandler != null)
{
speechRecognitionRejectedHandler (this, e);
}
}
private void RecognizerUpdateReachedProxy (object sender, RecognizerUpdateReachedEventArgs e)
{
EventHandler recognizerUpdateReachedHandler = RecognizerUpdateReached;
if (recognizerUpdateReachedHandler != null)
{
recognizerUpdateReachedHandler (this, e);
}
}
private void SpeechHypothesizedProxy (object sender, SpeechHypothesizedEventArgs e)
{
EventHandler speechHypothesizedHandler = _speechHypothesizedDelegate;
if (speechHypothesizedHandler != null)
{
speechHypothesizedHandler (this, e);
}
}
private void AudioSignalProblemOccurredProxy (object sender, AudioSignalProblemOccurredEventArgs e)
{
EventHandler audioSignalProblemOccurredHandler = _audioSignalProblemOccurredDelegate;
if (audioSignalProblemOccurredHandler != null)
{
audioSignalProblemOccurredHandler (this, e);
}
}
private void AudioLevelUpdatedProxy (object sender, AudioLevelUpdatedEventArgs e)
{
EventHandler audioLevelUpdatedHandler = _audioLevelUpdatedDelegate;
if (audioLevelUpdatedHandler != null)
{
audioLevelUpdatedHandler (this, e);
}
}
private void AudioStateChangedProxy (object sender, AudioStateChangedEventArgs e)
{
EventHandler audioStateChangedHandler = _audioStateChangedDelegate;
if (audioStateChangedHandler != null)
{
audioStateChangedHandler (this, e);
}
}
#endregion
//*******************************************************************
//
// Private Properties
//
//********************************************************************
#region Private Properties
private RecognizerBase RecoBase
{
get
{
if (_disposed)
{
throw new ObjectDisposedException("SpeechRecognitionEngine");
}
if (_recognizerBase == null)
{
_recognizerBase = new RecognizerBase();
try
{
_recognizerBase.Initialize(_sapiRecognizer, false);
}
catch (COMException e)
{
throw RecognizerBase.ExceptionFromSapiCreateRecognizerError(e);
}
// This means the SpeechRecognizer will, by default, not pause after every recognition to allow updates.
PauseRecognizerOnRecognition = false;
// We always have an input on the SpeechRecognizer.
_recognizerBase._haveInputSource = true;
// If audio is already being processed then update AudioState.
if (AudioPosition != TimeSpan.Zero)
{
_recognizerBase.AudioState = AudioState.Silence; // Technically it might be Speech but that's okay.
}
// For the SpeechRecognizer the RecoState is never altered:
// - By default that will mean recognition will progress as long as one grammar is loaded and enabled.
// - If Hoolie is running it will control the RecoState.
// Add event handlers for low-overhead events:
_recognizerBase.StateChanged += StateChangedProxy;
_recognizerBase.EmulateRecognizeCompleted += EmulateRecognizeCompletedProxy;
_recognizerBase.LoadGrammarCompleted += LoadGrammarCompletedProxy;
_recognizerBase.SpeechDetected += SpeechDetectedProxy;
_recognizerBase.SpeechRecognized += SpeechRecognizedProxy;
_recognizerBase.SpeechRecognitionRejected += SpeechRecognitionRejectedProxy;
_recognizerBase.RecognizerUpdateReached += RecognizerUpdateReachedProxy;
}
return _recognizerBase;
}
}
#endregion
//*******************************************************************
//
// Private Fields
//
//********************************************************************
#region Private Fields
private bool _disposed;
private RecognizerBase _recognizerBase;
private SapiRecognizer _sapiRecognizer;
private EventHandler _audioSignalProblemOccurredDelegate;
private EventHandler _audioLevelUpdatedDelegate;
private EventHandler _audioStateChangedDelegate;
private EventHandler _speechHypothesizedDelegate;
#endregion
}
}
#endif
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- WeakEventManager.cs
- EventData.cs
- filewebresponse.cs
- TextMarkerSource.cs
- HitTestParameters.cs
- CallInfo.cs
- RequiredFieldValidator.cs
- ModuleBuilder.cs
- DataExpression.cs
- ObjectListSelectEventArgs.cs
- WindowsToolbarItemAsMenuItem.cs
- DataGridLinkButton.cs
- FilteredXmlReader.cs
- ExpressionBuilder.cs
- QueryResultOp.cs
- HttpProfileBase.cs
- SecurityKeyIdentifier.cs
- ServiceHostingEnvironment.cs
- RNGCryptoServiceProvider.cs
- PermissionAttributes.cs
- ListParagraph.cs
- SelectorItemAutomationPeer.cs
- _KerberosClient.cs
- SecurityKeyType.cs
- TTSEvent.cs
- SecurityUtils.cs
- ColorConvertedBitmap.cs
- ObjectTag.cs
- TextSelectionHelper.cs
- ConstraintStruct.cs
- SimpleMailWebEventProvider.cs
- HttpPostedFileWrapper.cs
- SelectionPattern.cs
- AutoResizedEvent.cs
- RuntimeArgumentHandle.cs
- WebPartTransformer.cs
- CacheEntry.cs
- TreeNodeStyleCollection.cs
- ChannelSinkStacks.cs
- ColorMatrix.cs
- CodeExpressionCollection.cs
- PermissionRequestEvidence.cs
- AsyncOperationManager.cs
- SafeHandles.cs
- DebugController.cs
- PackagingUtilities.cs
- ConfigurationProperty.cs
- CustomErrorsSectionWrapper.cs
- TreeNodeStyle.cs
- OfTypeExpression.cs
- DesignerVerb.cs
- XPathNodeIterator.cs
- CollectionBuilder.cs
- SchemaConstraints.cs
- SettingsPropertyWrongTypeException.cs
- XmlSchemaComplexContentExtension.cs
- TraceUtility.cs
- Config.cs
- ApplicationProxyInternal.cs
- ContentIterators.cs
- DataStreamFromComStream.cs
- WebReference.cs
- CodeSubDirectoriesCollection.cs
- PrimitiveXmlSerializers.cs
- EventLogPermissionEntry.cs
- XPathNavigatorKeyComparer.cs
- SqlErrorCollection.cs
- BitVec.cs
- COM2EnumConverter.cs
- EntityContainerAssociationSetEnd.cs
- PointAnimation.cs
- AdornerLayer.cs
- AutomationPeer.cs
- GradientStopCollection.cs
- GetPageNumberCompletedEventArgs.cs
- ToolStripMenuItemDesigner.cs
- ProgressBar.cs
- WebBrowsableAttribute.cs
- UnderstoodHeaders.cs
- AdRotator.cs
- X509CertificateCollection.cs
- BatchParser.cs
- base64Transforms.cs
- SignalGate.cs
- SecurityStandardsManager.cs
- GridViewRowPresenter.cs
- TemplateControlParser.cs
- PenCursorManager.cs
- ResizeGrip.cs
- DefaultProxySection.cs
- SqlDataSourceFilteringEventArgs.cs
- StyleSheetRefUrlEditor.cs
- MaskPropertyEditor.cs
- AppSettingsReader.cs
- LocalValueEnumerator.cs
- EpmSourcePathSegment.cs
- RootAction.cs
- CellQuery.cs
- Listbox.cs
- MenuStrip.cs