DialogServiceConnector class

Pacote:

microsoft-cognitiveservices-speech-sdk

Conector do Serviço de Caixa de Diálogo

Extends

Recognizer

Construtores

DialogServiceConnector(DialogServiceConfig, AudioConfig)

Inicializa uma instância do DialogServiceConnector.

Propriedades

activityReceived	A atividade do eventoReceived indica que foi recebida uma atividade.
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.
internalData
properties	A coleção de propriedades e os respetivos valores definidos para este DialogServiceConnector.
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.
speechActivityTemplate	Obtém o modelo para a atividade gerada pelo serviço a partir da voz. As propriedades do modelo serão carimbadas na atividade gerada. Pode estar vazio
telemetryEnabled	Este método devolve o estado atual da definição de telemetria.
turnStatusReceived	O evento turnStatusReceived indica que foi recebida uma mensagem de estado de viragem. Estas mensagens estão associadas a uma interação e a uma conversação. São utilizados para notificar o cliente em caso de falha de interação com o back-end da caixa de diálogo, por exemplo, em caso de problema de rede, tempo limite, falha ou outro problema.

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 parados de voz.
speechStartDetected	Define o processador de eventos para eventos iniciados por voz.

Métodos

close(() => void, (error: string) => void)	fecha todos os recursos externos detidos por uma instância desta classe.
connect(() => void, (error: string) => void)	Inicia uma ligação ao serviço. Opcionalmente, os utilizadores podem chamar connect() para configurar manualmente uma ligação com antecedência, antes de iniciarem as interações. Nota: na devolução, a ligação poderá ainda não estar pronta. Subscreva o evento Ligado para ser notificado quando a ligação for estabelecida.
disconnect(() => void, (error: string) => void)	Fecha a ligação do serviço. Opcionalmente, os utilizadores podem chamar desligar() para encerrar manualmente a ligação do DialogServiceConnector associado. Se desligar() for chamado durante um reconhecimento, o reconhecimento falhará e cancelará com um erro.
listenOnceAsync((e: SpeechRecognitionResult) => void, (e: string) => void)	Inicia o reconhecimento e para após a primeira expressão ser reconhecida.
sendActivityAsync(string, () => void, (error: string) => void)

Métodos Herdados

enableTelemetry(boolean)

Este método ativa ou desativa globalmente a telemetria.

Detalhes do Construtor

DialogServiceConnector(DialogServiceConfig, AudioConfig)

Inicializa uma instância do DialogServiceConnector.

new DialogServiceConnector(dialogConfig: DialogServiceConfig, audioConfig?: AudioConfig)

Parâmetros

dialogConfig

DialogServiceConfig

Conjunto de propriedades para configurar este reconhecedor.

audioConfig

AudioConfig

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

Detalhes de Propriedade

activityReceived

A atividade do eventoReceived indica que foi recebida uma atividade.

public activityReceived: (sender: DialogServiceConnector, event: ActivityReceivedEventArgs) => void

Valor de Propriedade

(sender: DialogServiceConnector, event: ActivityReceivedEventArgs) => void

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: DialogServiceConnector, event: SpeechRecognitionCanceledEventArgs) => void

Valor de Propriedade

(sender: DialogServiceConnector, event: SpeechRecognitionCanceledEventArgs) => void

internalData

object internalData

Valor de Propriedade

object

properties

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

PropertyCollection properties

Valor de Propriedade

PropertyCollection

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

recognized

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

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

Valor de Propriedade

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

recognizing

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

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

Valor de Propriedade

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

speechActivityTemplate

Obtém o modelo para a atividade gerada pelo serviço a partir da voz. As propriedades do modelo serão carimbadas na atividade gerada. Pode estar vazio

string speechActivityTemplate

Valor de Propriedade

string

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.

turnStatusReceived

O evento turnStatusReceived indica que foi recebida uma mensagem de estado de viragem. Estas mensagens estão associadas a uma interação e a uma conversação. São utilizados para notificar o cliente em caso de falha de interação com o back-end da caixa de diálogo, por exemplo, em caso de problema de rede, tempo limite, falha ou outro problema.

public turnStatusReceived: (sender: DialogServiceConnector, event: TurnStatusReceivedEventArgs) => void

Valor de Propriedade

(sender: DialogServiceConnector, event: TurnStatusReceivedEventArgs) => void

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 parados de voz.

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 iniciados por voz.

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, err?: (error: string) => void)

Parâmetros

cb

() => void

err

(error: string) => void

connect(() => void, (error: string) => void)

Inicia uma ligação ao serviço. Opcionalmente, os utilizadores podem chamar connect() para configurar manualmente uma ligação com antecedência, antes de iniciarem as interações.

Nota: na devolução, a ligação poderá ainda não estar pronta. Subscreva o evento Ligado para ser notificado quando a ligação for estabelecida.

function connect(cb?: () => void, err?: (error: string) => void)

Parâmetros

cb

() => void

err

(error: string) => void

disconnect(() => void, (error: string) => void)

Fecha a ligação do serviço. Opcionalmente, os utilizadores podem chamar desligar() para encerrar manualmente a ligação do DialogServiceConnector associado.

Se desligar() for chamado durante um reconhecimento, o reconhecimento falhará e cancelará com um erro.

function disconnect(cb?: () => void, err?: (error: string) => void)

Parâmetros

cb

() => void

err

(error: string) => void

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

Inicia o reconhecimento e para após a primeira expressão ser reconhecida.

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

Parâmetros

cb

(e: SpeechRecognitionResult) => void

Chamada de retorno que recebeu o resultado quando o reco foi concluído.

err

(e: string) => void

Chamada de retorno invocada em caso de erro.

sendActivityAsync(string, () => void, (error: string) => void)

function sendActivityAsync(activity: string, cb?: () => void, errCb?: (error: string) => void)

Parâmetros

activity

string

cb

() => void

errCb

(error: string) => void

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 para a Microsoft. Se estiver definido como falso, não será enviada telemetria para a Microsoft.

Herdado doReconhecedor.enableTelemetry