TsgcWSPServer_WebRTC › Métodos › WriteData

WriteData Method

Envia um payload de texto para um único peer conectado identificado por seu GUID de conexão.

Sintaxe

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

Parâmetros

Name	Type	Descrição
aGuid	string	GUID da conexão de destino (o valor de TsgcWSConnection.Guid capturado em OnConnect ou retornado ao peer no momento do handshake).
aMessage	string	Payload de texto a ser entregue; envolvido no envelope de sinalização com Method e Channel vazios antes de ser enviado.

Valor de retorno

True se uma conexão ativa com aquele GUID foi encontrada e o frame foi enfileirado para entrega; False quando nenhum peer desse tipo está conectado. (Boolean)

Observações

Primitiva de unicast de baixo nível: tem como alvo um peer específico por GUID, independentemente das assinaturas de canal, o que a torna a chamada certa para acknowledgments, convites iniciados pelo servidor ou mensagens administrativas diretas. O payload é envolvido em um envelope de sinalização para que o shim JavaScript possa entregá-lo ao callback da aplicação no navegador; ele próprio não carrega um SDP offer/answer ou candidato ICE — esses relays são acionados automaticamente pelo fluxo peer-to-peer sgc@webrtc quando os clientes negociam.

Exemplo

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

Voltar para Métodos