Sdílet prostřednictvím


SpeechRecognitionEngine Třída

Definice

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
SpeechRecognitionEngine
Implementuje

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:

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ů.

Platí pro

Viz také