TsgcWSPServer_WebRTC › Eventi › OnRawMessage

OnRawMessage Event

Si attiva prima della decodifica della segnalazione, consentendo al server di ispezionare ogni frame di testo in arrivo e di sopprimerne facoltativamente l'ulteriore elaborazione.

Sintassi

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

Valore predefinito

—

Note

Chiamato prima che l'envelope JSON venga analizzato in un messaggio di segnalazione, quindi Text è il frame verbatim — ad esempio {"method":"sgc@webrtc","webrtc":{"type":"offer","sdp":"…"}}. Impostare Handled := True per consumare completamente il frame: il componente salterà il proprio decodificatore e nessuno degli eventi dedicati (OnBeforeSubscription, OnSubscription…) verrà attivato per quel messaggio, e il relay SDP/ICE non verrà eseguito. Lasciare Handled := False per utilizzare l'evento esclusivamente per la registrazione o l'acquisizione, consentendo al layer di segnalazione di procedere normalmente.

Esempio

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;

Torna agli Eventi