SpeechRecognizer class

Executa o reconhecimento de fala de microfone, arquivo ou outros fluxos de entrada de áudio e obtém texto transcrito como resultado.

Extends

Construtores

SpeechRecognizer(SpeechConfig, AudioConfig)

Construtor SpeechRecognizer.

Propriedades

authorizationToken

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.

endpointId

Obtém a ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala.

internalData
outputFormat

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

properties

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

recognized

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

recognizing

O evento reconhecendo sinais de que um resultado de reconhecimento intermediário é recebido.

speechRecognitionLanguage

Obtém a linguagem falada de reconhecimento.

telemetryEnabled

Esse método retorna o estado atual da configuração de telemetria.

Propriedades herdadas

sessionStarted

Define o manipulador de eventos para eventos iniciados pela sessão.

sessionStopped

Define o manipulador de eventos para eventos interrompidos de sessão.

speechEndDetected

Define o manipulador de eventos para eventos interrompidos por fala.

speechStartDetected

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)

Descarta todos os recursos mantidos pelo objeto .

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Construtor SpeechRecognizer.

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. Observação: RecognizeOnceAsync() retorna quando o primeiro enunciado é reconhecido, portanto, ele é adequado apenas para o reconhecimento de captura única, como comando ou consulta. Para reconhecimento de longa duração, use StartContinuousRecognitionAsync() em vez disso.

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

Inicia o reconhecimento de fala, até que stopContinuousRecognitionAsync() seja chamado. O usuário deve assinar eventos para receber resultados de reconhecimento.

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

Inicia o reconhecimento de fala com palavra-chave localização, até que stopKeywordRecognitionAsync() seja chamado. O usuário deve assinar eventos para receber resultados de reconhecimento. Observação: a funcionalidade de detecção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no próprio SDK.

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

Interrompe o reconhecimento contínuo de fala.

stopKeywordRecognitionAsync(() => void)

Interrompe o reconhecimento contínuo de fala. Observação: a funcionalidade de detecção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no próprio SDK.

Métodos herdados

enableTelemetry(boolean)

Esse método habilita ou desabilita a telemetria globalmente.

Detalhes do construtor

SpeechRecognizer(SpeechConfig, AudioConfig)

Construtor SpeechRecognizer.

new SpeechRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

Parâmetros

speechConfig
SpeechConfig

um conjunto de propriedades iniciais para esse reconhecedor

audioConfig
AudioConfig

Uma configuração de áudio opcional associada ao reconhecedor

Detalhes da propriedade

authorizationToken

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

string authorizationToken

Valor da 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 da 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 da propriedade

string

a ID do ponto de extremidade de um modelo de fala personalizado que é usado para reconhecimento de fala.

internalData

object internalData

Valor da propriedade

object

outputFormat

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

OutputFormat outputFormat

Valor da propriedade

O formato de saída de reconhecimento.

properties

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

PropertyCollection properties

Valor da propriedade

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

recognized

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

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

Valor da propriedade

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

recognizing

O evento reconhecendo sinais de que um resultado de reconhecimento intermediário é recebido.

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

Valor da propriedade

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

speechRecognitionLanguage

Obtém a linguagem falada de reconhecimento.

string speechRecognitionLanguage

Valor da propriedade

string

A linguagem falada de reconhecimento.

telemetryEnabled

Esse método retorna o estado atual da configuração de telemetria.

static boolean telemetryEnabled

Valor da propriedade

boolean

true se a telemetria estiver habilitada, caso contrário, false.

Detalhes das propriedades herdadas

sessionStarted

Define o manipulador de eventos para eventos iniciados pela sessão.

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

Valor da 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 da propriedade

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

Herdado deRecognizer.sessionStopped

speechEndDetected

Define o manipulador de eventos para eventos interrompidos por fala.

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

Valor da propriedade

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

Herdado deRecognizer.speechEndDetected

speechStartDetected

Define o manipulador de eventos para eventos iniciados por fala.

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

Valor da propriedade

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

Herdado deRecognizer.speechStartDetected

Detalhes do 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)

Descarta todos os recursos mantidos pelo objeto .

function dispose(disposing: boolean): Promise<void>

Parâmetros

disposing

boolean

true se estiver descartando o objeto.

Retornos

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 esse reconhecedor

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

Uma configuração de detecção de idioma de origem associada ao reconhecedor

audioConfig
AudioConfig

Uma configuração de áudio opcional associada ao reconhecedor

Retornos

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. Observação: RecognizeOnceAsync() retorna quando o primeiro enunciado é reconhecido, portanto, ele é adequado apenas para o reconhecimento de captura única, 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 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 assinar eventos para receber resultados de reconhecimento.

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

Parâmetros

cb

() => void

Retorno de chamada invocado depois que o reconhecimento é 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 palavra-chave localização, até que stopKeywordRecognitionAsync() seja chamado. O usuário deve assinar eventos para receber resultados de reconhecimento. Observação: a funcionalidade de detecção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no próprio SDK.

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

Parâmetros

model
KeywordRecognitionModel

O modelo de reconhecimento palavra-chave que especifica o palavra-chave a ser reconhecido.

cb

() => void

Retorno de chamada invocado depois que o reconhecimento é 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 depois 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. Observação: a funcionalidade de detecção de palavras-chave só está disponível no SDK de Dispositivos de Fala. No momento, essa funcionalidade não está incluída no próprio SDK.

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

Parâmetros

cb

() => void

Retorno de chamada invocado depois que o reconhecimento for interrompido.

Detalhes do método herdado

enableTelemetry(boolean)

Esse método habilita ou desabilita a telemetria globalmente.

static function enableTelemetry(enabled: boolean)

Parâmetros

enabled

boolean

Configuração global da coleção de telemetria. Se definido como true, informações de telemetria como erros de microfone, erros de reconhecimento serão coletados e enviados à Microsoft. Se definido como false, nenhuma telemetria será enviada à Microsoft.

Herdado deRecognizer.enableTelemetry