TsgcWebSocketServer › Zdarzenia › OnMessage
Wywoływane za każdym razem, gdy klient wysyła wiadomość tekstową i zostaje ona odebrana przez serwer.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
Zdarzenie OnMessage jest wywoływane po odebraniu pełnej ramki tekstowej od klienta. Parametr Text zawiera zdekodowany ciąg UTF-8, a parametr Connection identyfikuje sesję nadawcy, umożliwiając odpowiedź na tym samym połączeniu lub przekazanie wiadomości do innych klientów. Domyślnie właściwość NotifyEvents ma wartość neAsynchronous, a procedura obsługi jest synchronizowana z wątkiem głównym, co umożliwia bezpieczną aktualizację kontrolek UI; dla serwerów o wysokiej przepustowości należy ustawić NotifyEvents na neNoSync, aby obsługiwać zdarzenia w wątku połączenia z własną synchronizacją. Jeśli właściwość Options.FragmentedMessages ma wartość frgOnlyFragmented, zdarzenie nie jest wywoływane, a ładunek jest dostarczany przez zdarzenie OnFragmented.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;