SpeechRecognitionEngine Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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:
Als u een in-process spraakherkenning wilt maken, gebruikt u een van de SpeechRecognitionEngine constructors.
Als u grammaticaën voor spraakherkenning wilt beheren, gebruikt u de LoadGrammarLoadGrammarAsync, en UnloadGrammarUnloadAllGrammars de methoden en de Grammars eigenschap.
Als u de invoer voor de recognizer wilt configureren, gebruikt u de SetInputToAudioStreammethode , SetInputToDefaultAudioDevice, SetInputToNullSetInputToWaveFileof SetInputToWaveStream methode.
Gebruik de Recognize of RecognizeAsync methode om spraakherkenning uit te voeren.
Als u wilt wijzigen hoe herkenning stilte of onverwachte invoer verwerkt, gebruikt u de BabbleTimeouteigenschappen , InitialSilenceTimeouten EndSilenceTimeoutEndSilenceTimeoutAmbiguous eigenschappen.
Als u het aantal alternatieven wilt wijzigen dat door de recognizer wordt geretourneerd, gebruikt u de MaxAlternates eigenschap. De recognizer retourneert herkenningsresultaten in een RecognitionResult object.
Als u wijzigingen wilt synchroniseren met de recognizer, gebruikt u de RequestRecognizerUpdate methode. De recognizer gebruikt meer dan één thread om taken uit te voeren.
Als u invoer voor de recognizer wilt emuleren, gebruikt u de EmulateRecognize en EmulateRecognizeAsync methoden.
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. |