TsgcWSPServer_WebRTC › イベント › OnBinary

OnBinary イベント

ピアが JSON テキストのシグナリングプロトコルに含まれないバイナリ WebSocket フレームを送信したときに発生します。

構文

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

デフォルト値

—

解説

SDP オファー、SDP アンサー、ICE 候補は JSON テキストであり、バイナリフレームとして転送されることはありません。ブラウザのメディア（オーディオ/ビデオ/データチャンネル）は、アウトオブバンドでネゴシエートされた別の RTCPeerConnection ソケットで実行され、このハンドラーには到達しません。OnBinary は、同じシグナリングソケット上で転送されるアプリケーション固有のペイロード（ファイルサムネイル、エンコードされたスナップショット、カスタムテレメトリ）のエスケープハッチです。Data.Position はエントリで 0 になります。バッファはコンポーネントが所有し、ハンドラーが返ると解放されます。必要なバイトはその前にコピーしてください。

使用例

procedure TForm1.WebRTCServerBinary(Connection: TsgcWSConnection;
  const Data: TMemoryStream);
begin
  Memo1.Lines.Add(Format('[%s] binary: %d bytes',
    [Connection.Guid, Data.Size]));
end;

イベントに戻る