TsgcWSPServer_WebRTCMethoden › WriteData

WriteData Methode

Sendet eine Textnutzlast an einen einzelnen verbundenen Peer, der durch seine Verbindungs-GUID identifiziert wird.

Syntax

function WriteData(aGuid, aMessage: string): Boolean;

Parameter

NameTypBeschreibung
aGuidstringGUID der Zielverbindung (der Wert von TsgcWSConnection.Guid, der in OnConnect erfasst oder zum Zeitpunkt des Handshakes an den Peer zurückgegeben wird).
aMessagestringZu liefernde Text-Payload; wird vor dem Versand in den Signalisierungs-Envelope mit einer leeren Method und einem leeren Channel eingepackt.

Rückgabewert

True, wenn eine aktive Verbindung mit dieser GUID gefunden und der Frame zur Zustellung in die Warteschlange gestellt wurde; False, wenn kein solcher Peer verbunden ist. (Boolean)

Hinweise

Low-Level-Unicast-Primitive: zielt unabhängig von Channel-Abonnements per GUID auf einen bestimmten Peer ab, was es zum richtigen Aufruf für Bestätigungen, vom Server initiierte Einladungen oder direkte administrative Nachrichten macht. Die Payload wird in eine Signalling-Hülle gepackt, sodass der JavaScript-Shim sie an den Anwendungs-Callback des Browsers zustellen kann; sie trägt selbst kein SDP-Offer/Answer oder ICE-Candidate — diese Relays werden automatisch durch den Peer-to-Peer-sgc@webrtc-Flow ausgelöst, wenn Clients verhandeln.

Beispiel


// greet the peer that just joined with a welcome payload
procedure TForm1.WebRTCConnect(Connection: TsgcWSConnection);
begin
  WebRTCSrv.WriteData(Connection.Guid, '{"type":"welcome"}');
end;

Zurück zu Methoden