Uma implementação WebSocket nativa, RFC 6455, para Delphi e C++Builder. Construa clientes e servidores que sustentam milhares de conexões concorrentes, rodam em Windows, macOS, Linux, iOS e Android e sobrevivem a redes instáveis com a reconexão automática WatchDog embutida.
Um componente VCL/FMX drop-in que transforma o protocolo WebSocket em uma API de propriedades e eventos que desenvolvedores Delphi reconhecem como nativa.
Um componente WebSocket Delphi é um componente não visual que você arrasta para um form (ou instancia em runtime) para abrir um canal TCP full-duplex entre uma aplicação Delphi e qualquer par WebSocket RFC 6455 — um navegador, um serviço Node.js, um reverse proxy nginx, um broker Mosquitto, um endpoint OpenAI Realtime ou outro processo Delphi. Diferente de polling HTTP, um WebSocket mantém a conexão aberta: o servidor pode empurrar dados no instante em que estiverem disponíveis, com latência de milissegundos e sem o overhead HTTP por mensagem.
O sgcWebSockets é a biblioteca WebSocket de referência no ecossistema Delphi desde 2013. Os mesmos componentes TsgcWebSocketClient e TsgcWebSocketHTTPServer rodam inalterados do Delphi 7 ao Delphi 13, em Win32, Win64, Linux64, macOS, iOS e Android, e em C++Builder C2007 a C13. Não há runtime gerenciado, nem camada de interop .NET, nem bridge JavaScript — é uma implementação Pascal pura que compila dentro do seu binário.
Escrever um handler PING/PONG é fácil. Sobreviver a um reverse proxy que termina TLS, a um módulo WebSocket do IIS, a um firewall corporativo, a um handover de celular móvel e a um teste de carga de 5.000 clientes não é.
WebSocket puro (ws://), WebSocket TLS (wss://), WebSocket sobre HTTP/2, WebSocket sobre QUIC/HTTP/3, fallback TCP cru — mesmo componente, mesmos eventos. Troque o transporte mudando uma propriedade.
Habilite WatchDog e o cliente vai reconectar com backoff exponencial, reautenticar, reassinar tópicos MQTT e repetir publicações enfileiradas — o padrão canônico para mobile / IoT, já escrito.
O servidor usa um reactor IOCP / kqueue / epoll por baixo. Você escreve handlers de evento; a biblioteca os agenda em um pool de threads com serialização por conexão.
Negociado automaticamente conforme a RFC 7692. Reduz payloads JSON em 70–90 % e é suportado por todo navegador moderno e load balancer.
MQTT 3.1.1/5.0, AMQP 0.9.1/1.0, STOMP, WAMP e Server-Sent Events rodam sobre o mesmo transporte WebSocket — um socket TCP, vários protocolos de aplicação.
O TsgcWebSocketHTTPServer serve arquivos estáticos, endpoints REST, recursos protegidos por JWT e OAuth2, respostas comprimidas em gzip e upgrade HTTP/2 no mesmo processo que seu endpoint WebSocket.
OpenSSL (multiplataforma), SChannel (TLS de kernel do Windows) ou HTTP.sys. Certificados de cliente, SNI, ALPN, TLS 1.3 com 0-RTT.
Channels do lado servidor agrupam conexões por nome. Broadcast, BroadcastByChannel e BroadcastByUser fazem fan-out para milhares de pares em uma única chamada.
Em produção em bancos, exchanges, frotas IoT e firmas de trading desde 2013. Atualizado todo mês; o history.txt registra cada correção.
Tudo o que a RFC diz, mais o endurecimento operacional que deployments reais exigem.
| Capacidade | Cliente | Servidor |
|---|---|---|
| Framing RFC 6455 (text, binary, ping, pong, close) | Sim | Sim |
| permessage-deflate (RFC 7692) | Sim | Sim |
| Frames fragmentados & continuation | Sim | Sim |
| Mensagens do cliente mascaradas | Sim | n/d |
| TLS 1.2 / 1.3 (OpenSSL + SChannel) | Sim | Sim |
| Certificados de cliente / mTLS | Sim | Sim |
| Autenticação JWT & OAuth2 | Sim | Sim |
| HTTP/2 + WebSocket (RFC 8441) | Sim | Sim |
| HTTP/3 + WebSocket sobre QUIC (RFC 9220) | Sim | Sim |
| Reconexão automática WatchDog | Sim | n/d |
| Heart-beat (PING/PONG) | Sim | Sim |
| Canais & broadcast | n/d | Sim |
| Subprotocolos (MQTT / AMQP / STOMP / WAMP / SSE) | Sim | Sim |
| Hospedagem HTTP.sys (kernel do Windows) | n/d | Sim |
| Modo daemon Linux | Sim | Sim |
Arraste um TsgcWebSocketClient para o form, defina Host / Port, trate OnMessage, defina Active := True.
uses
sgcWebSocket, sgcWebSocket_Classes;
procedure TForm1.FormCreate(Sender: TObject);
begin
WS := TsgcWebSocketClient.Create(nil);
WS.URL := 'wss://echo.websocket.events';
WS.WatchDog.Enabled := True;
WS.WatchDog.Interval := 5;
WS.OnConnect := WSConnect;
WS.OnMessage := WSMessage;
WS.OnDisconnect := WSDisconnect;
WS.Active := True;
end;
procedure TForm1.WSMessage(Connection: TsgcWSConnection; const Text: string);
begin
Memo1.Lines.Add('<< ' + Text);
end;
procedure TForm1.ButtonSendClick(Sender: TObject);
begin
WS.WriteData('{"hello":"world"}');
end;O lado servidor é simétrico — arraste um TsgcWebSocketHTTPServer, defina Port, trate OnConnect e OnMessage, chame Broadcast para fazer fan-out a cada par conectado.
Uma única árvore de código, 22 pacotes de runtime — cobrindo cada release do Delphi ainda em uso comercial ativo.
| Edição | Versões |
|---|---|
| Delphi / RAD Studio | 7, 2007, 2009, 2010, XE, XE2, XE3, XE4, XE5, XE6, XE7, XE8, 10 Seattle, 10.1 Berlin, 10.2 Tokyo, 10.3 Rio, 10.4 Sydney, 11 Alexandria, 12 Athens, 13 |
| C++Builder | 2007, 2009, 2010, XE, XE2, XE3, XE4, XE5, XE6, XE7, XE8, 10, 10.1, 10.2, 10.3, 10.4, 11, 12, 13 |
| FreePascal / Lazarus | 3.x (via base sgcIndy) |
| Plataformas | Win32, Win64, Linux64, macOS Intel/ARM, iOS device + simulator, Android ARM/ARM64 |
O transporte WebSocket é a fundação de todo outro protocolo da biblioteca.
Contexto sobre o protocolo RFC 6455, o handshake, o framing e casos de uso.
Rode MQTT 3.1.1 / 5.0 sobre a mesma conexão WebSocket.
HTTP/2 multiplexado com server push e WebSocket-sobre-HTTP/2.
WebSocket vs SSE vs HTTP/2 push vs MQTT vs WebRTC — matriz de decisão.
Guia de padrões para broadcast a subconjuntos de conexões.
Como o ciclo de vida de reconexão automática funciona por baixo.
Ajuste de permessage-deflate para throughput vs CPU.
Cada release comercial do Delphi do Delphi 7 (2002) ao Delphi 13 (2025), além das versões correspondentes do C++Builder. Entregamos 22 pacotes de runtime separados — um por IDE — a partir de uma única árvore de código. Não há um SKU “legado” à parte; todo cliente recebe todas as versões.
Sim. Defina URL := 'wss://...' e escolha um provedor TLS: OpenSSL (multiplataforma, vem com o trial), SChannel (TLS de kernel do Windows, sem DLLs para implantar) ou HTTP.sys (lado servidor, certificado armazenado no Windows certificate store). Certificados de cliente, SNI, ALPN, TLS 1.3 e 0-RTT são todos suportados.
No Windows o servidor usa IOCP e escala rotineiramente para 50.000+ conexões concorrentes por processo em hardware comum. No Linux o reactor epoll escala de forma semelhante. O limite duro está no SO (file descriptors, faixa de portas efêmeras, memória do kernel), não na biblioteca.
Licença perpétua por desenvolvedor, royalty-free, com um ano de atualizações incluso. Licenças single-developer, team e site disponíveis — veja preços. O código-fonte está incluído em cada edição comercial.