Partager via


TranslationRecognizer Classe

Définition

Traduit l’entrée vocale en texte et la synthèse vocale dans une ou plusieurs langues cibles.

public sealed class TranslationRecognizer : Microsoft.CognitiveServices.Speech.Recognizer
type TranslationRecognizer = class
    inherit Recognizer
Public NotInheritable Class TranslationRecognizer
Inherits Recognizer
Héritage
TranslationRecognizer

Exemples

Cet exemple utilise le module de reconnaissance de traduction à partir d’un microphone et reçoit les événements générés par le module de reconnaissance.

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);
    }
}

Remarques

Voir aussi : Prise en main de la traduction vocale

Constructeurs

TranslationRecognizer(EmbeddedSpeechConfig)

Crée un outil de reconnaissance de traduction à l’aide de l’entrée microphone par défaut pour une configuration vocale incorporée spécifiée.

TranslationRecognizer(EmbeddedSpeechConfig, AudioConfig)

Crée un outil de reconnaissance de traduction à l’aide de la configuration audio et du traducteur vocal incorporés spécifiés.

TranslationRecognizer(HybridSpeechConfig)

Crée un module de reconnaissance de traduction à l’aide de l’entrée microphone par défaut pour une configuration vocale hybride spécifiée.

TranslationRecognizer(HybridSpeechConfig, AudioConfig)

Crée un outil de reconnaissance de traduction à l’aide de la configuration audio et du traducteur vocal hybride spécifiés.

TranslationRecognizer(SpeechTranslationConfig)

Crée un module de reconnaissance de traduction à l’aide de l’entrée microphone par défaut pour une configuration de traduction spécifiée.

TranslationRecognizer(SpeechTranslationConfig, AudioConfig)

Crée un outil de reconnaissance de traduction à l’aide du traducteur vocal et de la configuration audio spécifiés.

TranslationRecognizer(SpeechTranslationConfig, AutoDetectSourceLanguageConfig)

Crée un outil de reconnaissance de traduction à l’aide du traducteur vocal spécifié et détecte automatiquement la configuration de la langue source

TranslationRecognizer(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Crée un outil de reconnaissance de traduction à l’aide du traducteur vocal et de la configuration audio spécifiés.

Champs

disposed

supprimé est un indicateur utilisé pour indiquer si l’objet est supprimé.

(Hérité de Recognizer)
gch

Handle GC pour les rappels pour le contexte.

(Hérité de Recognizer)
isDisposing

Indique si l’objet est en cours de suppression.

(Hérité de Recognizer)
pointerHandle

Interne pour la journalisation.

(Hérité de Recognizer)
recognizerLock

recognizerLock est utilisé pour synchroniser l’accès aux variables membres des objets à partir de plusieurs threads

(Hérité de Recognizer)

Propriétés

AuthorizationToken

Obtient ou définit le jeton d’autorisation utilisé pour communiquer avec le service.

Properties

Collection de propriétés et leurs valeurs définies pour ce TranslationRecognizer. Remarque : La collection de propriétés n’est valide que jusqu’à ce que le module de reconnaissance propriétaire de ces propriétés soit supprimé ou finalisé.

SpeechRecognitionLanguage

Obtient le nom de langue qui a été défini lors de la création du module de reconnaissance.

TargetLanguages

Obtient les langues cibles pour la traduction qui ont été définies lors de la création du module de reconnaissance. Chaque langue est spécifiée au format BCP-47. La traduction fournit du texte traduit pour chaque langue.

VoiceName

Obtient le nom de la voix de sortie si la synthèse vocale est utilisée.

Méthodes

AddTargetLanguage(String)

Ajoute une langue cible pour la traduction. Ajouté dans la version 1.7.0

Dispose()

Supprimer les ressources associées.

(Hérité de Recognizer)
Dispose(Boolean)

Cette méthode effectue le nettoyage des ressources. Le paramètre disposing Boolean indique si la méthode est appelée à partir de Dispose() (si disposing est true) ou du finaliseur (si disposing est false). Les classes dérivées doivent remplacer cette méthode pour supprimer la ressource si nécessaire.

(Hérité de Recognizer)
Finalize()

Traduit l’entrée vocale en texte et la synthèse vocale dans une ou plusieurs langues cibles.

RecognizeOnceAsync()

Démarre la traduction vocale en tant qu’opération asynchrone.

RemoveTargetLanguage(String)

Supprime une langue cible pour la traduction. Ajouté dans la version 1.7.0

StartContinuousRecognitionAsync()

Démarre la reconnaissance et la traduction sur un flux audio continu, jusqu’à ce que StopContinuousRecognitionAsync() soit appelé. Vous devez vous abonner aux événements pour recevoir les résultats de la traduction.

StartKeywordRecognitionAsync(KeywordRecognitionModel)

Configure le module de reconnaissance avec le modèle mot clé donné. Après avoir appelé cette méthode, le module de reconnaissance écoute le mot clé pour démarrer la reconnaissance. Appelez StopKeywordRecognitionAsync() pour mettre fin à la reconnaissance initiée par mot clé. Vous devez vous abonner aux événements pour recevoir les résultats de la reconnaissance.

StopContinuousRecognitionAsync()

Arrête une opération de reconnaissance en cours d’exécution dès que possible et demande immédiatement un résultat en fonction de l’entrée qui a été traitée jusqu’à présent. Cela fonctionne pour toutes les opérations de reconnaissance, et pas seulement les opérations continues, et facilite l’utilisation des boutons push-to-talk ou « Terminer maintenant » pour le point de terminaison audio manuel.

StopKeywordRecognitionAsync()

Met fin à la reconnaissance initiée par le mot clé.

Événements

Canceled

L’événement Canceled signale que la traduction de la parole en texte/synthèse a été annulée.

Recognized

L’événement Recognized indique qu’un résultat de reconnaissance final est reçu.

Recognizing

L’événement Recognizing signale qu’un résultat de reconnaissance intermédiaire est reçu.

SessionStarted

Définit le gestionnaire d’événements pour l’événement démarré par la session.

(Hérité de Recognizer)
SessionStopped

Définit le gestionnaire d’événements pour l’événement arrêté par la session.

(Hérité de Recognizer)
SpeechEndDetected

Définit le gestionnaire d’événements pour l’événement détecté de fin vocale.

(Hérité de Recognizer)
SpeechStartDetected

Définit le gestionnaire d’événements pour l’événement de démarrage vocal détecté.

(Hérité de Recognizer)
Synthesizing

L’événement Synthesizing signale qu’un résultat de synthèse de traduction est reçu.

S’applique à