TsgcWebSocketServer › 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 um payload binário completo é recebido e armazenado em buffer de um cliente. O parâmetro Data expõe os bytes decodificados como um TMemoryStream posicionado em 0; leia-o dentro do manipulador, pois o stream pertence ao servidor e torna-se inválido após o manipulador retornar. Por padrão, NotifyEvents é neAsynchronous, portanto OnBinary é sincronizado com a thread principal e é seguro manipular controles de UI; mude para neNoSync para despachar na thread da conexão quando a taxa de transferência for importante. Se Options.FragmentedMessages for frgOnlyFragmented, o evento não é gerado e OnFragmented é usado 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