TsgcTCPClient › Eventos › OnMessage
Se activa cuando los bytes sin procesar recibidos del servidor TCP pueden exponerse como texto.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
A diferencia del cliente WebSocket, TsgcTCPClient no negocia un handshake ni recibe mensajes enmarcados, por lo que OnMessage entrega los bytes sin procesar que llegaron al socket TCP convertidos a cadena. Cuando TCPEndOfFrameScanBuffer es eofScanNone, cada lectura se expone tal como llega; cuando es eofScanLatestBytes o eofScanAllBytes, el búfer se divide en el delimitador TCPEndOfFrame y se genera un evento por cada frame lógico. El parámetro Text lleva el payload decodificado en UTF-8; utilice OnBinary en su lugar si el servidor envía datos no textuales. De forma predeterminada, NotifyEvents es neAsynchronous, por lo que el manejador se ejecuta en el contexto del hilo principal y es seguro actualizar controles de interfaz de usuario directamente; cambie a neNoSync si el cliente recibe un gran volumen de datos y prefiere gestionar la sincronización usted mismo.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Received from TCP server: ' + Text);
end;