Partager via


SpeechRecognizer Classe

Définition

Transcrit la parole en texte. La voix peut arriver par le biais d’un microphone, d’un fichier audio ou d’un autre flux d’entrée audio.

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

Exemples

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

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

Remarques

Voir aussi : Prise en main de la reconnaissance vocale

Constructeurs

SpeechRecognizer(EmbeddedSpeechConfig)

Crée un instance de SpeechRecognizer à l’aide d’EmbeddedSpeechConfig, configuré pour recevoir la parole à partir du microphone par défaut. Ajouté dans la version 1.19.0

SpeechRecognizer(EmbeddedSpeechConfig, AudioConfig)

Crée un instance de SpeechRecognizer à l’aide d’EmbeddedSpeechConfig, configuré pour recevoir la voix d’une source audio spécifiée dans un objet AudioConfig. Ajouté dans la version 1.19.0

SpeechRecognizer(EmbeddedSpeechConfig, AutoDetectSourceLanguageConfig)

Crée un instance de SpeechRecognizer, à l’aide d’EmbeddedSpeechConfig, qui détermine la langue source à partir d’une liste d’options. Ajouté dans la version 1.20.0

SpeechRecognizer(EmbeddedSpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Crée un instance de SpeechRecognizer, à l’aide d’EmbeddedSpeechConfig, qui détermine la langue source à partir d’une liste d’options. Ajouté dans la version 1.20.0

SpeechRecognizer(HybridSpeechConfig)

Crée une instance de SpeechRecognizer à l’aide d’HybridSpeechConfig, configuré pour recevoir la voix à partir du microphone par défaut.

SpeechRecognizer(HybridSpeechConfig, AudioConfig)

Crée un instance de SpeechRecognizer à l’aide d’HybridSpeechConfig, configuré pour recevoir la voix d’une source audio spécifiée dans un objet AudioConfig.

SpeechRecognizer(HybridSpeechConfig, AutoDetectSourceLanguageConfig)

Crée une instance de SpeechRecognizer, à l’aide d’HybridSpeechConfig, qui détermine la langue source à partir d’une liste d’options.

SpeechRecognizer(HybridSpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Crée une instance de SpeechRecognizer, à l’aide d’HybridSpeechConfig, qui détermine la langue source à partir d’une liste d’options.

SpeechRecognizer(SpeechConfig)

Crée un instance de SpeechRecognizer configuré pour recevoir la voix du microphone par défaut.

SpeechRecognizer(SpeechConfig, AudioConfig)

Crée un instance de SpeechRecognizer configuré pour recevoir la voix d’une source audio spécifiée dans un objet AudioConfig.

SpeechRecognizer(SpeechConfig, AutoDetectSourceLanguageConfig)

Crée une instance de SpeechRecognizer qui détermine la langue source à partir d’une liste d’options. Ajouté dans la version 1.9.0

SpeechRecognizer(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Crée une instance de SpeechRecognizer. Ajouté dans la version 1.9.0

SpeechRecognizer(SpeechConfig, SourceLanguageConfig)

Crée une instance de SpeechRecognizer. Ajouté dans la version 1.9.0

SpeechRecognizer(SpeechConfig, SourceLanguageConfig, AudioConfig)

Crée une instance de SpeechRecognizer. Ajouté dans la version 1.9.0

SpeechRecognizer(SpeechConfig, String)

Crée une instance de SpeechRecognizer configurée pour recevoir la parole dans une langue particulière. Ajouté dans la version 1.9.0

SpeechRecognizer(SpeechConfig, String, AudioConfig)

Crée une nouvelle instance de SpeechRecognizer configurée pour recevoir la parole dans une langue particulière à partir d’une source audio spécifiée dans un objet AudioConfig. Ajouté dans la version 1.9.0

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.

Remarque : votre code doit vous assurer que le jeton d’autorisation est valide. Avant l’expiration du jeton d’autorisation, votre code doit l’actualiser en appelant ce setter avec un nouveau jeton valide. Dans le cas contraire, le module de reconnaissance génère des erreurs lors de la reconnaissance.

EndpointId

Obtient l’ID de point de terminaison d’un modèle vocal personnalisé à utiliser pour la reconnaissance vocale.

OutputFormat

Obtient le paramètre de format de sortie.

Properties

Collection de propriétés et leurs valeurs définies pour ce SpeechRecognizer. 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.

Méthodes

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()

Transcrit la parole en texte. La voix peut arriver par le biais d’un microphone, d’un fichier audio ou d’un autre flux d’entrée audio.

RecognizeOnceAsync()

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

StartContinuousRecognitionAsync()

Démarre la reconnaissance vocale sur un flux audio continu en tant qu’opération asynchrone, jusqu’à ce que StopContinuousRecognitionAsync() soit appelé. Vous devez vous abonner aux événements pour recevoir les résultats de la reconnaissance.

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 indique que la reconnaissance vocale 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)

S’applique à