SpeechRecognizer class

Pacote:

microsoft-cognitiveservices-speech-sdk

Efetua o reconhecimento de voz a partir do microfone, ficheiro ou outros fluxos de entrada de áudio e obtém texto transcrito como resultado.

Extends

Recognizer

Construtores

SpeechRecognizer(SpeechConfig, AudioConfig)

Construtor SpeechRecognizer.

Propriedades

authorizationToken	Obtém o token de autorização utilizado para comunicar com o serviço.
canceled	O evento cancelou sinais de que ocorreu um erro durante o reconhecimento.
endpointId	Obtém o ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento de voz.
internalData
outputFormat	Obtém o formato de saída do reconhecimento.
properties	A coleção de propriedades e os respetivos valores definidos para este SpeechRecognizer.
recognized	O evento reconheceu sinais de que é recebido um resultado de reconhecimento final.
recognizing	O evento que reconhece sinais de que é recebido um resultado de reconhecimento intermédio.
speechRecognitionLanguage	Obtém o idioma falado do reconhecimento.
telemetryEnabled	Este método devolve o estado atual da definição de telemetria.

Propriedades Herdadas

sessionStarted	Define o processador de eventos para eventos iniciados pela sessão.
sessionStopped	Define o processador de eventos para eventos parados de sessão.
speechEndDetected	Define o processador de eventos para eventos de voz parada.
speechStartDetected	Define o processador de eventos para eventos de voz iniciada.

Métodos

close(() => void, (error: string) => void)	fecha todos os recursos externos detidos por uma instância desta classe.
dispose(boolean)	Elimina todos os recursos detidos pelo objeto.
FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)	Construtor SpeechRecognizer.
recognizeOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)	Inicia o reconhecimento de voz e para após a primeira expressão ser reconhecida. A tarefa devolve o texto de reconhecimento como resultado. Nota: RecognizeOnceAsync() devolve quando a primeira expressão é reconhecida, pelo que é adequada apenas para reconhecimento de captura única, como comando ou consulta. Para reconhecimento de execução prolongada, utilize StartContinuousRecognitionAsync().
startContinuousRecognitionAsync(() => void, (e: string) => void)	Inicia o reconhecimento de voz, até que stopContinuousRecognitionAsync() seja chamado. O utilizador tem de subscrever eventos para receber resultados de reconhecimento.
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)	Inicia o reconhecimento de voz com a deteção de palavras-chave, até que stopKeywordRecognitionAsync() seja chamado. O utilizador tem de subscrever eventos para receber resultados de reconhecimento. Nota: a funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Voz. Esta funcionalidade não está atualmente incluída no próprio SDK.
stopContinuousRecognitionAsync(() => void, (e: string) => void)	Para o reconhecimento de voz contínuo.
stopKeywordRecognitionAsync(() => void)	Para o reconhecimento de voz contínuo. Nota: a funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Voz. Esta funcionalidade não está atualmente incluída no próprio SDK.

Métodos Herdados

enableTelemetry(boolean)

Este método ativa ou desativa 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 utilizado para comunicar com o serviço.

string authorizationToken

Valor de Propriedade

string

Token de autorização.

canceled

O evento cancelou sinais de 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 o ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento de voz.

string endpointId

Valor de Propriedade

string

o ID de ponto final de um modelo de voz personalizado que é utilizado para reconhecimento de voz.

internalData

object internalData

Valor de Propriedade

object

outputFormat

Obtém o formato de saída do reconhecimento.

OutputFormat outputFormat

Valor de Propriedade

OutputFormat

O formato de saída do reconhecimento.

properties

A coleção de propriedades e os respetivos valores definidos para este SpeechRecognizer.

PropertyCollection properties

Valor de Propriedade

PropertyCollection

A coleção de propriedades e os respetivos valores definidos para este SpeechRecognizer.

recognized

O evento reconheceu sinais de que é recebido um resultado de reconhecimento final.

public recognized: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void

Valor de Propriedade

(sender: Recognizer, event: SpeechRecognitionEventArgs) => void

recognizing

O evento que reconhece sinais de que é recebido um resultado de reconhecimento intermédio.

public recognizing: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void

Valor de Propriedade

(sender: Recognizer, event: SpeechRecognitionEventArgs) => void

speechRecognitionLanguage

Obtém o idioma falado do reconhecimento.

string speechRecognitionLanguage

Valor de Propriedade

string

O idioma falado do reconhecimento.

telemetryEnabled

Este método devolve o estado atual da definição de telemetria.

static boolean telemetryEnabled

Valor de Propriedade

boolean

true se a telemetria estiver ativada, falso caso contrário.

Detalhes da Propriedade Herdada

sessionStarted

Define o processador 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 processador de eventos para eventos parados de sessão.

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

Valor de Propriedade

(sender: Recognizer, event: SessionEventArgs) => void

Herdado deRecognizer.sessionStopped

speechEndDetected

Define o processador de eventos para eventos de voz parada.

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

Valor de Propriedade

(sender: Recognizer, event: RecognitionEventArgs) => void

Herdado deRecognizer.speechEndDetected

speechStartDetected

Define o processador de eventos para eventos de voz iniciada.

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 detidos por uma instância desta 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 eliminar 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

SpeechRecognizer

recognizeOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)

Inicia o reconhecimento de voz e para após a primeira expressão ser reconhecida. A tarefa devolve o texto de reconhecimento como resultado. Nota: RecognizeOnceAsync() devolve quando a primeira expressão é reconhecida, pelo que é adequada apenas para reconhecimento de captura única, como comando ou consulta. Para reconhecimento de execução prolongada, utilize StartContinuousRecognitionAsync().

function recognizeOnceAsync(cb?: (e: SpeechRecognitionResult) => void, err?: (e: string) => void)

Parâmetros

cb

(e: SpeechRecognitionResult) => void

Chamada de retorno que recebeu SpeechRecognitionResult.

err

(e: string) => void

Chamada de retorno invocada em caso de erro.

startContinuousRecognitionAsync(() => void, (e: string) => void)

Inicia o reconhecimento de voz, até que stopContinuousRecognitionAsync() seja chamado. O utilizador tem de subscrever eventos para receber resultados de reconhecimento.

function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Parâmetros

cb

() => void

Chamada de retorno invocada assim que o reconhecimento é iniciado.

err

(e: string) => void

Chamada de retorno invocada em caso de erro.

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

Inicia o reconhecimento de voz com a deteção de palavras-chave, até que stopKeywordRecognitionAsync() seja chamado. O utilizador tem de subscrever eventos para receber resultados de reconhecimento. Nota: a funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Voz. Esta funcionalidade não está atualmente incluída no próprio SDK.

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

Parâmetros

model

KeywordRecognitionModel

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

cb

() => void

Chamada de retorno invocada assim que o reconhecimento é iniciado.

err

(e: string) => void

Chamada de retorno invocada em caso de erro.

stopContinuousRecognitionAsync(() => void, (e: string) => void)

Para o reconhecimento de voz contínuo.

function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Parâmetros

cb

() => void

Chamada de retorno invocada assim que o reconhecimento tiver parado.

err

(e: string) => void

Chamada de retorno invocada em caso de erro.

stopKeywordRecognitionAsync(() => void)

Para o reconhecimento de voz contínuo. Nota: a funcionalidade de deteção de palavras-chave só está disponível no SDK de Dispositivos de Voz. Esta funcionalidade não está atualmente incluída no próprio SDK.

function stopKeywordRecognitionAsync(cb?: () => void)

Parâmetros

cb

() => void

Chamada de retorno invocada assim que o reconhecimento tiver parado.

Detalhes do Método Herdado

enableTelemetry(boolean)

Este método ativa ou desativa globalmente a telemetria.

static function enableTelemetry(enabled: boolean)

Parâmetros

enabled

boolean

Definição global da coleção de telemetria. Se estiver definido como verdadeiro, as informações de telemetria, como erros de microfone, são recolhidos e enviados erros de reconhecimento à Microsoft. Se estiver definido como falso, não será enviada qualquer telemetria à Microsoft.

Herdado doReconhecedor.enableTelemetry