TsgcWSPServer_WebRTC › Events › OnRawMessage

OnRawMessage 事件

在信令解码之前触发，让服务器检查每个传入文本帧，并可选择抑制后续处理。

语法

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

默认值

—

备注

在 JSON 信封被解析为信令消息之前调用，因此 Text 是逐字的帧，例如 {"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;

返回事件