SpeechRecognizer 類別

定義

命名空間:

System.Speech.Recognition

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-preview.3.24172.9

來源:

SpeechRecognizer.cs

為 Windows 桌面上共用的語音辨識服務提供存取。

public ref class SpeechRecognizer : IDisposable

public class SpeechRecognizer : IDisposable

type SpeechRecognizer = class
    interface IDisposable

Public Class SpeechRecognizer
Implements IDisposable

繼承

Object

SpeechRecognizer

實作

IDisposable

範例

下列範例是主控台應用程式的一部分，它會載入語音辨識文法，並示範非同步模擬輸入、相關聯的辨識結果，以及語音辨識器所引發的相關事件。 如果 Windows 語音辨識未執行，則啟動此應用程式也會啟動 Windows 語音辨識。 如果 Windows 語音辨識處於 睡眠 狀態，則 EmulateRecognizeAsync 一律會傳回 Null。

using System;  
using System.Speech.Recognition;  
using System.Threading;  

namespace SharedRecognizer  
{  
  class Program  
  {  

    // Indicate whether the asynchronous emulate recognition  
    // operation has completed.  
    static bool completed;  

    static void Main(string[] args)  
    {  

      // Initialize an instance of the shared recognizer.  
      using (SpeechRecognizer recognizer = new SpeechRecognizer())  
      {  

        // Create and load a sample grammar.  
        Grammar testGrammar =  
          new Grammar(new GrammarBuilder("testing testing"));  
        testGrammar.Name = "Test Grammar";  
        recognizer.LoadGrammar(testGrammar);  

        // Attach event handlers for recognition events.  
        recognizer.SpeechRecognized +=  
          new EventHandler<SpeechRecognizedEventArgs>(  
            SpeechRecognizedHandler);  
        recognizer.EmulateRecognizeCompleted +=  
          new EventHandler<EmulateRecognizeCompletedEventArgs>(  
            EmulateRecognizeCompletedHandler);  

        completed = false;  

        // Start asynchronous emulated recognition.   
        // This matches the grammar and generates a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing testing");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  

        completed = false;  

        // Start asynchronous emulated recognition.  
        // This does not match the grammar or generate a SpeechRecognized event.  
        recognizer.EmulateRecognizeAsync("testing one two three");  

        // Wait for the asynchronous operation to complete.  
        while (!completed)  
        {  
          Thread.Sleep(333);  
        }  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  

    // Handle the SpeechRecognized event.  
    static void SpeechRecognizedHandler(  
      object sender, SpeechRecognizedEventArgs e)  
    {  
      if (e.Result != null)  
      {  
        Console.WriteLine("Recognition result = {0}",  
          e.Result.Text ?? "<no text>");  
      }  
      else  
      {  
        Console.WriteLine("No recognition result");  
      }  
    }  

    // Handle the SpeechRecognizeCompleted event.  
    static void EmulateRecognizeCompletedHandler(  
      object sender, EmulateRecognizeCompletedEventArgs e)  
    {  
      if (e.Result == null)  
      {  
        Console.WriteLine("No result generated.");  
      }  

      // Indicate the asynchronous operation is complete.  
      completed = true;  
    }  
  }  
}  

備註

應用程式會使用共用辨識器來存取 Windows 語音辨識。 SpeechRecognizer使用 物件將 新增至 Windows 語音使用者體驗。

這個類別可控制語音辨識程式的各種層面：

• 若要管理語音辨識文法，請使用 LoadGrammar 、 LoadGrammarAsync 、 UnloadGrammar 、 UnloadAllGrammars 和 Grammars 。

• 若要取得目前語音辨識作業的相關資訊，請訂閱 SpeechRecognizer 的 SpeechDetected 、 SpeechHypothesized 、 SpeechRecognitionRejected 和 SpeechRecognized 事件。

• 若要檢視或修改辨識器傳回的替代結果數目，請使用 MaxAlternates 屬性。 辨識器會傳回 物件中的 RecognitionResult 辨識結果。

• 若要存取或監視共用辨識器的狀態，請使用 AudioLevel 、 AudioPosition 、 AudioState 、 PauseRecognizerOnRecognitionEnabled 、、、 RecognizerAudioPosition 和 State 屬性和 AudioLevelUpdated 、 AudioSignalProblemOccurredAudioStateChanged 、 和 StateChanged 事件。

• 若要同步處理辨識器的變更，請使用 RequestRecognizerUpdate 方法。 共用辨識器會使用一個以上的執行緒來執行工作。

• 若要模擬共用辨識器的輸入，請使用 EmulateRecognize 和 EmulateRecognizeAsync 方法。

Windows 語音辨識的設定是由主控台中的 [語音屬性] 對話方塊使用來管理。 此介面可用來選取預設桌面語音辨識引擎和語言、音訊輸入裝置，以及語音辨識的睡眠行為。 如果在應用程式執行時變更 Windows 語音辨識的組態， (例如，如果停用語音辨識或輸入語言) 變更，則變更會影響所有 SpeechRecognizer 物件。

若要建立與 Windows 語音辨識無關的進程語音辨識器，請使用 SpeechRecognitionEngine 類別。

注意

一律先呼叫 Dispose ，再釋放對語音辨識器的最後一個參考。 否則，在垃圾收集行程呼叫辨識器物件的 Finalize 方法之前，將不會釋放它所使用的資源。

建構函式

SpeechRecognizer()

初始化 SpeechRecognizer 類別的新執行個體。

屬性

AudioFormat	取得語音辨識器所接收的音訊格式。
AudioLevel	取得語音辨識器所接收的音訊層級。
AudioPosition	取得提供語音辨識器輸入的裝置正在產生的音訊資料流中目前的位置。
AudioState	取得語音辨識器所接收的音訊狀態。
Enabled	取得或設定值，這個值表示這個 SpeechRecognizer 物件是否準備好可以處理語音。
Grammars	取得在這個 Grammar 執行個體中載入之 SpeechRecognizer 物件的集合。
MaxAlternates	取得或設定共用辨識器為每個辨識作業傳回之替代辨識結果的最大數目。
PauseRecognizerOnRecognition	取得或設定值，這個值表示當應用程式正在處理 SpeechRecognized 事件時，共用辨識器是否會暫停辨識作業。
RecognizerAudioPosition	取得辨識器正在處理的音訊輸入的目前位置。
RecognizerInfo	取得共用語音辨識器的相關資訊。
State	取得 SpeechRecognizer 物件的狀態。

方法

Dispose()	處置 SpeechRecognizer 物件。
Dispose(Boolean)	處置 SpeechRecognizer 物件，並釋放工作階段期間所使用的資源。
EmulateRecognize(RecognizedWordUnit[], CompareOptions)	在共用的語音辨識器上模擬特定單字輸入，針對同步的語音辨識使用文字而不使用音訊，並指定辨識器如何處理單字間的 Unicode 比較以及已載入的語音辨識文法。
EmulateRecognize(String)	在共用的語音辨識器上模擬片語輸入，針對同步的語音辨識使用文字而不使用音訊。
EmulateRecognize(String, CompareOptions)	在共用的語音辨識器上模擬片語輸入，針對同步的語音辨識使用文字而不使用音訊，並指定辨識器如何處理片語間的 Unicode 比較以及已載入的語音辨識文法。
EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)	在共用的語音辨識器上模擬特定單字輸入，針對非同步的語音辨識使用文字而不使用音訊，並指定辨識器如何處理單字間的 Unicode 比較以及已載入的語音辨識文法。
EmulateRecognizeAsync(String)	在共用的語音辨識器上模擬片語輸入，針對非同步的語音辨識使用文字而不使用音訊。
EmulateRecognizeAsync(String, CompareOptions)	在共用的語音辨識器上模擬片語輸入，針對非同步的語音辨識使用文字而不使用音訊，並指定辨識器如何處理片語間的 Unicode 比較以及已載入的語音辨識文法。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
LoadGrammar(Grammar)	載入語音辨識文法。
LoadGrammarAsync(Grammar)	以非同步方式載入語音辨識文法。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
RequestRecognizerUpdate()	要求共用辨識器暫停並更新其狀態。
RequestRecognizerUpdate(Object)	要求共用辨識器暫停並更新其狀態，以及提供相關聯事件的使用者語彙基元。
RequestRecognizerUpdate(Object, TimeSpan)	要求共用辨識器暫停並更新其狀態，以及提供相關聯事件的位移和使用者語彙基元。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
UnloadAllGrammars()	從共用辨識器卸載所有語音辨識文法。
UnloadGrammar(Grammar)	從共用辨識器卸載指定的語音辨識文法。

事件

AudioLevelUpdated	當共用辨識器報告其音訊輸入層級時發生。
AudioSignalProblemOccurred	在辨識器遇到音訊訊號的問題時發生。
AudioStateChanged	在辨識器所接收的音訊變更狀態時發生。
EmulateRecognizeCompleted	共用辨識器針對模擬輸入完成非同步辨識作業時發生。
LoadGrammarCompleted	在辨識器完成語音辨識文法的非同步載入時發生。
RecognizerUpdateReached	在辨識器暫停以同步處理辨識和其他作業時發生。
SpeechDetected	當辨識器偵測到可辨識為語音的輸入時發生。
SpeechHypothesized	在辨識器已辨識的文字可能是文法中多個完整片語的元件時發生。
SpeechRecognitionRejected	當辨識器接收到不符合任何已載入的語音辨識文法的輸入時發生。
SpeechRecognized	當辨識器接收到符合其中一個語音辨識文法的輸入時發生。
StateChanged	當 Windows 桌面語音技術辨識引擎的執行狀態變更時發生。

另請參閱

• SpeechRecognitionEngine
• Grammar
• RecognitionResult