TsgcWebSocketHTTPServer › イベント › OnBinary

OnBinary イベント

クライアントがバイナリメッセージを送信してサーバーが受信するたびに発生します。

構文

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

デフォルト値

—

解説

OnBinary は、WebSocket クライアントから完全なバイナリペイロードが受信されてバッファリングされると発生します。Data パラメータは、デコードされたバイトを位置 0 にある TMemoryStream として公開します。ハンドラー内で読み取ってください。ストリームはサーバーが所有しており、ハンドラーが返った後は無効になります。デフォルトでは NotifyEvents は neAsynchronous なので、OnBinary はメインスレッドと同期され、UI コントロールを安全に操作できます。スループットが重要な場合は neNoSync に切り替えて接続スレッドでディスパッチしてください。Options.FragmentedMessages が frgOnlyFragmented の場合、このイベントは発生せず、代わりに OnFragmented が使用されます。

使用例

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;

イベントに戻る