TsgcWSPServer_WebRTC › Events › OnRawMessage

OnRawMessage イベント

シグナリングデコードの前に発生し、サーバーがすべての受信テキストフレームを検査し、オプションで以降の処理を抑制できます。

構文

property OnRawMessage: TsgcWSRawMessageEvent;
// TsgcWSRawMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string; var Handled: Boolean) of object

デフォルト値

—

解説

JSON エンベロープがシグナリングメッセージに解析される前に呼び出されます。Text は verbatim フレームです（例：{"method":"sgc@webrtc","webrtc":{"type":"offer","sdp":"…"}}）。Handled := True を設定するとフレームを完全に消費します。コンポーネントは独自のデコーダーをスキップし、そのメッセージに対して専用のイベント（OnBeforeSubscription、OnSubscription...）は発生せず、SDP/ICE リレーも実行されません。ログやキャプチャのためだけにイベントを使用してシグナリングレイヤーを通常通り進行させる場合は Handled := False のままにしてください。

使用例

procedure TForm1.WebRTCServerRawMessage(Connection: TsgcWSConnection;
  const Text: string; var Handled: Boolean);
begin
  Memo1.Lines.Add(Format('[%s] raw: %s', [Connection.Guid, Text]));
  Handled := False;
end;

イベントに戻る