SourceLanguageRecognizer.RecognizeOnceAsync Método

Definição

Namespace:

Microsoft.CognitiveServices.Speech

Assembly:

Microsoft.CognitiveServices.Speech.csharp.dll

Pacote:

Microsoft.CognitiveServices.Speech v1.34.0

Inicia o reconhecimento de idioma de origem como uma operação assíncrona.

public System.Threading.Tasks.Task<Microsoft.CognitiveServices.Speech.SpeechRecognitionResult> RecognizeOnceAsync ();

member this.RecognizeOnceAsync : unit -> System.Threading.Tasks.Task<Microsoft.CognitiveServices.Speech.SpeechRecognitionResult>

Public Function RecognizeOnceAsync () As Task(Of SpeechRecognitionResult)

Retornos

Task<SpeechRecognitionResult>

Uma tarefa que representa a operação de reconhecimento. A tarefa retorna um valor de SpeechRecognitionResult

Exemplos

O exemplo a seguir cria um reconhecedor de idioma de origem e, em seguida, obtém e imprime o resultado do reconhecimento.

public async Task SingleLanguageIdRecognitionAsync()
{
    // 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");
    config.SetProperty(PropertyId.SpeechServiceConnection_SingleLanguageIdPriority, "Latency");

    // Creates a speech recognizer using microphone as audio input. Default language: en-us
    using (var sourceLanguageRecognizer = new SourceLanguageRecognizer(config))
    {
        Console.WriteLine("Say something...");

        // Starts source language recognition, and returns after a single utterance is recognized. 
        // The end of a single utterance is determined by listening for silence at the end 
        // or until a timeout period has elapsed.  The task returns the
        // recognition text as result.
        //
        // Note: Since RecognizeOnceAsync() returns only a single utterance, 
        // it is suitable only for single shot recognition like command or query.
        // For long-running multi-utterance recognition, 
        // use StartContinuousRecognitionAsync() instead.

        var result = await sourceLanguageRecognizer.RecognizeOnceAsync();

        // Checks result.
        if (result.Reason == ResultReason.RecognizedSpeech)
        {
            var lidResult = AutoDetectSourceLanguageResult.FromResult(e.Result);
            Console.WriteLine($"RECOGNIZED: Language={lidResult.Language}");
        }
        else if (result.Reason == ResultReason.NoMatch)
        {
            Console.WriteLine($"NOMATCH: Speech could not be recognized.");
        }
        else if (result.Reason == ResultReason.Canceled)
        {
            var cancellation = CancellationDetails.FromResult(result);
            Console.WriteLine($"CANCELED: Reason={cancellation.Reason}");

            if (cancellation.Reason == CancellationReason.Error)
            {
                Console.WriteLine($"CANCELED: ErrorCode={cancellation.ErrorCode}");
                Console.WriteLine($"CANCELED: ErrorDetails={cancellation.ErrorDetails}");
                Console.WriteLine($"CANCELED: Did you update the subscription info?");
            }
        }
    }
}

Comentários

O fim de um único enunciado é determinado ouvindo o silêncio no final ou até que um período de tempo limite tenha decorrido. A tarefa retorna a fala reconhecida em **SpeechRecognitionResult.Text**.

Você pode chamar **StopContinuousRecognitionAsync** para interromper o reconhecimento antes que uma frase seja reconhecida.

Como esse método retorna apenas um único enunciado, ele é adequado apenas para o reconhecimento de captura única, como comando ou consulta. Para reconhecimento de vários enunciados de longa duração, use **StartContinuousRecognitionAsync** em vez disso.

Confira também: Detecção automática de idioma para conversão de fala em texto