SpeechRecognizer.EmulateRecognize Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Emuliert die Eingabe für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet.
Überlädt
EmulateRecognize(String) |
Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet. |
EmulateRecognize(RecognizedWordUnit[], CompareOptions) |
Emuliert die Eingabe bestimmter Wörter für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen den Wörtern und den geladenen Spracherkennungsgrammatiken behandelt. |
EmulateRecognize(String, CompareOptions) |
Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen dem Ausdruck und den geladenen Spracherkennungsgrammatiken behandelt. |
Hinweise
Diese Methoden umgehen die Systemaudioeingabe. Dies kann hilfreich sein, wenn Sie eine Anwendung oder Grammatik testen oder debuggen.
Hinweis
Wenn sich die Windows-Spracherkennung im Ruhezustand befindet, geben diese Methoden zurück null
.
Die freigegebene Erkennung löst die SpeechDetectedEreignisse , SpeechHypothesized, und SpeechRecognizedSpeechRecognitionRejectedaus, als ob der Erkennungsvorgang nicht emuliert wird. Die Erkennung ignoriert neue Zeilen und zusätzliche Leerzeichen und behandelt Interpunktion als Literaleingabe.
Hinweis
Das RecognitionResult Objekt, das von der freigegebenen Erkennung als Reaktion auf emulierte Eingabe generiert wird, hat den Wert von null
für seine Audio Eigenschaft.
Verwenden Sie die -Methode, um die EmulateRecognizeAsync asynchrone Erkennung zu emulieren.
EmulateRecognize(String)
- Quelle:
- SpeechRecognizer.cs
- Quelle:
- SpeechRecognizer.cs
- Quelle:
- SpeechRecognizer.cs
Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet.
public:
System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText);
public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText);
member this.EmulateRecognize : string -> System.Speech.Recognition.RecognitionResult
Public Function EmulateRecognize (inputText As String) As RecognitionResult
Parameter
- inputText
- String
Die Eingabe für den Erkennungsvorgang.
Gibt zurück
Das Erkennungsergebnis des Erkennungsvorgangs oder null
, wenn der Vorgang nicht erfolgreich war oder wenn sich die Windows-Spracherkennung im Sleeping-Zustand befindet.
Beispiele
Im folgenden Beispiel wird eine Beispielgrammatik in die freigegebene Erkennung geladen und die Eingabe an die Erkennung emuliert. Wenn die Windows-Spracherkennung nicht ausgeführt wird, startet diese Anwendung auch die Windows-Spracherkennung. Wenn sich die Windows-Spracherkennung im Ruhezustand befindet, EmulateRecognize gibt immer NULL zurück.
using System;
using System.Speech.Recognition;
namespace SharedRecognizer
{
class Program
{
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);
RecognitionResult result;
// This EmulateRecognize call matches the grammar and returns a
// recognition result.
result = recognizer.EmulateRecognize("testing testing");
OutputResult(result);
// This EmulateRecognize call does not match the grammar and
// returns null.
result = recognizer.EmulateRecognize("testing one two three");
OutputResult(result);
}
Console.WriteLine();
Console.WriteLine("Press any key to exit...");
Console.ReadKey();
}
// Output information about a recognition result to the console.
private static void OutputResult(RecognitionResult result)
{
if (result != null)
{
Console.WriteLine("Recognition result = {0}",
result.Text ?? "<no text>");
}
else
{
Console.WriteLine("No recognition result");
}
}
}
}
Hinweise
Die Erkennungen, die mit Vista und Windows 7 ausgeliefert werden, ignorieren Groß- und Zeichenbreite, wenn Grammatikregeln auf den Eingabebegriff angewendet werden. Weitere Informationen zu diesem Vergleichstyp finden Sie unter Enumerationswerte CompareOptionsOrdinalIgnoreCase und IgnoreWidth. Die Erkennungen ignorieren auch neue Zeilen und zusätzliche Leerzeichen und behandeln Interpunktion als Literaleingabe.
Weitere Informationen
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
Gilt für:
EmulateRecognize(RecognizedWordUnit[], CompareOptions)
- Quelle:
- SpeechRecognizer.cs
- Quelle:
- SpeechRecognizer.cs
- Quelle:
- SpeechRecognizer.cs
Emuliert die Eingabe bestimmter Wörter für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen den Wörtern und den geladenen Spracherkennungsgrammatiken behandelt.
public:
System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(cli::array <System::Speech::Recognition::RecognizedWordUnit ^> ^ wordUnits, System::Globalization::CompareOptions compareOptions);
public System.Speech.Recognition.RecognitionResult EmulateRecognize (System.Speech.Recognition.RecognizedWordUnit[] wordUnits, System.Globalization.CompareOptions compareOptions);
member this.EmulateRecognize : System.Speech.Recognition.RecognizedWordUnit[] * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult
Public Function EmulateRecognize (wordUnits As RecognizedWordUnit(), compareOptions As CompareOptions) As RecognitionResult
Parameter
- wordUnits
- RecognizedWordUnit[]
Ein Array von Worteinheiten, das die Eingabe für den Erkennungsvorgang enthält.
- compareOptions
- CompareOptions
Eine bitweise Kombination der Enumerationswerte, die den Typ des Vergleichs beschreiben, der für den emulierten Erkennungsvorgang verwendet wird.
Gibt zurück
Das Erkennungsergebnis des Erkennungsvorgangs oder null
, wenn der Vorgang nicht erfolgreich war oder wenn sich die Windows-Spracherkennung im Sleeping-Zustand befindet.
Hinweise
Diese Methode erstellt ein RecognitionResult -Objekt unter Verwendung der im Parameter bereitgestellten wordUnits
Informationen.
Die Erkennung verwendet die compareOptions
, wenn Grammatikregeln auf den Eingabebegriff angewendet werden. Die Erkennungen, die mit Vista und Windows 7 ausgeliefert werden, ignorieren die Groß-/Kleinschreibung, wenn der OrdinalIgnoreCase Wert oder IgnoreCase vorhanden ist. Die Erkennungen ignorieren immer die Zeichenbreite und niemals den Kana-Typ. Die Erkennungen ignorieren auch neue Zeilen und zusätzliche Leerzeichen und behandeln Interpunktion als Literaleingabe. Weitere Informationen zur Zeichenbreite und zum Kana-Typ finden Sie in der CompareOptions Enumeration.
Weitere Informationen
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
Gilt für:
EmulateRecognize(String, CompareOptions)
- Quelle:
- SpeechRecognizer.cs
- Quelle:
- SpeechRecognizer.cs
- Quelle:
- SpeechRecognizer.cs
Emuliert die Eingabe eines Ausdrucks für die freigegebene Spracherkennung. Dabei wird Text statt Audio für die synchrone Spracherkennung verwendet und festgelegt, wie die Erkennung Unicode-Vergleich zwischen dem Ausdruck und den geladenen Spracherkennungsgrammatiken behandelt.
public:
System::Speech::Recognition::RecognitionResult ^ EmulateRecognize(System::String ^ inputText, System::Globalization::CompareOptions compareOptions);
public System.Speech.Recognition.RecognitionResult EmulateRecognize (string inputText, System.Globalization.CompareOptions compareOptions);
member this.EmulateRecognize : string * System.Globalization.CompareOptions -> System.Speech.Recognition.RecognitionResult
Public Function EmulateRecognize (inputText As String, compareOptions As CompareOptions) As RecognitionResult
Parameter
- inputText
- String
Der Eingabebegriff für den Erkennungsvorgang.
- compareOptions
- CompareOptions
Eine bitweise Kombination der Enumerationswerte, die den Typ des Vergleichs beschreiben, der für den emulierten Erkennungsvorgang verwendet wird.
Gibt zurück
Das Erkennungsergebnis des Erkennungsvorgangs oder null
, wenn der Vorgang nicht erfolgreich war oder wenn sich die Windows-Spracherkennung im Sleeping-Zustand befindet.
Hinweise
Die Erkennung verwendet die compareOptions
, wenn Grammatikregeln auf den Eingabebegriff angewendet werden. Die Erkennungen, die mit Vista und Windows 7 ausgeliefert werden, ignorieren die Groß-/Kleinschreibung, wenn der OrdinalIgnoreCase Wert oder IgnoreCase vorhanden ist. Die Erkennungen ignorieren immer die Zeichenbreite und niemals den Kana-Typ. Die Erkennungen ignorieren auch neue Zeilen und zusätzliche Leerzeichen und behandeln Interpunktion als Literaleingabe. Weitere Informationen zur Zeichenbreite und zum Kana-Typ finden Sie in der CompareOptions Enumeration.
Weitere Informationen
- RecognitionResult
- EmulateRecognizeAsync(String)
- SpeechDetected
- SpeechHypothesized
- SpeechRecognitionRejected
- SpeechRecognized
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für