OnRawMessage Zdarzenie

Wywoływane przed dekodowaniem sygnalizacji, umożliwiając serwerowi inspekcję każdej przychodzącej ramki tekstowej oraz opcjonalne pominięcie dalszego przetwarzania.

Składnia

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

Wartość domyślna

—

Uwagi

Wywoływane przed parsowaniem koperty JSON do postaci wiadomości sygnalizacyjnej; parametr Text zawiera dosłowną ramkę — na przykład {"method":"sgc@webrtc","webrtc":{"type":"offer","sdp":"…"}}. Ustawienie Handled := True spowoduje całkowite pochłonięcie ramki: komponent pominie własny dekoder i żadne ze zdarzeń dedykowanych (OnBeforeSubscription, OnSubscription...) nie zostanie wywołane dla tej wiadomości, a przekazywanie SDP/ICE nie zostanie uruchomione. Pozostawienie Handled := False pozwala używać zdarzenia wyłącznie do rejestrowania lub przechwytywania, przy jednoczesnym normalnym działaniu warstwy sygnalizacyjnej.

Przykład


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;

Powrót do Zdarzeń