SpeechRecognitionEngine Klas

Definitie

Biedt de middelen voor het openen en beheren van een spraakherkenningsengine voor in-process.

public ref class SpeechRecognitionEngine : IDisposable
public class SpeechRecognitionEngine : IDisposable
type SpeechRecognitionEngine = class
    interface IDisposable
Public Class SpeechRecognitionEngine
Implements IDisposable
Overname
SpeechRecognitionEngine
Implementeringen

Voorbeelden

In het volgende voorbeeld ziet u een deel van een consoletoepassing waarin eenvoudige spraakherkenning wordt gedemonstreert. Omdat in dit voorbeeld de Multiple modus van de RecognizeAsync methode wordt gebruikt, wordt herkenning uitgevoerd totdat u het consolevenster sluit of de foutopsporing stopt.

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);
    }
  }
}

Opmerkingen

U kunt een exemplaar van deze klasse maken voor een van de geïnstalleerde spraakherkenningsservers. Gebruik de statische InstalledRecognizers methode om informatie op te halen over welke recognizers zijn geïnstalleerd.

Deze klasse is bedoeld voor het in-proces uitvoeren van spraakherkenningsengines en biedt als volgt controle over verschillende aspecten van spraakherkenning:

Het SpeechRecognitionEngine object is uitsluitend bedoeld voor het enige gebruik van het proces dat het object heeft geïnstantieerd. De functie deelt daarentegen SpeechRecognizer één recognizer met elke toepassing die deze wil gebruiken.

Note

Roep altijd aan Dispose voordat u uw laatste verwijzing naar de spraakherkenning loslaat. Anders worden de resources die het gebruikt niet vrijgemaakt totdat de garbagecollector de methode van Finalize het recognizer-object aanroept.

Constructors

Name Description
SpeechRecognitionEngine()

Initialiseert een nieuw exemplaar van de SpeechRecognitionEngine klasse met behulp van de standaard spraakherkenning voor het systeem.

SpeechRecognitionEngine(CultureInfo)

Initialiseert een nieuw exemplaar van de SpeechRecognitionEngine klasse met behulp van de standaard spraakherkenning voor een opgegeven landinstelling.

SpeechRecognitionEngine(RecognizerInfo)

Initialiseert een nieuw exemplaar van het SpeechRecognitionEngine gebruik van de informatie in een RecognizerInfo object om de te gebruiken recognizer op te geven.

SpeechRecognitionEngine(String)

Initialiseert een nieuw exemplaar van de SpeechRecognitionEngine klasse met een tekenreeksparameter waarmee de naam van de recognizer wordt opgegeven die moet worden gebruikt.

Eigenschappen

Name Description
AudioFormat

Hiermee haalt u de indeling op van de audio die wordt ontvangen door de SpeechRecognitionEngine.

AudioLevel

Hiermee haalt u het niveau op van de audio die wordt ontvangen door de SpeechRecognitionEngine.

AudioPosition

Hiermee haalt u de huidige locatie op in de audiostream die wordt gegenereerd door het apparaat dat invoer levert aan de SpeechRecognitionEngine.

AudioState

Haalt de status op van de audio die wordt ontvangen door de SpeechRecognitionEngine.

BabbleTimeout

Hiermee haalt u het tijdsinterval op waarmee invoer SpeechRecognitionEngine wordt geaccepteerd die alleen achtergrondruis bevat, voordat u de herkenning voltooit.

EndSilenceTimeout

Hiermee haalt of stelt u het stilte-interval in dat de SpeechRecognitionEngine stilte aan het einde van ondubbelzinnige invoer accepteert voordat u een herkenningsbewerking voltooit.

EndSilenceTimeoutAmbiguous

Hiermee haalt u het stilteinterval op of stelt u deze in dat de SpeechRecognitionEngine stilte wordt geaccepteerd aan het einde van dubbelzinnige invoer voordat u een herkenningsbewerking voltooit.

Grammars

Hiermee haalt u een verzameling van de Grammar objecten op die in dit SpeechRecognitionEngine exemplaar worden geladen.

InitialSilenceTimeout

Hiermee haalt of stelt u het tijdsinterval in waarin een SpeechRecognitionEngine invoer accepteert die alleen stilte bevat voordat de herkenning wordt voltooid.

MaxAlternates

Hiermee wordt het maximum aantal alternatieve herkenningsresultaten opgehaald of ingesteld dat de SpeechRecognitionEngine retourneert voor elke herkenningsbewerking.

RecognizerAudioPosition

Hiermee haalt u de huidige locatie op van de SpeechRecognitionEngine audio-invoer die wordt verwerkt.

RecognizerInfo

Hiermee wordt informatie opgehaald over het huidige exemplaar van SpeechRecognitionEngine.

Methoden

Name Description
Dispose()

Hiermee wordt het SpeechRecognitionEngine object verwijderd.

Dispose(Boolean)

Hiermee verwijdert u het SpeechRecognitionEngine object en verwijdert u resources die tijdens de sessie worden gebruikt.

EmulateRecognize(RecognizedWordUnit[], CompareOptions)

Emuleert invoer van specifieke woorden aan de spraakherkenning, waarbij tekst wordt gebruikt in plaats van audio voor synchrone spraakherkenning en geeft aan hoe de recognizer Unicode-vergelijking tussen de woorden en de geladen grammatica's voor spraakherkenning verwerkt.

EmulateRecognize(String, CompareOptions)

Emulatiet de invoer van een woordgroep voor de spraakherkenning, waarbij tekst wordt gebruikt in plaats van audio voor synchrone spraakherkenning en geeft aan hoe de recognizer Unicode-vergelijking tussen de woordgroep en de geladen grammatica voor spraakherkenning verwerkt.

EmulateRecognize(String)

Emulatie van invoer van een woordgroep aan de spraakherkenning, met behulp van tekst in plaats van audio voor synchrone spraakherkenning.

EmulateRecognizeAsync(RecognizedWordUnit[], CompareOptions)

Emulatie van invoer van specifieke woorden voor de spraakherkenning, met behulp van een matrix van RecognizedWordUnit objecten in plaats van audio voor asynchrone spraakherkenning en geeft aan hoe de recognizer Unicode-vergelijking verwerkt tussen de woorden en de geladen grammatica voor spraakherkenning.

EmulateRecognizeAsync(String, CompareOptions)

Emulatie van invoer van een woordgroep aan de spraakherkenning, waarbij tekst wordt gebruikt in plaats van audio voor asynchrone spraakherkenning en wordt aangegeven hoe de recognizer Unicode-vergelijking tussen de woordgroep en de geladen grammatica voor spraakherkenning verwerkt.

EmulateRecognizeAsync(String)

Emulatie van invoer van een woordgroep aan de spraakherkenning, waarbij tekst wordt gebruikt in plaats van audio voor asynchrone spraakherkenning.

Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
InstalledRecognizers()

Retourneert informatie voor alle geïnstalleerde spraakherkenningsfunctie op het huidige systeem.

LoadGrammar(Grammar)

Hiermee wordt een Grammar object synchroon geladen.

LoadGrammarAsync(Grammar)

Asynchroon laadt een grammatica voor spraakherkenning.

MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
QueryRecognizerSetting(String)

Retourneert de waarden van instellingen voor de recognizer.

Recognize()

Voert een synchrone spraakherkenningsbewerking uit.

Recognize(TimeSpan)

Voert een synchrone spraakherkenningsbewerking uit met een opgegeven initiële time-outperiode voor stilte.

RecognizeAsync()

Voert één asynchrone spraakherkenningsbewerking uit.

RecognizeAsync(RecognizeMode)

Voert een of meer asynchrone spraakherkenningsbewerkingen uit.

RecognizeAsyncCancel()

Hiermee wordt asynchrone herkenning beëindigd zonder te wachten tot de huidige herkenningsbewerking is voltooid.

RecognizeAsyncStop()

Stopt asynchrone herkenning nadat de huidige herkenningsbewerking is voltooid.

RequestRecognizerUpdate()

Aanvragen die de recognizer onderbreekt om de status bij te werken.

RequestRecognizerUpdate(Object, TimeSpan)

Aanvragen die de recognizer onderbreekt om de status bij te werken en biedt een offset en een gebruikerstoken voor de bijbehorende gebeurtenis.

RequestRecognizerUpdate(Object)

Aanvragen die de recognizer onderbreekt om de status bij te werken en een gebruikerstoken voor de bijbehorende gebeurtenis biedt.

SetInputToAudioStream(Stream, SpeechAudioFormatInfo)

Hiermee configureert u het object voor het SpeechRecognitionEngine ontvangen van invoer van een audiostream.

SetInputToDefaultAudioDevice()

Hiermee configureert u het object voor het SpeechRecognitionEngine ontvangen van invoer van het standaardaudioapparaat.

SetInputToNull()

Hiermee schakelt u de invoer voor de spraakherkenning uit.

SetInputToWaveFile(String)

Hiermee configureert u het object voor het SpeechRecognitionEngine ontvangen van invoer van een Waveform-audio-indeling (.wav).

SetInputToWaveStream(Stream)

Hiermee configureert u het object voor het SpeechRecognitionEngine ontvangen van invoer van een stroom die waveform-audio-indelingsgegevens (.wav) bevat.

ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
UnloadAllGrammars()

Hiermee worden alle Grammar objecten uit de recognizer verwijderd.

UnloadGrammar(Grammar)

Hiermee wordt een opgegeven Grammar object uit het SpeechRecognitionEngine exemplaar verwijderd.

UpdateRecognizerSetting(String, Int32)

Hiermee werkt u de opgegeven instelling voor de SpeechRecognitionEngine opgegeven gehele waarde bij.

UpdateRecognizerSetting(String, String)

Hiermee wordt de opgegeven instelling voor de spraakherkenningsengine bijgewerkt met de opgegeven tekenreekswaarde.

gebeurtenis

Name Description
AudioLevelUpdated

Wordt gegenereerd wanneer het SpeechRecognitionEngine niveau van de audio-invoer wordt gerapporteerd.

AudioSignalProblemOccurred

Gegenereerd wanneer er SpeechRecognitionEngine een probleem in het audiosignaal wordt gedetecteerd.

AudioStateChanged

Wordt gegenereerd wanneer de status verandert in de audio die wordt ontvangen door de SpeechRecognitionEngine.

EmulateRecognizeCompleted

Wordt gegenereerd wanneer de asynchrone SpeechRecognitionEngine herkenningsbewerking van geëmuleerde invoer wordt voltooid.

LoadGrammarCompleted

Verhoogd wanneer het SpeechRecognitionEngine asynchrone laden van een Grammar object is voltooid.

RecognizeCompleted

Wordt gegenereerd wanneer een SpeechRecognitionEngine asynchrone herkenningsbewerking wordt voltooid.

RecognizerUpdateReached

Wordt gegenereerd wanneer een actieve SpeechRecognitionEngine pauze wordt onderbroken om wijzigingen te accepteren.

SpeechDetected

Gegenereerd wanneer de SpeechRecognitionEngine invoer wordt gedetecteerd die als spraak kan worden geïdentificeerd.

SpeechHypothesized

Gegenereerd wanneer het SpeechRecognitionEngine woord of de woorden die een onderdeel van meerdere volledige woordgroepen in een grammatica kunnen zijn, heeft herkend.

SpeechRecognitionRejected

Gegenereerd wanneer de SpeechRecognitionEngine invoer wordt ontvangen die niet overeenkomt met een van de geladen en ingeschakelde Grammar objecten.

SpeechRecognized

Gegenereerd wanneer de SpeechRecognitionEngine invoer wordt ontvangen die overeenkomt met een van de geladen en ingeschakelde Grammar objecten.

Van toepassing op

Zie ook