Usando o Cliente WebSocket no .NET

TsgcWebSocketClient é o wrapper .NET do cliente de runtime sgcWebSockets. Ele herda todas as capacidades WebSocket do TsgcWebSocketClient_base, fornecendo às aplicações .NET uma API de estilo componente para conectar, enviar e receber via WebSockets.

Propriedades principais

• Host & Port – endpoint do servidor de destino
• Options.Parameters – caminho de URL ou parâmetros de query para o handshake WebSocket
• TLS & TLSOptions – habilitar TLS e selecionar versão do protocolo/IO handler
• Specifications.RFC6455 – ativar ou desativar a conformidade com o framing WebSocket RFC6455
• Proxy – configuração de proxy HTTP (Enabled, Username, Password, Host, Port)
• Extensions.PerMessage_Deflate.Enabled – habilitar compressão por mensagem
• Authentication – credenciais de autenticação básica quando necessário
• Active – defina true para conectar, false para desconectar

Eventos

Registre handlers de eventos para reagir ao ciclo de vida da conexão e aos dados:

• OnConnect – disparado após uma conexão bem-sucedida; um handler de exemplo registra o IP do peer
• OnDisconnect – acionado quando a conexão fecha, fornecendo o código de fechamento
• OnMessage – recebe mensagens de texto do servidor
• OnError – reporta erros de protocolo ou socket
• OnException – expõe exceções inesperadas lançadas dentro do componente

Exemplo

using esegece.sgcWebSockets;
var client = new TsgcWebSocketClient();
client.OnConnect    += OnConnectEvent;
client.OnDisconnect += OnDisconnectEvent;
client.OnException  += OnExceptionEvent;
client.OnError      += OnErrorEvent;
client.OnMessage    += OnMessageEvent;
client.Host = "www.esegece.com";
client.Port = 2052;
client.Options.Parameters = "/";
client.TLS = false;
client.Specifications.RFC6455 = true;
client.Active = true;
// Sending data once connected
client.WriteData("Hello WebSocket!");

Este trecho espelha o uso da demo: os eventos são configurados antes de conectar, as propriedades principais são configuradas (host, port, TLS, RFC6455, etc.) e definir Active como true inicia a conexão.

Com os handlers de eventos definidos (conforme mostrado acima), o cliente pode registrar conexões, receber mensagens e enviar dados via WriteData.