TsgcWebSocketHTTPServer › Métodos › Ping
Envía un frame de ping WebSocket a todos los clientes WebSocket conectados.
procedure Ping(const aText: string = '');| Nombre | Tipo | Descripción |
|---|---|---|
aText | const string | Carga útil opcional a incluir en el frame de ping; pase una cadena vacía para enviar un ping sin carga útil. |
Ping itera la lista de conexiones activas y envía un frame de ping WebSocket a cada cliente actualizado, retornando una vez que los frames se entregan a los sockets subyacentes. Las conexiones HTTP/HTTP2 simples se omiten porque el opcode de ping WebSocket solo aplica tras un handshake exitoso. Es una forma conveniente de mantener activas las conexiones inactivas o de comprobar la disponibilidad manualmente, además del mecanismo automático HeartBeat. Cuando se configura el tiempo de espera de HeartBeat, el servidor cierra cualquier conexión que no responda dentro del intervalo; sin tiempo de espera, la llamada es de tipo "disparar y olvidar" y las respuestas pong se entregan de forma asíncrona a través de los eventos de conexión estándar. Las excepciones generadas durante la escritura se enrutan a OnException.
oServer.Ping('keepalive');