TsgcWSPServer_WebRTC › Événements › OnRawMessage

OnRawMessage Événement

Se déclenche avant le décodage de signal, permettant au serveur d'inspecter chaque trame de texte entrante et d'interrompre optionnellement le traitement ultérieur.

Syntaxe

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

Valeur par défaut

—

Remarques

Appelé avant que l'enveloppe JSON ne soit analysée en un message de signalisation, donc Text est la trame verbatim — par exemple {"method":"sgc@webrtc","webrtc":{"type":"offer","sdp":"…"}}. Définissez Handled := True pour consommer entièrement la trame : le composant ignorera son propre décodeur et aucun des événements dédiés (OnBeforeSubscription, OnSubscription…) ne se déclenchera pour ce message, et le relais SDP/ICE ne s'exécutera pas. Laissez Handled := False pour utiliser l'événement uniquement à des fins de journalisation ou de capture tout en laissant la couche de signalisation se dérouler normalement.

Exemple

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;

Retour aux événements