TsgcWebSocketHTTPServer › Events › OnMessage
Viene attivato ogni volta che un client invia un messaggio di testo e questo viene ricevuto dal server.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage viene sollevato quando un frame di testo completo è stato ricevuto da un client WebSocket. Il parametro Text contiene la stringa UTF-8 decodificata e il parametro Connection identifica la sessione mittente, in modo che il gestore possa rispondere sulla stessa connessione o inviare il messaggio ad altri client. Per impostazione predefinita NotifyEvents è neAsynchronous e il gestore viene eseguito sincronizzato con il thread principale, il che lo rende sicuro per aggiornare i controlli dell'interfaccia utente; per server ad alto traffico impostare NotifyEvents su neNoSync per il dispatch nel thread di connessione e implementare la propria sincronizzazione. Se Options.FragmentedMessages è frgOnlyFragmented l'evento non viene sollevato e il payload viene consegnato tramite OnFragmented.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;