SpeechRecognizer Klasse
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.
Aktiviert die Spracherkennung mit einer Standard- oder einer benutzerdefinierten grafischen Benutzeroberfläche (GUI).
public ref class SpeechRecognizer sealed : IClosable/// [Windows.Foundation.Metadata.Activatable(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SpeechRecognizer final : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class SpeechRecognizer final : IClosable[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SpeechRecognizer : System.IDisposable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.SpeechRecognition.ISpeechRecognizerFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SpeechRecognizer : System.IDisposablefunction SpeechRecognizer(language)Public NotInheritable Class SpeechRecognizer
Implements IDisposable- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
CompileConstraintsAsync muss immer vor RecognizeAsync oder RecognizeWithUIAsync aufgerufen werden, auch wenn in der Constraints-Eigenschaft keine Einschränkungen angegeben sind.
Versionsverlauf
| Windows-Version | SDK-Version | Mehrwert |
|---|---|---|
| 1709 | 16299 | TrySetSystemSpeechLanguageAsync |
Konstruktoren
| SpeechRecognizer() |
Erstellt eine neue instance der SpeechRecognizer-Klasse. |
| SpeechRecognizer(Language) |
Erstellt eine neue instance der SpeechRecognizer-Klasse mit einem Sprachspezifizierer. |
Eigenschaften
| Constraints |
Ruft die Auflistung von Einschränkungsobjekten ab, die derzeit dem SpeechRecognizer-Objekt hinzugefügt werden. |
| ContinuousRecognitionSession |
Ruft das Diesem SpeechRecognizer zugeordnete Objekt der fortlaufenden Erkennungssitzung (SpeechContinuousRecognitionSession) ab. |
| CurrentLanguage |
Ruft die sprache ab, die für die Spracherkennung verwendet wird. |
| State |
Ruft den Zustand der Spracherkennung ab. |
| SupportedGrammarLanguages |
Ruft die Auflistung der Sprachen ab, die von den benutzerdefinierten Grammatiken der in der Constraints-Eigenschaft angegebenen SpeechRecognitionGrammarFileConstraint- und SpeechRecognitionListConstraint-Objekte unterstützt werden. |
| SupportedTopicLanguages |
Ruft die Auflistung der Sprachen ab, die von den vordefinierten Webdienstgrammatiken der SpeechRecognitionTopicConstraint-Objekte unterstützt werden, die in der Constraints-Eigenschaft angegeben sind. |
| SystemSpeechLanguage |
Ruft die Sprachsprache des Geräts ab, die unter Einstellungen > Zeit & Spracherkennung >angegeben ist. |
| Timeouts |
Ruft ab, wie lange eine Spracherkennung Stille oder nicht wiedererkennbare Geräusche (Plappern) ignoriert und weiterhin auf Spracheingaben lauscht. |
| UIOptions |
Ruft die Benutzeroberflächeneinstellungen für die RecognizeWithUIAsync-Methode ab. |
Methoden
| Close() |
Entfernt die Spracherkennung, indem zugeordnete Ressourcen freigegeben, freigegeben oder zurückgesetzt werden. |
| CompileConstraintsAsync() |
Kompilieren Sie asynchron alle Einschränkungen, die von der Constraints-Eigenschaft angegeben werden. |
| Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. |
| RecognizeAsync() |
Startet eine Spracherkennungssitzung für ein SpeechRecognizer-Objekt . |
| RecognizeWithUIAsync() |
Startet asynchron eine Spracherkennungssitzung, die zusätzliche Ui-Mechanismen enthält, einschließlich Eingabeaufforderungen, Beispielen, Sprachsynthese (Text-to-Speech, TTS) und Bestätigungen. |
| StopRecognitionAsync() |
Beendet die Spracherkennungssitzung asynchron. |
| TrySetSystemSpeechLanguageAsync(Language) |
Versucht asynchron, die für die Spracherkennung auf einem IoT-Gerät verwendete Systemsprache festzulegen. Hinweis Diese Methode ist nur im eingebetteten Modus verfügbar. |
Ereignisse
| HypothesisGenerated |
Tritt während einer laufenden Diktiersitzung auf, wenn ein Erkennungsergebnisfragment von der Spracherkennung zurückgegeben wird. |
| RecognitionQualityDegrading |
Dieses Ereignis wird ausgelöst, wenn ein Audioproblem erkannt wird, das sich auf die Erkennungsgenauigkeit auswirken kann. |
| StateChanged |
Dieses Ereignis wird ausgelöst, wenn während der Audioaufnahme eine Änderung an der State-Eigenschaft auftritt. |