Partilhar via


Connection Classe

Definição

Uma classe proxy para gerenciar a conexão com o serviço de fala do Reconhecedor especificado. Adicionado na versão 1.2.0

public sealed class Connection : IDisposable
type Connection = class
    interface IDisposable
Public NotInheritable Class Connection
Implements IDisposable
Herança
Connection
Implementações

Comentários

Por padrão, um Reconhecedor gerencia de forma autônoma a conexão com o serviço quando necessário. A classe Connection fornece métodos adicionais que você pode usar para abrir ou fechar explicitamente uma conexão e assinar a conexão status alterações. O uso de Connection é opcional. Ele destina-se a cenários em que é necessário ajustar o comportamento do aplicativo com base no status de conexão. Opcionalmente, você pode chamar Open() para iniciar manualmente uma conexão de serviço antes de iniciar o reconhecimento no Reconhecedor associado a essa Conexão. Depois de iniciar um reconhecimento, chamar Open() ou Close() pode falhar. Isso não afetará o Reconhecedor nem o reconhecimento contínuo. A conexão pode cair por vários motivos, o Reconhecedor sempre tentará reinstituir a conexão conforme necessário para garantir operações em andamento. Em todos esses casos, eventos Conectados/Desconectados indicarão a alteração do status de conexão.

Métodos

Close()

Fecha a conexão do serviço. Opcionalmente, você pode chamar Close() para desligar manualmente a conexão do Reconhecedor associado. A chamada pode falhar, dependendo do estado do processo do Reconhecedor. Mas a falha não afeta o estado do Reconhecedor associado.

Dispose()

Descarte os recursos associados.

Finalize()

Uma classe proxy para gerenciar a conexão com o serviço de fala do Reconhecedor especificado. Adicionado na versão 1.2.0

FromConversationTranslator(ConversationTranslator)

Obtém a instância de Conexão do tradutor de conversa.

FromDialogServiceConnector(DialogServiceConnector)

Obtém a instância de Conexão do conector de serviço de caixa de diálogo especificado, usado para observar e gerenciar a conexão e a desconexão do serviço de fala.

FromRecognizer(Recognizer)

Obtém a instância de Conexão do reconhecedor especificado.

FromSpeechSynthesizer(SpeechSynthesizer)

Obtém a instância de Conexão do sintetizador de fala especificado, usado para observar e gerenciar a conexão e a desconexão do serviço de fala. Adicionado na versão 1.17.0

Open(Boolean)

Começa a configurar a conexão com o serviço. Opcionalmente, você pode chamar Open() para configurar manualmente uma conexão com antecedência antes de iniciar o reconhecimento no Reconhecedor associado a essa Conexão. Depois de iniciar o reconhecimento, a chamada a Open() pode falhar, dependendo do estado do processo do Reconhecedor. Mas a falha não afeta o estado do Reconhecedor associado. Observação: no retorno, a conexão pode não estar pronta ainda. Assine o evento Connected para ser notificado quando a conexão for estabelecida.

SendMessageAsync(String, Byte[], UInt32)

Envia uma mensagem binária para o serviço de fala como uma operação assíncrona. Observação: esse método não funciona para a conexão do SpeechSynthesizer. Adicionado em 1.10.0

SendMessageAsync(String, String)

Envia uma mensagem para o serviço de Fala como uma operação assíncrona. Observação: esse método não funciona para a conexão do SpeechSynthesizer. Adicionado na versão 1.7.0

SetMessageProperty(String, String, String)

Acrescenta um parâmetro em uma mensagem ao serviço. Observação: esse método não funciona para a conexão do SpeechSynthesizer. Adicionado na versão 1.7.0

Eventos

Connected

O evento Connected para indicar que o reconhecedor está conectado ao serviço. Para receber o evento Connected depois de assinar, o próprio objeto Connection precisa estar ativo. Se o objeto Connection que possui esse evento estiver fora de seu tempo de vida, todos os eventos assinados não serão entregues.

Disconnected

O evento Disconnected para indicar que o reconhecedor está desconectado do serviço. Para receber o evento Disconnected depois de assinar, o próprio objeto Connection precisa estar ativo. Se o objeto Connection que possui esse evento estiver fora de seu tempo de vida, todos os eventos assinados não serão entregues.

MessageReceived

O evento MessageReceived indica que o serviço enviou uma mensagem de rede ao cliente.

Aplica-se a