SpeechRecognizer Klasse

Referenz

Definition

Namespace:: Microsoft.CognitiveServices.Speech

Assembly:: Microsoft.CognitiveServices.Speech.csharp.dll

Paket:: Microsoft.CognitiveServices.Speech v1.34.0

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.

Transkribiert Sprache in Text. Sprache kann über Mikrofon, Audiodatei oder einen anderen Audioeingabestream empfangen werden.

public sealed class SpeechRecognizer : Microsoft.CognitiveServices.Speech.Recognizer

type SpeechRecognizer = class
    inherit Recognizer

Public NotInheritable Class SpeechRecognizer
Inherits Recognizer

Vererbung: Object

Recognizer
SpeechRecognizer

Beispiele

In diesem Beispiel wird die Spracherkennung über ein Mikrofon verwendet und von der Erkennung generierte Ereignisse lauscht.

public async Task SpeechContinuousRecognitionAsync()
{
    // Creates an instance of a speech config with specified subscription key and region.
    // Replace with your own subscription key and service region (e.g., "westus").
    var config = SpeechConfig.FromSubscription("YourSubscriptionKey", "YourServiceRegion");

    // Creates a speech recognizer from microphone.
    using (var recognizer = new SpeechRecognizer(config))
    {
        // Subscribes to events.
        recognizer.Recognizing += (s, e) => {
            Console.WriteLine($"RECOGNIZING: Text={e.Result.Text}");
        };

        recognizer.Recognized += (s, e) => {
            var result = e.Result;
            Console.WriteLine($"Reason: {result.Reason.ToString()}");
            if (result.Reason == ResultReason.RecognizedSpeech)
            {
                    Console.WriteLine($"Final result: Text: {result.Text}.");
            }
        };

        recognizer.Canceled += (s, e) => {
            Console.WriteLine($"\n    Canceled. Reason: {e.Reason.ToString()}, CanceledReason: {e.Reason}");
        };

        recognizer.SessionStarted += (s, e) => {
            Console.WriteLine("\n    Session started event.");
        };

        recognizer.SessionStopped += (s, e) => {
            Console.WriteLine("\n    Session stopped event.");
        };

        // Starts continuous recognition. 
        // Uses StopContinuousRecognitionAsync() to stop recognition.
        await recognizer.StartContinuousRecognitionAsync().ConfigureAwait(false);

        do
        {
            Console.WriteLine("Press Enter to stop");
        } while (Console.ReadKey().Key != ConsoleKey.Enter);

        // Stops recognition.
        await recognizer.StopContinuousRecognitionAsync().ConfigureAwait(false);
    }
}

Hinweise

Siehe auch: Erste Schritte mit Spracherkennung

Konstruktoren

SpeechRecognizer(EmbeddedSpeechConfig)	Erstellt eine neue instance von SpeechRecognizer mithilfe von EmbeddedSpeechConfig, die für den Empfang von Sprache vom Standardmikrofon konfiguriert ist. In 1.19.0 hinzugefügt
SpeechRecognizer(EmbeddedSpeechConfig, AudioConfig)	Erstellt eine neue instance von SpeechRecognizer mithilfe von EmbeddedSpeechConfig, die für den Empfang von Sprache von einer Audioquelle konfiguriert ist, die in einem AudioConfig-Objekt angegeben ist. In 1.19.0 hinzugefügt
SpeechRecognizer(EmbeddedSpeechConfig, AutoDetectSourceLanguageConfig)	Erstellt mithilfe von EmbeddedSpeechConfig einen neuen instance von SpeechRecognizer, der die Quellsprache aus einer Liste von Optionen bestimmt. In 1.20.0 hinzugefügt
SpeechRecognizer(EmbeddedSpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)	Erstellt mithilfe von EmbeddedSpeechConfig einen neuen instance von SpeechRecognizer, der die Quellsprache aus einer Liste von Optionen bestimmt. In 1.20.0 hinzugefügt
SpeechRecognizer(HybridSpeechConfig)	Erstellt eine neue instance von SpeechRecognizer mithilfe von HybridSpeechConfig, die für den Empfang von Sprache vom Standardmikrofon konfiguriert ist.
SpeechRecognizer(HybridSpeechConfig, AudioConfig)	Erstellt eine neue instance von SpeechRecognizer mithilfe von HybridSpeechConfig, die für den Empfang von Sprache von einer Audioquelle konfiguriert ist, die in einem AudioConfig-Objekt angegeben ist.
SpeechRecognizer(HybridSpeechConfig, AutoDetectSourceLanguageConfig)	Erstellt mithilfe von HybridSpeechConfig eine neue instance von SpeechRecognizer, die die Quellsprache aus einer Liste von Optionen bestimmt.
SpeechRecognizer(HybridSpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)	Erstellt mithilfe von HybridSpeechConfig eine neue instance von SpeechRecognizer, die die Quellsprache aus einer Liste von Optionen bestimmt.
SpeechRecognizer(SpeechConfig)	Erstellt eine neue instance von SpeechRecognizer, die für den Empfang von Sprache vom Standardmikrofon konfiguriert ist.
SpeechRecognizer(SpeechConfig, AudioConfig)	Erstellt eine neue instance von SpeechRecognizer, die für den Empfang von Sprache von einer Audioquelle konfiguriert ist, die in einem AudioConfig-Objekt angegeben ist.
SpeechRecognizer(SpeechConfig, AutoDetectSourceLanguageConfig)	Erstellt einen neuen instance von SpeechRecognizer, der die Quellsprache aus einer Liste von Optionen bestimmt. Hinzugefügt in 1.9.0
SpeechRecognizer(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)	Erstellt eine neue instance von SpeechRecognizer. Hinzugefügt in 1.9.0
SpeechRecognizer(SpeechConfig, SourceLanguageConfig)	Erstellt eine neue instance von SpeechRecognizer. Hinzugefügt in 1.9.0
SpeechRecognizer(SpeechConfig, SourceLanguageConfig, AudioConfig)	Erstellt eine neue instance von SpeechRecognizer. Hinzugefügt in 1.9.0
SpeechRecognizer(SpeechConfig, String)	Erstellt eine neue instance von SpeechRecognizer, die für den Empfang von Sprache in einer bestimmten Sprache konfiguriert ist. Hinzugefügt in 1.9.0
SpeechRecognizer(SpeechConfig, String, AudioConfig)	Erstellt eine neue instance von SpeechRecognizer, die für den Empfang von Sprache in einer bestimmten Sprache von einer In einem AudioConfig-Objekt angegebenen Audioquelle konfiguriert ist. Hinzugefügt in 1.9.0

Felder

disposed	disposed ist ein Flag, das verwendet wird, um anzugeben, ob das Objekt verworfen wird. (Geerbt von Recognizer)
gch	GC-Handle für Rückrufe für den Kontext. (Geerbt von Recognizer)
isDisposing	Gibt an, ob das Objekt derzeit verworfen wird. (Geerbt von Recognizer)
pointerHandle	Intern für die Protokollierung. (Geerbt von Recognizer)
recognizerLock	recognizerLock wird verwendet, um den Zugriff auf Objektelementvariablen aus mehreren Threads zu synchronisieren. (Geerbt von Recognizer)

Eigenschaften

AuthorizationToken	Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird, oder legt es fest. Hinweis: Ihr Code muss sicherstellen, dass das Autorisierungstoken gültig ist. Bevor das Autorisierungstoken abläuft, muss ihr Code es aktualisieren, indem dieser Setter mit einem neuen gültigen Token aufgerufen wird. Andernfalls erzeugt die Erkennung während der Erkennung Fehler.
EndpointId	Ruft die Endpunkt-ID eines benutzerdefinierten Sprachmodells ab, das für die Spracherkennung verwendet werden soll.
OutputFormat	Ruft die Ausgabeformateinstellung ab.
Properties	Die Auflistung der Eigenschaften und deren Werte, die für diese SpeechRecognizerdefiniert sind. Hinweis: Die Eigenschaftsauflistung ist nur gültig, bis der Erkennungsgeber, der diese Eigenschaften besitzt, verworfen oder abgeschlossen ist.
SpeechRecognitionLanguage	Ruft den Sprachnamen ab, der beim Erstellen der Erkennung festgelegt wurde.

Methoden

Dispose()	Entsorgen Sie zugeordnete Ressourcen. (Geerbt von Recognizer)
Dispose(Boolean)	Diese Methode führt eine Bereinigung von Ressourcen durch. Der boolesche Parameter `disposing` gibt an, ob die Methode von Dispose() (wenn `disposing` true) oder vom Finalizer (wenn `disposing` false) aufgerufen wird. Abgeleitete Klassen sollten diese Methode überschreiben, um bei Bedarf Ressourcen zu entsorgen. (Geerbt von Recognizer)
Finalize()	Transkribiert Sprache in Text. Sprache kann über Mikrofon, Audiodatei oder einen anderen Audioeingabestream empfangen werden.
RecognizeOnceAsync()	Startet die Spracherkennung als asynchronen Vorgang.
StartContinuousRecognitionAsync()	Startet die Spracherkennung für einen kontinuierlichen Audiodatenstrom als asynchronen Vorgang, bis StopContinuousRecognitionAsync() aufgerufen wird. Sie müssen Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten.
StartKeywordRecognitionAsync(KeywordRecognitionModel)	Konfiguriert die Erkennung mit dem angegebenen Schlüsselwort (keyword)-Modell. Nach dem Aufrufen dieser Methode lauscht die Erkennung auf den Schlüsselwort (keyword), um die Erkennung zu starten. Rufen Sie StopKeywordRecognitionAsync() auf, um die Schlüsselwort (keyword) initiierte Erkennung zu beenden. Sie müssen Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten.
StopContinuousRecognitionAsync()	Beendet einen ausgeführten Erkennungsvorgang so schnell wie möglich und fordert sofort ein Ergebnis basierend auf der Eingabe an, die bisher verarbeitet wurde. Dies funktioniert für alle Erkennungsvorgänge, nicht nur für fortlaufende Vorgänge, und erleichtert die Verwendung von Push-to-Talk- oder "Jetzt beenden"-Schaltflächen für manuelle Audioendpunkte.
StopKeywordRecognitionAsync()	Beendet die Schlüsselwort (keyword) initiierte Erkennung.

Ereignisse

Canceled	Das Ereignis Canceled signalisiert, dass die Spracherkennung abgebrochen wurde.
Recognized	Das Ereignis Recognized signalisiert, dass ein endgültiges Erkennungsergebnis empfangen wird.
Recognizing	Das Ereignis Recognizing signalisiert, dass ein Zwischenerkennungsergebnis empfangen wird.
SessionStarted	Definiert den Ereignishandler für das ereignis gestartete Sitzungsereignis. (Geerbt von Recognizer)
SessionStopped	Definiert den Ereignishandler für das ereignis beendete Sitzung. (Geerbt von Recognizer)
SpeechEndDetected	Definiert den Ereignishandler für das erkannte Sprachendereignis. (Geerbt von Recognizer)
SpeechStartDetected	Definiert den Ereignishandler für das erkannte Sprachstartereignis. (Geerbt von Recognizer)

Gilt für: