TsgcWebSocketServer › Métodos › WriteData

WriteData Método

Envía un mensaje a un único cliente identificado por su GUID de conexión.

Sobrecargas

Sobrecarga 1

Sintaxis

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

Parámetros

Nombre	Tipo	Descripción
`aGuid`	`const string`	Identificador de la conexión de destino asignado por el servidor cuando se completó el handshake del cliente.
`aMessage`	`const string`	Payload de texto que se enviará a ese cliente como una trama de texto WebSocket.

Valor de Retorno

True cuando se ha localizado una conexión con el GUID indicado y la trama se ha entregado a su socket; False cuando no existe ninguna conexión activa coincidente. (Boolean)

Observaciones

Esta sobrecarga busca la conexión cuyo GUID coincide con aGuid y envía el mensaje de texto a ese único cliente. El GUID es el valor expuesto por TsgcWSConnection.Guid, típicamente capturado en OnConnect y almacenado por la aplicación. Cuando QueueOptions.Text se establece en un valor distinto de qmNone, el frame se pone en cola y se envía desde el hilo de conexión en lugar del hilo del llamante (no admitido cuando IOHandlerOptions.IOHandlerType = iohIOCP). Use Broadcast para llegar a todos los clientes activos en una sola llamada.

Ejemplo


oServer.WriteData('guid', 'My First sgcWebSockets Message!.');

Sobrecarga 2

Sintaxis

function WriteData(const aGuid: String; aStream: TStream; aSize: Integer = 0; const aStreaming: TwsStreaming = stmNone) : Boolean;

Parámetros

Nombre	Tipo	Descripción
`aGuid`	`const String`	Identificador de la conexión de destino asignado por el servidor cuando se completó el handshake del cliente.
`aStream`	`TStream`	Flujo de origen cuyo contenido se envía al cliente como un frame binario WebSocket. El llamador sigue siendo el propietario del flujo.
`aSize`	`Integer`	Tamaño de fragmento opcional en bytes; cuando es mayor que cero, el flujo se divide en múltiples fragmentos de este tamaño. Use 0 (el valor predeterminado) para enviar todo el flujo como un único frame.
`aStreaming`	`const TwsStreaming`	Modo de transmisión para la transmisión fragmentada (`stmNone`, `stmStart`, `stmContinue`, `stmFinish`). El valor predeterminado es `stmNone`, que envía un mensaje completo independiente.

Valor de Retorno

True si se localizó una conexión con el GUID indicado y el flujo se entregó a su socket; False si no existe ninguna conexión activa coincidente. (Boolean)

Observaciones

Esta sobrecarga apunta a un único cliente con una carga útil binaria leída desde el flujo proporcionado. El flujo se consume desde su posición actual y el servidor no asume la propiedad, por lo que el llamador debe mantenerlo activo hasta que WriteData retorne (o, cuando se encola, hasta que el envío se complete). Cuando QueueOptions.Binary se establece en un valor distinto de qmNone, la trama se encola y se despacha desde el hilo de conexión en lugar del hilo del llamador (no compatible cuando IOHandlerOptions.IOHandlerType = iohIOCP). Utilice aSize junto con aStreaming cuando envíe cargas útiles muy grandes que deban fragmentarse en múltiples tramas WebSocket.

Ejemplo


oStream := TMemoryStream.Create;
try
  oStream.LoadFromFile('payload.bin');
  oServer.WriteData('guid', oStream);
finally
  oStream.Free;
end;

Volver a Métodos