TsgcWebSocketProxyServer › Methoden › Ping

Ping Methode

Verzendt een WebSocket-pingframe naar elke verbonden client aan de browserzijde van de proxy.

Syntaxis

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

Parameters

NaamTypeBeschrijving
aTextconst stringOptionele payload in het ping-frame; geef een lege tekenreeks door om een ping zonder payload te verzenden.

Opmerkingen

Ping doorloopt de actieve WebSocket-verbindingslijst en stuurt een WebSocket-pingframe naar elke client, waarbij het keert zodra de frames aan de onderliggende sockets zijn overgedragen. De ping is uitsluitend gericht op de WebSocket-zijde van elke tunnel, omdat de gekoppelde upstream TCP-verbinding een onbewerkte bytestroom is die geen WebSocket-besturingsframes bevat. Het is een handige manier om inactieve browserverbindingen actief te houden of de levensvatbaarheid handmatig te controleren. Eventuele pong-antwoorden worden asynchroon geleverd via de standaard verbindingsgebeurtenissen, en uitzonderingen die optreden tijdens het schrijven worden doorgestuurd naar OnException.

Voorbeeld


oServer.Ping('keepalive');

Terug naar methoden