TsgcWebSocketHTTPServer › Methods › Ping
Wysyła ramkę ping WebSocket do każdego połączonego klienta WebSocket.
procedure Ping(const aText: string = '');| Nazwa | Typ | Opis |
|---|---|---|
aText | const string | Opcjonalny ładunek do przekazania wewnątrz ramki ping; należy podać pusty ciąg znaków, aby wysłać ping bez ładunku. |
Ping iteruje listę aktywnych połączeń i wysyła ramkę ping WebSocket do każdego zaktualizowanego klienta, powracając po przekazaniu ramek do podstawowych gniazd. Zwykłe połączenia HTTP/HTTP2 są pomijane, ponieważ kod operacji ping WebSocket ma zastosowanie wyłącznie po pomyślnym uzgodnieniu połączenia. Jest to wygodny sposób utrzymywania przy życiu bezczynnych połączeń lub ręcznego sprawdzania ich żywotności, uzupełniający automatyczny mechanizm HeartBeat. Jeśli skonfigurowany jest limit czasu HeartBeat, serwer zamyka każde połączenie, które nie odpowie w wyznaczonym oknie. Bez limitu czasu wywołanie jest typu „wyślij i zapomnij", a odpowiedzi pong są dostarczane asynchronicznie za pośrednictwem standardowych zdarzeń połączenia. Wyjątki zgłaszane podczas zapisu są kierowane do OnException.
oServer.Ping('keepalive');