TsgcWSPServer_WebRTC › Eventos › OnRawMessage

OnRawMessage Evento

Se dispara antes de la decodificación de señalización, permitiendo al servidor inspeccionar cada frame de texto entrante y, opcionalmente, suprimir el procesamiento posterior.

Sintaxis

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

Valor Predeterminado

—

Observaciones

Se llama antes de que el envoltorio JSON se analice en un mensaje de señalización, de modo que Text es el frame literal; por ejemplo: {"method":"sgc@webrtc","webrtc":{"type":"offer","sdp":"…"}}. Establezca Handled := True para consumir el frame completamente: el componente omitirá su propio decodificador y ninguno de los eventos dedicados (OnBeforeSubscription, OnSubscription…) se activará para ese mensaje, y el relay SDP/ICE no se ejecutará. Deje Handled := False para usar el evento únicamente para registro o captura mientras permite que la capa de señalización continúe con normalidad.

Ejemplo

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;

Volver a Eventos