TsgcWSPServer_sgc › Methoden › Broadcast
Zendt een tekst- of stream-payload uit naar alle verbonden clients, optioneel gefilterd op kanaal.
procedure Broadcast(aMessage: string; aChannel: string = ''; Exclude: String = ''; Include: String = '');| Naam | Type | Beschrijving |
|---|---|---|
aMessage | string | Tekstpayload verpakt in de sgc-envelop en bezorgd aan ontvangers via OnMessage. |
aChannel | string | Optioneel kanaalfilter. Indien opgegeven, ontvangen alleen clients die geabonneerd zijn op dat kanaal de payload; laat leeg om elke verbinding te bereiken. |
Exclude | String | Puntkomma-gescheiden lijst van verbindings-GUID's die de broadcast niet mogen ontvangen. |
Include | String | Puntkomma-gescheiden lijst van verbindings-GUID's waartoe de broadcast is beperkt, waarbij het kanaalfilter wordt overschreven. |
Tekst overload. Sends a method=message envelope to the selected recipients. When QoS is Level 1 or Level 2 de server stores het bericht in the in behandeling list and waits for per-verbinding acknowledgements, resending if necessary; with QoS Level 0 het bericht is transmitted once without tracking.
oProtocol.Broadcast('hello everyone');
oProtocol.Broadcast('channel update', 'news');procedure Broadcast(aStream: TStream; aChannel: string = ''; Exclude: String = ''; Include: String = ''; aSize: Integer = 0; aStreaming: TwsStreaming = stmNone);| Naam | Type | Beschrijving |
|---|---|---|
aStream | TStream | Binaire payload die ongewijzigd wordt verstuurd via de WebSocket; ontvangers ontvangen het via OnBinary. |
aChannel | string | Optioneel kanaalfilter. Indien opgegeven ontvangen alleen clients die op dat kanaal zijn geabonneerd het frame. |
Exclude | String | Door puntkomma's gescheiden lijst van verbindings-GUID's die het frame niet mogen ontvangen. |
Include | String | Puntkomma-gescheiden lijst van verbindingsGuid's waartoe het frame is beperkt. |
aSize | Integer | Chunkgrootte in bytes wanneer de payload wordt gefragmenteerd; geef 0 door om de stream als één enkel frame te verzenden. |
aStreaming | TwsStreaming | Streamingstrategie (stmNone, stmFragmented, stmCustom) die wordt gebruikt om de stream in frames op te delen. |
Binaire overload. Verzendt de stream rechtstreeks naar geselecteerde ontvangers zonder deze te verpakken in de sgc JSON-envelope, zodat clients een onbewerkt binair frame zien. In tegenstelling tot de tekstoverload gebruikt dit pad niet de QoS-wachtlijst; bezorging is best-effort op de onderliggende WebSocket-transport.
oStream := TFileStream.Create('image.png', fmOpenRead);
try
oProtocol.Broadcast(oStream, 'news');
finally
oStream.Free;
end;