Connection Classe

Definição

Namespace:

Microsoft.CognitiveServices.Speech

Assembly:

Microsoft.CognitiveServices.Speech.csharp.dll

Pacote:

Microsoft.CognitiveServices.Speech v1.34.0

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

Object

Connection

Implementações

IDisposable

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.