TsgcWebSocketHTTPServer › Ereignisse › OnMessage
Wird jedes Mal ausgelöst, wenn ein Client eine Textnachricht sendet und sie vom Server empfangen wird.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage wird ausgelöst, sobald ein vollständiger Text-Frame von einem WebSocket-Client empfangen wurde. Der Text-Parameter trägt die dekodierte UTF-8-Zeichenfolge und der Connection-Parameter identifiziert die Sender-Sitzung, sodass der Handler auf derselben Verbindung antworten oder die Nachricht an andere Clients weiterleiten kann. Standardmäßig ist NotifyEvents neAsynchronous und der Handler wird mit dem Haupt-Thread synchronisiert ausgeführt, was es sicher macht, UI-Steuerelemente zu aktualisieren; setzen Sie für Server mit hohem Durchsatz NotifyEvents auf neNoSync, um im Verbindungs-Thread zu dispatchen, und implementieren Sie Ihre eigene Synchronisierung. Wenn Options.FragmentedMessages frgOnlyFragmented ist, wird das Ereignis nicht ausgelöst und die Payload wird stattdessen über OnFragmented geliefert.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;