TsgcWebSocketHTTPServer › Eventos › OnBinary

OnBinary Event

Disparado toda vez que um cliente envia uma mensagem binária e ela é recebida pelo servidor.

Sintaxe

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

Valor Padrão

—

Observações

OnBinary é gerado quando uma carga útil binária completa é recebida e armazenada em buffer de um cliente WebSocket. O parâmetro Data expõe os bytes decodificados como um TMemoryStream posicionado em 0; leia-o dentro do manipulador porque o stream é de propriedade do servidor e torna-se inválido após o manipulador retornar. Por padrão NotifyEvents é neAsynchronous, então OnBinary é sincronizado com a main thread e é seguro tocar em controles de interface; mude para neNoSync para despachar na thread de conexão quando a vazão for importante. Se Options.FragmentedMessages for frgOnlyFragmented, o evento não é gerado e OnFragmented é utilizado em seu lugar.

Exemplo

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;

Voltar para Eventos