TsgcWebSocketHTTPServer › Eventos › OnMessage
Se activa cada vez que un cliente envía un mensaje de texto y es recibido por el servidor.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object
—
OnMessage se activa una vez que se ha recibido un frame de texto completo de un cliente WebSocket. El parámetro Text contiene la cadena UTF-8 decodificada y el parámetro Connection identifica la sesión emisora, de modo que el controlador puede responder en la misma conexión o retransmitir el mensaje a otros clientes. De forma predeterminada, NotifyEvents es neAsynchronous y el controlador se ejecuta sincronizado con el hilo principal, lo que hace seguro actualizar controles de interfaz de usuario; para servidores de alto rendimiento, establezca NotifyEvents en neNoSync para despachar en el hilo de conexión e implemente su propia sincronización. Si Options.FragmentedMessages es frgOnlyFragmented, el evento no se activa y la carga útil se entrega a través de OnFragmented en su lugar.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;