TsgcWSPServer_WebRTCMetodi › WriteData

WriteData Method

Invia un payload di testo a un singolo peer connesso identificato dal suo GUID di connessione.

Sintassi

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

Parametri

NomeTipoDescrizione
aGuidstringGUID della connessione di destinazione (il valore di TsgcWSConnection.Guid acquisito in OnConnect o restituito al peer al momento dell'handshake).
aMessagestringPayload testuale da consegnare; racchiuso nell'involucro di segnalazione con un Method e Channel vuoti prima dell'invio.

Valore restituito

True se è stata trovata una connessione attiva con quel GUID e il frame è stato accodato per la consegna; False quando nessun peer è connesso. (Boolean)

Note

Primitiva unicast di basso livello: si rivolge a un peer specifico tramite GUID indipendentemente dalle sottoscrizioni al canale, il che la rende la chiamata giusta per acknowledgment, inviti avviati dal server o messaggi amministrativi diretti. Il payload viene racchiuso in un envelope di segnalazione in modo che lo shim JavaScript possa consegnarlo al callback dell'applicazione del browser; non trasporta di per sé un'offerta/risposta SDP o un candidato ICE — questi relay vengono attivati automaticamente dal flusso peer-to-peer sgc@webrtc quando i client negoziano.

Esempio


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

Torna ai Metodi