SpeechRecognizer Classe

Um reconhecedor de voz. Se precisar de especificar informações de idioma de origem, especifique apenas um destes três parâmetros, idioma, source_language_config ou auto_detect_source_language_config.

Herança
SpeechRecognizer

Construtor

SpeechRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig = None, language: str = None, source_language_config: SourceLanguageConfig = None, auto_detect_source_language_config: AutoDetectSourceLanguageConfig = None)

Parâmetros

Name Description
speech_config
Necessário

A configuração do reconhecedor de voz

audio_config

A configuração da entrada de áudio

valor predefinido: None
language

O idioma de origem

valor predefinido: None
source_language_config

A configuração do idioma de origem

valor predefinido: None
auto_detect_source_language_config

A configuração do idioma de origem de deteção automática

valor predefinido: None

Métodos

recognize_once

Efetua o reconhecimento num modo de bloqueio (síncrono). Devolve depois de ser reconhecida uma única expressão. O fim de uma única expressão é determinado ao ouvir o silêncio no final ou até que seja processado um máximo de 15 segundos de áudio. A tarefa devolve o texto de reconhecimento como resultado. Para um reconhecimento de várias expressões de execução prolongada, utilize start_continuous_recognition_async.

recognize_once_async

Efetua o reconhecimento num modo não bloqueado (assíncrono). Isto irá reconhecer uma única expressão. O fim de uma única expressão é determinado ao ouvir o silêncio no final ou até que seja processado um máximo de 15 segundos de áudio. Para um reconhecimento de várias expressões de execução prolongada, utilize start_continuous_recognition_async.

start_continuous_recognition

Inicia síncronamente a operação de reconhecimento contínuo. O utilizador tem de se ligar ao EventSignal para receber resultados de reconhecimento. Chame stop_continuous_recognition_async para parar o reconhecimento.

start_continuous_recognition_async

Inicia de forma assíncrona a operação de reconhecimento contínuo. O utilizador tem de se ligar ao EventSignal para receber resultados de reconhecimento. Chame stop_continuous_recognition_async para parar o reconhecimento.

start_keyword_recognition

Configura de forma síncrona o reconhecedor com o modelo de palavra-chave especificado. Depois de chamar este método, o reconhecedor está a escutar a palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition() para terminar o reconhecimento iniciado pela palavra-chave.

start_keyword_recognition_async

Configura de forma assíncrona o reconhecedor com o modelo de palavra-chave especificado. Depois de chamar este método, o reconhecedor está a escutar a palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition_async() para terminar o reconhecimento iniciado pela palavra-chave.

stop_continuous_recognition

A operação de reconhecimento contínuo termina de forma síncrona.

stop_continuous_recognition_async

O assíncrono termina de forma assíncrona a operação de reconhecimento contínuo.

stop_keyword_recognition

O reconhecimento iniciado pela palavra-chave termina de forma síncrona.

stop_keyword_recognition_async

O reconhecimento iniciado pela palavra-chave termina de forma assíncrona.

recognize_once

Efetua o reconhecimento num modo de bloqueio (síncrono). Devolve depois de ser reconhecida uma única expressão. O fim de uma única expressão é determinado ao ouvir o silêncio no final ou até que seja processado um máximo de 15 segundos de áudio. A tarefa devolve o texto de reconhecimento como resultado. Para um reconhecimento de várias expressões de execução prolongada, utilize start_continuous_recognition_async.

recognize_once() -> SpeechRecognitionResult

Devoluções

Tipo Description

O valor de resultado do reconhecimento síncrono.

recognize_once_async

Efetua o reconhecimento num modo não bloqueado (assíncrono). Isto irá reconhecer uma única expressão. O fim de uma única expressão é determinado ao ouvir o silêncio no final ou até que seja processado um máximo de 15 segundos de áudio. Para um reconhecimento de várias expressões de execução prolongada, utilize start_continuous_recognition_async.

recognize_once_async() -> ResultFuture

Devoluções

Tipo Description

Um futuro que contém o valor de resultado do reconhecimento assíncrono.

start_continuous_recognition

Inicia síncronamente a operação de reconhecimento contínuo. O utilizador tem de se ligar ao EventSignal para receber resultados de reconhecimento. Chame stop_continuous_recognition_async para parar o reconhecimento.

start_continuous_recognition()

start_continuous_recognition_async

Inicia de forma assíncrona a operação de reconhecimento contínuo. O utilizador tem de se ligar ao EventSignal para receber resultados de reconhecimento. Chame stop_continuous_recognition_async para parar o reconhecimento.

start_continuous_recognition_async() -> ResultFuture

Devoluções

Tipo Description

Um futuro que é cumprido após a inicialização do reconhecimento.

start_keyword_recognition

Configura de forma síncrona o reconhecedor com o modelo de palavra-chave especificado. Depois de chamar este método, o reconhecedor está a escutar a palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition() para terminar o reconhecimento iniciado pela palavra-chave.

start_keyword_recognition(model: KeywordRecognitionModel)

Parâmetros

Name Description
model
Necessário

o modelo de reconhecimento de palavras-chave que especifica a palavra-chave a ser reconhecida.

start_keyword_recognition_async

Configura de forma assíncrona o reconhecedor com o modelo de palavra-chave especificado. Depois de chamar este método, o reconhecedor está a escutar a palavra-chave para iniciar o reconhecimento. Chame stop_keyword_recognition_async() para terminar o reconhecimento iniciado pela palavra-chave.

start_keyword_recognition_async(model: KeywordRecognitionModel) -> ResultFuture

Parâmetros

Name Description
model
Necessário

o modelo de reconhecimento de palavras-chave que especifica a palavra-chave a ser reconhecida.

Devoluções

Tipo Description

Um futuro que é cumprido após a inicialização do reconhecimento.

stop_continuous_recognition

A operação de reconhecimento contínuo termina de forma síncrona.

stop_continuous_recognition()

stop_continuous_recognition_async

O assíncrono termina de forma assíncrona a operação de reconhecimento contínuo.

stop_continuous_recognition_async()

Devoluções

Tipo Description

Um futuro que é cumprido assim que o reconhecimento é interrompido.

stop_keyword_recognition

O reconhecimento iniciado pela palavra-chave termina de forma síncrona.

stop_keyword_recognition()

stop_keyword_recognition_async

O reconhecimento iniciado pela palavra-chave termina de forma assíncrona.

stop_keyword_recognition_async()

Devoluções

Tipo Description

Um futuro que é cumprido assim que o reconhecimento é interrompido.

Atributos

authorization_token

O token de autorização que será utilizado para ligar ao serviço.

Nota

O autor da chamada tem de garantir que o token de autorização é válido. Antes da

o token de autorização expira, o autor da chamada tem de atualiá-lo ao chamar este setter com um

novo token válido. Caso contrário, o reconhecedor irá encontrar erros durante o reconhecimento.

canceled

Sinal para eventos que contenham resultados de reconhecimento cancelados (indicando uma tentativa de reconhecimento que foi cancelada como resultado ou um pedido de cancelamento direto ou, em alternativa, uma falha de transporte ou protocolo).

As chamadas de retorno ligadas a este sinal são chamadas com uma SpeechRecognitionCanceledEventArgsinstância , como o único argumento.

endpoint_id

O ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento ou um modelo de voz personalizado para sintetização de voz.

properties

Uma coleção de propriedades e os respetivos valores definidos para este Reconhecedor.

recognized

Sinal para eventos que contêm resultados de reconhecimento final (indicando uma tentativa de reconhecimento bem-sucedida).

As chamadas de retorno ligadas a este sinal são chamadas com uma SpeechRecognitionEventArgs instância como argumento único, dependendo do tipo de reconhecedor.

recognizing

Sinal para eventos que contêm resultados de reconhecimento intermédio.

As chamadas de retorno ligadas a este sinal são chamadas com uma SpeechRecognitionEventArgs instância como argumento único.

session_started

Sinal para eventos que indicam o início de uma sessão de reconhecimento (operação).

As chamadas de retorno ligadas a este sinal são chamadas com uma SessionEventArgs instância como argumento único.

session_stopped

Sinal para eventos que indicam o fim de uma sessão de reconhecimento (operação).

As chamadas de retorno ligadas a este sinal são chamadas com uma SessionEventArgs instância como argumento único.

speech_end_detected

Sinal para eventos que indicam o fim da voz.

As chamadas de retorno ligadas a este sinal são chamadas com uma RecognitionEventArgs instância como argumento único.

speech_start_detected

Sinal para eventos que indicam o início da voz.

As chamadas de retorno ligadas a este sinal são chamadas com uma RecognitionEventArgs instância como argumento único.