SpeechRecognizer class
Executa o reconhecimento de fala do microfone, arquivo ou outros fluxos de entrada de áudio e, como resultado, obtém texto transcrito.
- Extends
Construtores
Speech |
Construtor SpeechRecognizer. |
Propriedades
authorization |
Obtém o token de autorização usado para se comunicar com o serviço. |
canceled | O evento cancelado sinaliza que ocorreu um erro durante o reconhecimento. |
endpoint |
Obtém a ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala. |
internal |
|
output |
Obtém o formato de saída do reconhecimento. |
properties | A coleção de propriedades e seus valores definidos para este SpeechRecognizer. |
recognized | O evento reconhecido sinaliza que um resultado final de reconhecimento é recebido. |
recognizing | O evento que reconhece sinais de que um resultado de reconhecimento intermediário é recebido. |
speech |
Obtém a linguagem falada de reconhecimento. |
telemetry |
Esse método retorna o estado atual da configuração de telemetria. |
Propriedades Herdadas
session |
Define o manipulador de eventos para eventos iniciados pela sessão. |
session |
Define o manipulador de eventos para eventos interrompidos de sessão. |
speech |
Define o manipulador de eventos para eventos de fala interrompida. |
speech |
Define o manipulador de eventos para eventos iniciados por fala. |
Métodos
close(() => void, (error: string) => void) | Fecha todos os recursos externos mantidos por uma instância dessa classe. |
dispose(boolean) | Elimina todos os recursos detidos pelo objeto. |
From |
Construtor SpeechRecognizer. |
recognize |
Inicia o reconhecimento de fala e para depois que o primeiro enunciado é reconhecido. A tarefa retorna o texto de reconhecimento como resultado. Nota: RecognizeOnceAsync() retorna quando o primeiro enunciado foi reconhecido, por isso é adequado apenas para reconhecimento de disparo único, como comando ou consulta. Para reconhecimento de longa duração, use StartContinuousRecognitionAsync() em vez disso. |
start |
Inicia o reconhecimento de fala até que stopContinuousRecognitionAsync() seja chamado. O usuário deve se inscrever em eventos para receber resultados de reconhecimento. |
start |
Inicia o reconhecimento de fala com a localização de palavras-chave, até que stopKeywordRecognitionAsync() seja chamado. O usuário deve se inscrever em eventos para receber resultados de reconhecimento. Nota: A funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no SDK em si. |
stop |
Interrompe o reconhecimento contínuo de fala. |
stop |
Interrompe o reconhecimento contínuo de fala. Nota: A funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no SDK em si. |
Métodos Herdados
enable |
Este método habilita ou desabilita globalmente a telemetria. |
Detalhes do Construtor
SpeechRecognizer(SpeechConfig, AudioConfig)
Construtor SpeechRecognizer.
new SpeechRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)
Parâmetros
- speechConfig
- SpeechConfig
Um conjunto de propriedades iniciais para este reconhecedor
- audioConfig
- AudioConfig
Uma configuração de áudio opcional associada ao reconhecedor
Detalhes de Propriedade
authorizationToken
Obtém o token de autorização usado para se comunicar com o serviço.
string authorizationToken
Valor de Propriedade
string
Token de autorização.
canceled
O evento cancelado sinaliza que ocorreu um erro durante o reconhecimento.
public canceled: (sender: Recognizer, event: SpeechRecognitionCanceledEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SpeechRecognitionCanceledEventArgs) => void
endpointId
Obtém a ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala.
string endpointId
Valor de Propriedade
string
O ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala.
internalData
object internalData
Valor de Propriedade
object
outputFormat
Obtém o formato de saída do reconhecimento.
OutputFormat outputFormat
Valor de Propriedade
O formato de saída do reconhecimento.
properties
A coleção de propriedades e seus valores definidos para este SpeechRecognizer.
PropertyCollection properties
Valor de Propriedade
A coleção de propriedades e seus valores definidos para este SpeechRecognizer.
recognized
O evento reconhecido sinaliza que um resultado final de reconhecimento é recebido.
public recognized: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SpeechRecognitionEventArgs) => void
recognizing
O evento que reconhece sinais de que um resultado de reconhecimento intermediário é recebido.
public recognizing: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SpeechRecognitionEventArgs) => void
speechRecognitionLanguage
Obtém a linguagem falada de reconhecimento.
string speechRecognitionLanguage
Valor de Propriedade
string
A língua falada do reconhecimento.
telemetryEnabled
Esse método retorna o estado atual da configuração de telemetria.
static boolean telemetryEnabled
Valor de Propriedade
boolean
true se a telemetria estiver ativada, false caso contrário.
Detalhes da Propriedade Herdada
sessionStarted
Define o manipulador de eventos para eventos iniciados pela sessão.
public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SessionEventArgs) => void
herdado deRecognizer.sessionStarted
sessionStopped
Define o manipulador de eventos para eventos interrompidos de sessão.
public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: SessionEventArgs) => void
herdado deRecognizer.sessionStopped
speechEndDetected
Define o manipulador de eventos para eventos de fala interrompida.
public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: RecognitionEventArgs) => void
speechStartDetected
Define o manipulador de eventos para eventos iniciados por fala.
public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void
Valor de Propriedade
(sender: Recognizer, event: RecognitionEventArgs) => void
herdado deRecognizer.speechStartDetected
Detalhes de Método
close(() => void, (error: string) => void)
Fecha todos os recursos externos mantidos por uma instância dessa classe.
function close(cb?: () => void, errorCb?: (error: string) => void)
Parâmetros
- cb
-
() => void
- errorCb
-
(error: string) => void
dispose(boolean)
Elimina todos os recursos detidos pelo objeto.
function dispose(disposing: boolean): Promise<void>
Parâmetros
- disposing
-
boolean
true se descartar o objeto.
Devoluções
Promise<void>
FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)
Construtor SpeechRecognizer.
static function FromConfig(speechConfig: SpeechConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): SpeechRecognizer
Parâmetros
- speechConfig
- SpeechConfig
Um conjunto de propriedades iniciais para este reconhecedor
- autoDetectSourceLanguageConfig
- AutoDetectSourceLanguageConfig
Uma configuração de deteção de idioma de origem associada ao reconhecedor
- audioConfig
- AudioConfig
Uma configuração de áudio opcional associada ao reconhecedor
Devoluções
recognizeOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)
Inicia o reconhecimento de fala e para depois que o primeiro enunciado é reconhecido. A tarefa retorna o texto de reconhecimento como resultado. Nota: RecognizeOnceAsync() retorna quando o primeiro enunciado foi reconhecido, por isso é adequado apenas para reconhecimento de disparo único, como comando ou consulta. Para reconhecimento de longa duração, use StartContinuousRecognitionAsync() em vez disso.
function recognizeOnceAsync(cb?: (e: SpeechRecognitionResult) => void, err?: (e: string) => void)
Parâmetros
- cb
-
(e: SpeechRecognitionResult) => void
Retorno de chamada que recebeu o SpeechRecognitionResult.
- err
-
(e: string) => void
Retorno de chamada invocado em caso de erro.
startContinuousRecognitionAsync(() => void, (e: string) => void)
Inicia o reconhecimento de fala até que stopContinuousRecognitionAsync() seja chamado. O usuário deve se inscrever em eventos para receber resultados de reconhecimento.
function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
Parâmetros
- cb
-
() => void
Retorno de chamada invocado assim que o reconhecimento for iniciado.
- err
-
(e: string) => void
Retorno de chamada invocado em caso de erro.
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)
Inicia o reconhecimento de fala com a localização de palavras-chave, até que stopKeywordRecognitionAsync() seja chamado. O usuário deve se inscrever em eventos para receber resultados de reconhecimento. Nota: A funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no SDK em si.
function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)
Parâmetros
- model
- KeywordRecognitionModel
O modelo de reconhecimento de palavra-chave que especifica a palavra-chave a ser reconhecida.
- cb
-
() => void
Retorno de chamada invocado assim que o reconhecimento for iniciado.
- err
-
(e: string) => void
Retorno de chamada invocado em caso de erro.
stopContinuousRecognitionAsync(() => void, (e: string) => void)
Interrompe o reconhecimento contínuo de fala.
function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)
Parâmetros
- cb
-
() => void
Retorno de chamada invocado assim que o reconhecimento for interrompido.
- err
-
(e: string) => void
Retorno de chamada invocado em caso de erro.
stopKeywordRecognitionAsync(() => void)
Interrompe o reconhecimento contínuo de fala. Nota: A funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no SDK em si.
function stopKeywordRecognitionAsync(cb?: () => void)
Parâmetros
- cb
-
() => void
Retorno de chamada invocado assim que o reconhecimento for interrompido.
Detalhes do Método Herdado
enableTelemetry(boolean)
Este método habilita ou desabilita globalmente a telemetria.
static function enableTelemetry(enabled: boolean)
Parâmetros
- enabled
-
boolean
Configuração global para coleta de telemetria. Se definido como true, as informações de telemetria, como erros de microfone, erros de reconhecimento, são coletadas e enviadas à Microsoft. Se definido como false, nenhuma telemetria será enviada à Microsoft.