TsgcWebSocketServer › 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 Client empfangen wurde. Der Parameter Text trägt die decodierte UTF-8-Zeichenkette und der Parameter Connection 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 läuft mit dem Hauptthread synchronisiert, was es sicher macht, UI-Steuerelemente zu aktualisieren; für Server mit hohem Durchsatz setzen Sie NotifyEvents auf neNoSync, um im Verbindungsthread 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 zugestellt.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;