TsgcWSPServer_WebRTC › Events › OnRawMessage

OnRawMessage Gebeurtenis

Wordt geactiveerd vóór het decoderen van het signaal, zodat de server elk inkomend tekstframe kan inspecteren en verdere verwerking optioneel kan onderdrukken.

Syntaxis

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

Standaardwaarde

—

Opmerkingen

Aangeroepen voordat de JSON-envelop wordt geparseerd naar een seinbericht, dus Text is het letterlijke frame — bijvoorbeeld {"method":"sgc@webrtc","webrtc":{"type":"offer","sdp":"…"}}. Stel Handled := True in om het frame volledig te verbruiken: de component slaat zijn eigen decoder over en geen van de speciale gebeurtenissen (OnBeforeSubscription, OnSubscription…) worden geactiveerd voor dat bericht, en de SDP/ICE-relay wordt niet uitgevoerd. Laat Handled := False staan om de gebeurtenis puur te gebruiken voor logboekregistratie of vastleggen terwijl de seinlaag normaal doorgaat.

Voorbeeld

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;

Terug naar gebeurtenissen