Compartilhar via


TranslationRecognizer Classe

Definição

Converte a entrada de fala em texto e fala sintetizada em um ou mais idiomas de destino.

public sealed class TranslationRecognizer : Microsoft.CognitiveServices.Speech.Recognizer
type TranslationRecognizer = class
    inherit Recognizer
Public NotInheritable Class TranslationRecognizer
Inherits Recognizer
Herança
TranslationRecognizer

Exemplos

Este exemplo usa o reconhecedor de tradução de um microfone e recebe eventos gerados pelo reconhecedor.

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

Comentários

Confira também: Introdução à tradução de fala

Construtores

TranslationRecognizer(EmbeddedSpeechConfig)

Cria um reconhecedor de tradução usando a entrada de microfone padrão para uma configuração de fala inserida especificada.

TranslationRecognizer(EmbeddedSpeechConfig, AudioConfig)

Cria um reconhecedor de tradução usando a configuração de áudio e o tradutor de fala inseridos especificados.

TranslationRecognizer(HybridSpeechConfig)

Cria um reconhecedor de tradução usando a entrada de microfone padrão para uma configuração de fala híbrida especificada.

TranslationRecognizer(HybridSpeechConfig, AudioConfig)

Cria um reconhecedor de tradução usando o tradutor de fala híbrido e a configuração de áudio especificados.

TranslationRecognizer(SpeechTranslationConfig)

Cria um reconhecedor de tradução usando a entrada de microfone padrão para uma configuração de tradução especificada.

TranslationRecognizer(SpeechTranslationConfig, AudioConfig)

Cria um reconhecedor de tradução usando o tradutor de fala e a configuração de áudio especificados.

TranslationRecognizer(SpeechTranslationConfig, AutoDetectSourceLanguageConfig)

Cria um reconhecedor de tradução usando o tradutor de fala especificado e a configuração de idioma de origem de detecção automática

TranslationRecognizer(SpeechTranslationConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Cria um reconhecedor de tradução usando o tradutor de fala e a configuração de áudio especificados.

Campos

disposed

disposed é um sinalizador usado para indicar se o objeto é descartado.

(Herdado de Recognizer)
gch

Identificador de GC para retornos de chamada para contexto.

(Herdado de Recognizer)
isDisposing

Indica se o objeto está sendo descartado no momento.

(Herdado de Recognizer)
pointerHandle

Interno para registro em log.

(Herdado de Recognizer)
recognizerLock

recognizerLock é usado para sincronizar o acesso a variáveis de membro de objetos de vários threads

(Herdado de Recognizer)

Propriedades

AuthorizationToken

Obtém ou define o token de autorização usado para se comunicar com o serviço.

Properties

A coleção de propriedades e seus valores definidos para este TranslationRecognizer. Observação: a coleção de propriedades só é válida até que o reconhecedor que possui essas Propriedades seja descartado ou finalizado.

SpeechRecognitionLanguage

Obtém o nome do idioma que foi definido quando o reconhecedor foi criado.

TargetLanguages

Obtém os idiomas de destino para tradução que foram definidos quando o reconhecedor foi criado. Cada idioma é especificado no formato BCP-47. A tradução fornecerá texto traduzido para cada idioma.

VoiceName

Obtém o nome da voz de saída se a síntese de fala for usada.

Métodos

AddTargetLanguage(String)

Adiciona um idioma de destino para tradução. Adicionado na versão 1.7.0

Dispose()

Descarte os recursos associados.

(Herdado de Recognizer)
Dispose(Boolean)

Esse método executa a limpeza de recursos. O parâmetro booliano disposing indica se o método é chamado de Dispose() (se disposing for true) ou do finalizador (se disposing for false). As classes derivadas devem substituir esse método para descartar o recurso, se necessário.

(Herdado de Recognizer)
Finalize()

Converte a entrada de fala em texto e fala sintetizada em um ou mais idiomas de destino.

RecognizeOnceAsync()

Inicia a tradução de fala como uma operação assíncrona.

RemoveTargetLanguage(String)

Remove um idioma de destino para tradução. Adicionado na versão 1.7.0

StartContinuousRecognitionAsync()

Inicia o reconhecimento e a tradução em um fluxo de áudio contínuo até StopContinuousRecognitionAsync() ser chamado. Você deve assinar eventos para receber os resultados da tradução.

StartKeywordRecognitionAsync(KeywordRecognitionModel)

Configura o reconhecedor com o modelo de palavra-chave fornecido. Depois de chamar esse método, o reconhecedor está escutando o palavra-chave para iniciar o reconhecimento. Chame StopKeywordRecognitionAsync() para encerrar o reconhecimento iniciado palavra-chave. Você deve assinar eventos para receber resultados de reconhecimento.

StopContinuousRecognitionAsync()

Interrompe uma operação de reconhecimento em execução assim que possível e solicita imediatamente um resultado com base na entrada que foi processada até agora. Isso funciona para todas as operações de reconhecimento, não apenas as contínuas, e facilita o uso de botões push-to-talk ou "concluir agora" para pontos de extremidade de áudio manuais.

StopKeywordRecognitionAsync()

Encerra o reconhecimento iniciado palavra-chave.

Eventos

Canceled

O evento Canceled sinaliza que a conversão de fala em texto/síntese foi cancelada.

Recognized

O evento Recognized sinaliza que um resultado de reconhecimento final é recebido.

Recognizing

O evento Recognizing sinaliza que um resultado de reconhecimento intermediário é recebido.

SessionStarted

Define o manipulador de eventos para o evento iniciado pela sessão.

(Herdado de Recognizer)
SessionStopped

Define o manipulador de eventos para o evento de sessão interrompida.

(Herdado de Recognizer)
SpeechEndDetected

Define o manipulador de eventos para o evento detectado de fim de fala.

(Herdado de Recognizer)
SpeechStartDetected

Define o manipulador de eventos para o evento detectado de início de fala.

(Herdado de Recognizer)
Synthesizing

O evento Synthesizing sinaliza que um resultado de síntese de tradução é recebido.

Aplica-se a