TsgcWebSocketServerÉvénements › OnMessage

OnMessage Événement

Se déclenche chaque fois qu'un client envoie un message texte et qu'il est reçu par le serveur.

Syntaxe

property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object

Valeur par défaut

Remarques

OnMessage est déclenché une fois qu'une trame texte complète a été reçue d'un client. Le paramètre Text contient la chaîne UTF-8 décodée et le paramètre Connection identifie la session de l'expéditeur, permettant au gestionnaire de répondre sur la même connexion ou de relayer le message vers d'autres clients. Par défaut, NotifyEvents est neAsynchronous et le gestionnaire s'exécute synchronisé avec le thread principal, ce qui le rend sûr pour mettre à jour les contrôles d'interface ; pour les serveurs à haut débit, définissez NotifyEvents sur neNoSync pour la distribution dans le thread de connexion et implémentez votre propre synchronisation. Si Options.FragmentedMessages est frgOnlyFragmented, l'événement n'est pas déclenché et la charge utile est livrée via OnFragmented à la place.

Exemple


procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
  ShowMessage('Message Received from Client: ' + Text);
end;

Retour aux événements