Partilhar via


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

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 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.

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 de fala interrompida.

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)

Elimina todos os recursos detidos 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. 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.

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.

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.

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

Interrompe o reconhecimento contínuo de fala.

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.

Métodos Herdados

enableTelemetry(boolean)

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

herdado de Recognizer.speechEndDetected

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.

herdado de Recognizer.enableTelemetry