TsgcWebSocketServer › Yöntemler › WriteData
Bağlantı GUID'siyle tanımlanan tek bir istemciye bir mesaj gönderir.
function WriteData(const aGuid, aMessage: string): Boolean;| Name | Type | Açıklama |
|---|---|---|
aGuid | const string | İstemci handshake'i tamamlandığında sunucu tarafından atanan hedef bağlantının tanımlayıcısı. |
aMessage | const string | O istemciye bir WebSocket metin çerçevesi olarak teslim edilecek metin yükü. |
Verilen GUID'e sahip bir bağlantı bulunduğunda ve çerçeve yuvasına teslim edildiğinde True; eşleşen etkin bağlantı olmadığında False. (Boolean)
Bu aşırı yükleme, GUID'si aGuid ile eşleşen bağlantıyı arar ve metin mesajını o tek istemciye gönderir. GUID, TsgcWSConnection.Guid tarafından sunulan değerdir; genellikle OnConnect içinde yakalanır ve uygulama tarafından saklanır. QueueOptions.Text qmNone dışında bir değere ayarlandığında çerçeve kuyruğa alınır ve çağıranın iş parçacığı yerine bağlantı iş parçacığından gönderilir (IOHandlerOptions.IOHandlerType = iohIOCP olduğunda desteklenmez). Tek bir çağrıda her etkin istemciye ulaşmak için Broadcast kullanın.
oServer.WriteData('guid', 'My First sgcWebSockets Message!.');function WriteData(const aGuid: String; aStream: TStream; aSize: Integer = 0; const aStreaming: TwsStreaming = stmNone) : Boolean;| Name | Type | Açıklama |
|---|---|---|
aGuid | const String | İstemci handshake'i tamamlandığında sunucu tarafından atanan hedef bağlantının tanımlayıcısı. |
aStream | TStream | İçeriği istemciye bir WebSocket ikili çerçevesi olarak gönderilen kaynak akışı. Çağıran, akışın sahibi olmaya devam eder. |
aSize | Integer | İsteğe bağlı bayt cinsinden parça boyutu; sıfırdan büyük olduğunda akış bu boyutta birden çok parçaya bölünür. Tüm akışı tek bir çerçeve olarak göndermek için 0 (varsayılan) kullanın. |
aStreaming | const TwsStreaming | Parçalı iletim için akış modu (stmNone, stmStart, stmContinue, stmFinish). Tam, bağımsız bir mesaj gönderen stmNone varsayılandır. |
Belirtilen GUID'e sahip bir bağlantı bulunduğunda ve akış soketine teslim edildiğinde True; eşleşen etkin bağlantı olmadığında False. (Boolean)
Bu aşırı yükleme, sağlanan stream'den okunan ikili bir yük ile tek bir istemciyi hedefler. Stream, geçerli konumundan tüketilir ve sunucu sahipliği almaz, bu nedenle çağıran, WriteData dönene kadar (veya kuyruğa alırken gönderme tamamlanana kadar) onu canlı tutmalıdır. QueueOptions.Binary qmNone dışında bir değere ayarlandığında çerçeve kuyruğa alınır ve çağıranın thread'i yerine bağlantı thread'inden gönderilir (IOHandlerOptions.IOHandlerType = iohIOCP olduğunda desteklenmez). Birden çok WebSocket çerçevesi arasında parçalanması gereken çok büyük yükler gönderirken aSize değerini aStreaming ile birlikte kullanın.
oStream := TMemoryStream.Create;
try
oStream.LoadFromFile('payload.bin');
oServer.WriteData('guid', oStream);
finally
oStream.Free;
end;