Freigeben über


SpeechRecognizer Klasse

Definition

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
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: