TsgcWebSocketHTTPServer › 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 kompletnej ramki tekstowej od klienta WebSocket. Parametr Text zawiera zdekodowany ciąg UTF-8, a parametr Connection identyfikuje sesję nadawcy, dzięki czemu procedura obsługi może odpowiedzieć na tym samym połączeniu lub przekazać wiadomość do innych klientów. Domyślnie NotifyEvents ma wartość neAsynchronous, a procedura obsługi jest synchronizowana z wątkiem głównym, co umożliwia bezpieczną aktualizację kontrolek interfejsu. W przypadku serwerów o wysokiej przepustowości należy ustawić NotifyEvents na neNoSync, aby zdarzenia były wywoływane w wątku połączenia, i zaimplementować własną synchronizację. Jeżeli 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;