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.
Azure SDK for Python
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários