TsgcWebSocketServerMethods › Ping

Ping Method

Envoie une trame ping WebSocket à chaque client connecté.

Syntaxe

procedure Ping(const aText: string = '');

Paramètres

NomTypeDescription
aTextconst stringCharge utile optionnelle à transporter dans la trame ping ; passez une chaîne vide pour envoyer un ping sans charge utile.

Remarques

Ping parcourt la liste des connexions actives et envoie une trame ping WebSocket à chaque client, revenant une fois les trames confiées aux sockets sous-jacents. C'est un moyen pratique de maintenir les connexions inactives ou de sonder manuellement la vivacité en plus du mécanisme automatique HeartBeat. Lorsque le délai d'expiration HeartBeat est configuré, le serveur ferme toute connexion qui ne répond pas dans la fenêtre ; sans délai d'expiration, l'appel est de type « fire-and-forget » et les réponses pong sont livrées de manière asynchrone via les événements de connexion standard. Les exceptions levées lors de l'écriture sont routées vers OnException.

Exemple


oServer.Ping('keepalive');

Retour aux méthodes