SpeechRecognitionEngine Třída

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Poskytuje prostředky pro přístup a správu modulu pro rozpoznávání řeči v procesu.

public ref class SpeechRecognitionEngine : IDisposable

public class SpeechRecognitionEngine : IDisposable

type SpeechRecognitionEngine = class
    interface IDisposable

Public Class SpeechRecognitionEngine
Implements IDisposable

Dědičnost

Object

SpeechRecognitionEngine

Implementuje

IDisposable

Příklady

Následující příklad ukazuje část konzolové aplikace, která ukazuje základní rozpoznávání řeči. Vzhledem k tomu, že v tomto příkladu je použit Multiple režim RecognizeAsync metody, provede rozpoznávání, dokud nezavřete okno konzoly nebo nezastavíte ladění.

using System;  
using System.Speech.Recognition;  

namespace SpeechRecognitionApp  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Create an in-process speech recognizer for the en-US locale.  
      using (  
      SpeechRecognitionEngine recognizer =  
        new SpeechRecognitionEngine(  
          new System.Globalization.CultureInfo("en-US")))  
      {  

        // Create and load a dictation grammar.  
        recognizer.LoadGrammar(new DictationGrammar());  

        // Add a handler for the speech recognized event.  
        recognizer.SpeechRecognized +=   
          new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);  

        // Configure input to the speech recognizer.  
        recognizer.SetInputToDefaultAudioDevice();  

        // Start asynchronous, continuous speech recognition.  
        recognizer.RecognizeAsync(RecognizeMode.Multiple);  

        // Keep the console window open.  
        while (true)  
        {  
          Console.ReadLine();  
        }  
      }  
    }  

    // Handle the SpeechRecognized event.  
    static void recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)  
    {  
      Console.WriteLine("Recognized text: " + e.Result.Text);  
    }  
  }  
}  

Poznámky

Pro všechny nainstalované nástroje pro rozpoznávání řeči můžete vytvořit instanci této třídy. Chcete-li získat informace o tom, které funkce pro rozpoznávání jsou nainstalovány, použijte statickou InstalledRecognizers metodu.

Tato třída slouží ke spouštění modulů pro rozpoznávání řeči v procesu a poskytuje kontrolu nad různými aspekty rozpoznávání řeči, a to takto:

• Chcete-li vytvořit nástroj pro rozpoznávání řeči v procesu, použijte jeden z SpeechRecognitionEngine konstruktorů.

• Chcete-li spravovat gramatiky rozpoznávání řeči, LoadGrammar použijte LoadGrammarAsync metody,, a UnloadGrammar UnloadAllGrammars a Grammars vlastnost.

• Ke konfiguraci vstupu na nástroj pro rozpoznávání použijte SetInputToAudioStream SetInputToDefaultAudioDevice metodu,, SetInputToNull , SetInputToWaveFile nebo SetInputToWaveStream .

• Chcete-li provést rozpoznávání řeči, Recognize použijte RecognizeAsync metodu nebo.

• Chcete-li změnit způsob, jakým obslužné rutiny zpracovávají tiché nebo neočekávané vstupy, použijte BabbleTimeout InitialSilenceTimeout vlastnosti,, EndSilenceTimeout a EndSilenceTimeoutAmbiguous .

• Chcete-li změnit počet náhradníků, které nástroj pro rozpoznávání vrátí, použijte MaxAlternates vlastnost. Nástroj pro rozpoznávání vrátí výsledky rozpoznávání v RecognitionResult objektu.

• Chcete-li synchronizovat změny v nástroji pro rozpoznávání, použijte RequestRecognizerUpdate metodu. Nástroj pro rozpoznávání používá k provádění úkolů více než jedno vlákno.

• Pro emulaci vstupu ke službě pro rozpoznávání použijte EmulateRecognize EmulateRecognizeAsync metody a.

SpeechRecognitionEngineObjekt je určen výhradně pro použití procesu, který vytvořil instanci objektu. Naproti tomu SpeechRecognizer sdílí jeden nástroj pro rozpoznávání s libovolnou aplikací, která ho chce použít.

Poznámka

Vždy volejte Dispose před vydáním poslední odkaz na nástroj pro rozpoznávání řeči. V opačném případě nebudou prostředky, které používá, uvolněny, dokud systém uvolňování paměti nevolá metodu objektu pro rozpoznávání Finalize .

Konstruktory

SpeechRecognitionEngine()	Inicializuje novou instanci SpeechRecognitionEngine třídy pomocí výchozího nástroje pro rozpoznávání řeči pro systém.
SpeechRecognitionEngine(CultureInfo)	Inicializuje novou instanci SpeechRecognitionEngine třídy pomocí výchozího nástroje pro rozpoznávání řeči pro zadané národní prostředí.
SpeechRecognitionEngine(RecognizerInfo)	Inicializuje novou instanci s SpeechRecognitionEngine použitím informací v RecognizerInfo objektu pro určení nástroje pro rozpoznávání, který se má použít.
SpeechRecognitionEngine(String)	Inicializuje novou instanci SpeechRecognitionEngine třídy s parametrem řetězce, který určuje název nástroje pro rozpoznávání, který se má použít.

Vlastnosti

AudioFormat	Získá formát zvuku, který přijímá SpeechRecognitionEngine .
AudioLevel	Získá úroveň zvuk, který přijímá SpeechRecognitionEngine .
AudioPosition	Získá aktuální umístění ve zvukovém streamu vygenerovaném zařízením, které poskytuje vstup do SpeechRecognitionEngine .
AudioState	Získá stav zvukového zvuku, který přijímá SpeechRecognitionEngine .
BabbleTimeout	Získá nebo nastaví časový interval, během kterého SpeechRecognitionEngine přijímá vstup obsahující jenom šum na pozadí před dokončením rozpoznávání.
EndSilenceTimeout	Získá nebo nastaví interval tichosti, který SpeechRecognitionEngine bude souhlasit na konci jednoznačného vstupu před dokončením operace rozpoznávání.
EndSilenceTimeoutAmbiguous	Získá nebo nastaví interval tichosti, který SpeechRecognitionEngine bude souhlasit na konci dvojznačného vstupu před dokončením operace rozpoznávání.
Grammars	Získá kolekci Grammar objektů, které jsou načteny v této SpeechRecognitionEngine instanci.
InitialSilenceTimeout	Získá nebo nastaví časový interval, během kterého bude SpeechRecognitionEngine přijmout vstup obsahující pouze ticho před dokončením rozpoznávání.
MaxAlternates	Získá nebo nastaví maximální počet alternativních výsledků rozpoznávání, které SpeechRecognitionEngine vrátí pro jednotlivé operace rozpoznávání.
RecognizerAudioPosition	Získá aktuální umístění SpeechRecognitionEngine zvukového vstupu, který zpracovává.
RecognizerInfo	Získá informace o aktuální instanci SpeechRecognitionEngine .

Metody

Dispose()	Odstraní SpeechRecognitionEngine objekt.
Dispose(Boolean)	Odstraní SpeechRecognitionEngine objekt a uvolní prostředky použité během relace.
EmulateRecognize(RecognizedWordUnit[], CompareOptions)	Emuluje vstup konkrétního slova na nástroj pro rozpoznávání řeči pomocí textu místo zvuku pro synchronní rozpoznávání řeči a určuje, jak Nástroj pro rozpoznávání zpracovává porovnání Unicode mezi slovy a gramatikami načteného rozpoznávání řeči.
EmulateRecognize(String)	Emuluje vstup fráze na nástroj pro rozpoznávání řeči pomocí textu místo zvuku pro synchronní rozpoznávání řeči.
EmulateRecognize(String, CompareOptions)	Emuluje vstup fráze pro rozpoznávání řeči pomocí textu místo zvuku pro synchronní rozpoznávání řeči a určuje, jak Nástroj pro rozpoznávání zpracovává porovnání Unicode mezi frází a gramatikami načteného rozpoznávání řeči.
EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)	Emuluje vstup konkrétních slov na nástroj pro rozpoznávání řeči pomocí pole RecognizedWordUnit objektů místo zvuku pro asynchronní rozpoznávání řeči a určuje, jak Nástroj pro rozpoznávání zpracovává porovnání Unicode mezi slovy a gramatikami načteného rozpoznávání řeči.
EmulateRecognizeAsync(String)	Emuluje vstup fráze na nástroj pro rozpoznávání řeči pomocí textu místo zvuku pro asynchronní rozpoznávání řeči.
EmulateRecognizeAsync(String, CompareOptions)	Emuluje vstup fráze na nástroj pro rozpoznávání řeči pomocí textu místo zvuku pro asynchronní rozpoznávání řeči a určuje, jak má nástroj pro rozpoznávání zpracovat porovnání Unicode mezi frází a gramatikami načteného rozpoznávání řeči.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
InstalledRecognizers()	Vrátí informace pro všechny nainstalované nástroje pro rozpoznávání řeči v aktuálním systému.
LoadGrammar(Grammar)	Synchronně načte Grammar objekt.
LoadGrammarAsync(Grammar)	Asynchronně načte gramatiku rozpoznávání řeči.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
QueryRecognizerSetting(String)	Vrátí hodnoty nastavení pro nástroj pro rozpoznávání.
Recognize()	Provede synchronní operaci rozpoznávání řeči.
Recognize(TimeSpan)	Provede synchronní operaci rozpoznávání řeči se zadaným počátečním časovým limitem tichého spuštění.
RecognizeAsync()	Provede jednu asynchronní operaci rozpoznávání řeči.
RecognizeAsync(RecognizeMode)	Provádí jednu nebo více asynchronních operací rozpoznávání řeči.
RecognizeAsyncCancel()	Ukončí asynchronní rozpoznávání bez čekání na dokončení aktuální operace rozpoznávání.
RecognizeAsyncStop()	Po dokončení aktuální operace rozpoznávání zastaví asynchronní rozpoznávání.
RequestRecognizerUpdate()	Požaduje, aby nástroj pro rozpoznávání pozastaven, aby aktualizoval svůj stav.
RequestRecognizerUpdate(Object)	Požaduje, aby nástroj pro rozpoznávání pozastaven, aby aktualizoval svůj stav a poskytoval token uživatele pro přidruženou událost.
RequestRecognizerUpdate(Object, TimeSpan)	Požaduje, aby nástroj pro rozpoznávání pozastavil aktualizaci svého stavu a pro přidruženou událost poskytoval posun a token uživatele.
SetInputToAudioStream(Stream, SpeechAudioFormatInfo)	Nakonfiguruje SpeechRecognitionEngine objekt tak, aby přijímal vstup ze zvukového datového proudu.
SetInputToDefaultAudioDevice()	Nakonfiguruje SpeechRecognitionEngine objekt tak, aby přijímal vstup z výchozího zvukového zařízení.
SetInputToNull()	Zakáže vstup do nástroje pro rozpoznávání řeči.
SetInputToWaveFile(String)	Nakonfiguruje SpeechRecognitionEngine objekt tak, aby přijímal vstup ze souboru formátu WAV (Wave audio Format).
SetInputToWaveStream(Stream)	Nakonfiguruje SpeechRecognitionEngine objekt tak, aby přijímal vstup z datového proudu, který obsahuje data formátu WAV (Wave audio Format).
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UnloadAllGrammars()	Uvolní všechny Grammar objekty z nástroje pro rozpoznávání.
UnloadGrammar(Grammar)	Uvolní zadaný Grammar objekt z SpeechRecognitionEngine instance.
UpdateRecognizerSetting(String, Int32)	Aktualizuje zadané nastavení pro SpeechRecognitionEngine zadanou celočíselnou hodnotu.
UpdateRecognizerSetting(String, String)	Aktualizuje zadané nastavení modulu rozpoznávání řeči zadanou hodnotou řetězce.

událost

AudioLevelUpdated	Je aktivována, když SpeechRecognitionEngine aplikace hlásí úroveň jejího vstupu zvuku.
AudioSignalProblemOccurred	Je aktivována, když dojde k SpeechRecognitionEngine detekci problému zvukového signálu.
AudioStateChanged	Je aktivována, když dojde ke změně stavu ve zvukovém příjmu SpeechRecognitionEngine .
EmulateRecognizeCompleted	Je aktivována, když SpeechRecognitionEngine dokončí operaci asynchronního rozpoznávání emulovaného vstupu.
LoadGrammarCompleted	Je aktivována, když SpeechRecognitionEngine dokončí asynchronní načítání Grammar objektu.
RecognizeCompleted	Je aktivována, když SpeechRecognitionEngine dokončí operaci asynchronního rozpoznávání.
RecognizerUpdateReached	Vyvoláno, když spuštění SpeechRecognitionEngine pozastaví přijímání úprav.
SpeechDetected	Vyvolá se SpeechRecognitionEngine , když zjistí, že se jedná o vstup, který může identifikovat jako řeč.
SpeechHypothesized	Vyvolá se SpeechRecognitionEngine v případě, že v gramatice byla rozpoznaná slova nebo slova, která mohou být součástí více úplných frází.
SpeechRecognitionRejected	Je aktivována SpeechRecognitionEngine , když vstup obdrží, který neodpovídá žádnému z jeho načtených a povolených Grammar objektů.
SpeechRecognized	Vyvolá se, když se SpeechRecognitionEngine přijme vstup, který odpovídá jakémukoli z jeho načtených a povolených Grammar objektů.

Viz také

• Grammar
• SpeechRecognizer