TsgcWebSocketServer_HTTPAPI › Zdarzenia › OnBinary

OnBinary Zdarzenie

Wywoływane za każdym razem, gdy klient wyśle wiadomość binarną, a serwer ją odbierze.

Składnia

property OnBinary: TsgcWSBinaryEvent;
// TsgcWSBinaryEvent = procedure(Connection: TsgcWSConnection; const Data: TMemoryStream) of object

Wartość domyślna

—

Uwagi

Zdarzenie OnBinary jest wywoływane po odebraniu i zbuforowaniu pełnego ładunku binarnego od klienta. Parametr Data udostępnia zdekodowane bajty jako TMemoryStream ustawiony na pozycji 0; należy go odczytać wewnątrz procedury obsługi, ponieważ strumień jest własnością serwera i staje się nieważny po powrocie z procedury. Zdarzenie jest wykonywane w wątku roboczym IOCP obsługującym przychodzącą ramkę HTTP.SYS WebSocket, dlatego przed dotknięciem kontrolek interfejsu użytkownika należy przełączyć się do wątku głównego. Jeśli właściwość Options.FragmentedMessages ma wartość frgOnlyFragmented, zdarzenie nie jest wywoływane i zamiast niego używane jest zdarzenie OnFragmented.

Przykład

procedure OnBinary(Connection: TsgcWSConnection; const Data: TMemoryStream);
var
  oBitmap: TBitmap;
begin
  oBitmap := TBitmap.Create;
  try
    oBitmap.LoadFromStream(Data);
    Image1.Picture.Assign(oBitmap);
  finally
    FreeAndNil(oBitmap);
  end;
end;

Powrót do Zdarzeń