TsgcWebSocketServer › Events › OnMessage
Wordt geactiveerd elke keer dat een client een tekstbericht verzendt en dit door de server wordt ontvangen.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object
—
OnMessage wordt gegenereerd zodra een volledig tekstframe is ontvangen van een client. De parameter Text bevat de gedecodeerde UTF-8-tekenreeks en de parameter Connection identificeert de afzendersessie, zodat de handler kan antwoorden op dezelfde verbinding of het bericht kan doorsturen naar andere clients. Standaard is NotifyEvents neAsynchronous en de handler wordt gesynchroniseerd met de hoofdthread, wat het veilig maakt om UI-besturingselementen bij te werken; voor servers met hoge doorvoer stelt u NotifyEvents in op neNoSync om te verwerken in de verbindingsthread en implementeert u uw eigen synchronisatie. Als Options.FragmentedMessages frgOnlyFragmented is, wordt de gebeurtenis niet gegenereerd en wordt de payload geleverd via OnFragmented.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;