TsgcWebSocketHTTPServer › Metodi › Ping
Invia un frame ping WebSocket a ogni client WebSocket connesso.
procedure Ping(const aText: string = '');| Nome | Tipo | Descrizione |
|---|---|---|
aText | const string | Payload facoltativo da inserire nel frame ping; passare una stringa vuota per inviare un ping senza payload. |
Ping itera l'elenco delle connessioni attive e invia un frame ping WebSocket a ogni client aggiornato, restituendo il controllo una volta che i frame sono stati consegnati ai socket sottostanti. Le connessioni HTTP/HTTP2 normali vengono ignorate perché il codice opcode ping WebSocket si applica solo dopo un handshake riuscito. È un modo conveniente per mantenere attive le connessioni inattive o per verificare la reattività manualmente in aggiunta al meccanismo automatico HeartBeat. Quando il timeout HeartBeat è configurato, il server chiude qualsiasi connessione che non risponde entro la finestra; senza timeout la chiamata è fire-and-forget e le risposte pong vengono consegnate in modo asincrono tramite gli eventi di connessione standard. Le eccezioni generate durante la scrittura vengono indirizzate a OnException.
oServer.Ping('keepalive');