DialogServiceConnector class
Conector do Serviço de Caixa de Diálogo
- Extends
Construtores
Dialog |
Inicializa uma instância do DialogServiceConnector. |
Propriedades
activity |
A atividade do eventoReceived indica que foi recebida uma atividade. |
authorization |
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. |
internal |
|
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. |
speech |
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 |
telemetry |
Este método devolve o estado atual da definição de telemetria. |
turn |
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
session |
Define o processador de eventos para eventos iniciados pela sessão. |
session |
Define o processador de eventos para eventos parados de sessão. |
speech |
Define o processador de eventos para eventos parados de voz. |
speech |
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. |
listen |
Inicia o reconhecimento e para após a primeira expressão ser reconhecida. |
send |
Métodos Herdados
enable |
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
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