TranslationRecognizer Klasse

Referenz

Definition

Namespace:: Microsoft.CognitiveServices.Speech.Translation

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

Paket:: Microsoft.CognitiveServices.Speech v1.32.1

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.

Übersetzt Spracheingaben in Text und synthetisierte Sprache in eine oder mehrere Zielsprachen.

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

type TranslationRecognizer = class
    inherit Recognizer

Public NotInheritable Class TranslationRecognizer
Inherits Recognizer

Vererbung: Object

Recognizer
TranslationRecognizer

Beispiele

In diesem Beispiel wird die Übersetzungserkennung von einem Mikrofon verwendet und von der Erkennung generierte Ereignisse empfangen.

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

    // Sets source and target languages.
    string fromLanguage = "en-US";
    config.SpeechRecognitionLanguage = fromLanguage;
    config.AddTargetLanguage("de");

    // Sets voice name of synthesis output.
    const string GermanVoice = "Microsoft Server Speech Text to Speech Voice (de-DE, Hedda)";
    config.VoiceName = GermanVoice;
    // Creates a translation recognizer using microphone as audio input.
    using (var recognizer = new TranslationRecognizer(config))
    {
        // Subscribes to events.
        recognizer.Recognizing += (s, e) =>
        {
            Console.WriteLine($"RECOGNIZING in '{fromLanguage}': Text={e.Result.Text}");
            foreach (var element in e.Result.Translations)
            {
                Console.WriteLine($"    TRANSLATING into '{element.Key}': {element.Value}");
            }
        };

        recognizer.Recognized += (s, e) =>
        {
            if (e.Result.Reason == ResultReason.TranslatedSpeech)
            {
                Console.WriteLine($"\nFinal result: Reason: {e.Result.Reason.ToString()}, recognized text in {fromLanguage}: {e.Result.Text}.");
                foreach (var element in e.Result.Translations)
                {
                    Console.WriteLine($"    TRANSLATING into '{element.Key}': {element.Value}");
                }
            }
        };

        recognizer.Synthesizing += (s, e) =>
        {
            var audio = e.Result.GetAudio();
            Console.WriteLine(audio.Length != 0
                ? $"AudioSize: {audio.Length}"
                : $"AudioSize: {audio.Length} (end of synthesis data)");
        };

        recognizer.Canceled += (s, e) =>
        {
            Console.WriteLine($"\nRecognition canceled. Reason: {e.Reason}; ErrorDetails: {e.ErrorDetails}");
        };

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

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

        // Starts continuous recognition. 
        // Uses StopContinuousRecognitionAsync() to stop recognition.
        Console.WriteLine("Say something...");
        await recognizer.StartContinuousRecognitionAsync().ConfigureAwait(false);

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

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

Hinweise

Siehe auch: Erste Schritte mit der Sprachübersetzung

Konstruktoren

TranslationRecognizer(EmbeddedSpeechConfig)	Erstellt eine Übersetzungserkennung mithilfe der Standardmikrofoneingabe für eine angegebene eingebettete Sprachkonfiguration.
TranslationRecognizer(EmbeddedSpeechConfig, AudioConfig)	Erstellt eine Übersetzungserkennung mithilfe der angegebenen eingebetteten Sprachübersetzungs- und Audiokonfiguration.
TranslationRecognizer(HybridSpeechConfig)	Erstellt eine Übersetzungserkennung mithilfe der Standardmikrofoneingabe für eine angegebene Hybridsprachkonfiguration.
TranslationRecognizer(HybridSpeechConfig, AudioConfig)	Erstellt eine Übersetzungserkennung mithilfe der angegebenen Hybridübersetzungs- und Audiokonfiguration.
TranslationRecognizer(SpeechTranslationConfig)	Erstellt eine Übersetzungserkennung mithilfe der Standardmikrofoneingabe für eine angegebene Übersetzungskonfiguration.
TranslationRecognizer(SpeechTranslationConfig, AudioConfig)	Erstellt eine Übersetzungserkennung mithilfe der angegebenen Sprachübersetzungs- und Audiokonfiguration.
TranslationRecognizer(SpeechTranslationConfig, AutoDetectSourceLanguageConfig)	Erstellt eine Übersetzungserkennung mit dem angegebenen Sprachübersetzer und der automatischen Erkennung der Quellsprachekonfiguration.
TranslationRecognizer(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)	Erstellt eine Übersetzungserkennung mithilfe der angegebenen Sprachübersetzungs- und Audiokonfiguration.

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.
Properties	Die Auflistung der Eigenschaften und deren Werte, die für diese TranslationRecognizerdefiniert 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.
TargetLanguages	Ruft Zielsprachen für die Übersetzung ab, die beim Erstellen der Erkennung festgelegt wurden. Jede Sprache wird im BCP-47-Format angegeben. Die Übersetzung stellt übersetzten Text für jede Sprache bereit.
VoiceName	Ruft den Namen der Ausgabestimme ab, wenn die Sprachsynthese verwendet wird.

Methoden

AddTargetLanguage(String)	Fügt eine Zielsprache für die Übersetzung hinzu. In 1.7.0 hinzugefügt
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()	Übersetzt Spracheingaben in Text und synthetisierte Sprache in eine oder mehrere Zielsprachen.
RecognizeOnceAsync()	Startet die Sprachübersetzung als asynchronen Vorgang.
RemoveTargetLanguage(String)	Entfernt eine Zielsprache für die Übersetzung. In 1.7.0 hinzugefügt
StartContinuousRecognitionAsync()	Startet die Erkennung und Übersetzung in einem fortlaufenden Audiostream, bis StopContinuousRecognitionAsync() aufgerufen wird. Sie müssen Ereignisse abonnieren, um Übersetzungsergebnisse 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 Sprachübersetzung für Text/Synthese 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)
Synthesizing	Das Ereignis Synthesizing signalisiert, dass ein Übersetzungssyntheseergebnis empfangen wird.

Gilt für:

Share via