TsgcWebSocketServer › Méthodes › Broadcast

Broadcast Méthode

Envoie le même message à tous les clients connectés, éventuellement filtré par canal, protocole ou liste de GUID de connexion.

Surcharges

Surcharge 1

Syntaxe

procedure Broadcast(const aMessage: string; const aChannel: string = ''; const aProtocol: string = ''; const Exclude: String = ''; const Include: String = '');

Paramètres

Nom	Type	Description
`aMessage`	`const string`	Charge utile texte livrée à chaque client correspondant sous forme de trame texte WebSocket.
`aChannel`	`const string`	Lorsqu'il est non vide, le message est envoyé uniquement aux clients abonnés au canal donné.
`aProtocol`	`const string`	Lorsque non vide, le message est envoyé uniquement aux clients utilisant le sous-protocole WebSocket spécifié.
`Exclude`	`const String`	Liste séparée par des virgules des GUID de connexion qui doivent être ignorés par cette diffusion.
`Include`	`const String`	Liste de GUID de connexions séparés par des virgules limitant la diffusion à ce sous-ensemble ; ignorée si vide.

Remarques

Cette surcharge envoie une trame texte à toutes les connexions actives qui correspondent aux filtres fournis. Les filtres sont combinés avec une sémantique ET : une connexion reçoit le message uniquement lorsqu'elle satisfait tous les filtres non vides, et n'est jamais atteinte lorsque son GUID apparaît dans Exclude. Lorsque LoadBalancer est activé, l'appel est transmis à travers le cluster afin que les nœuds distants livrent également le message à leurs clients locaux. L'appel s'exécute sur le thread de l'appelant et retourne une fois que les trames ont été remises à chaque socket ; les erreurs d'écriture par connexion sont rapportées via OnException sans interrompre la diffusion.

Exemple


oServer.Broadcast('Hello From Server');

Surcharge 2

Syntaxe

procedure Broadcast(aStream: TStream; const aChannel: string = ''; const aProtocol: string = ''; const Exclude: String = ''; const Include: String = ''; const aSize: Integer = 0; const aStreaming: TwsStreaming = stmNone);

Paramètres

Nom	Type	Description
`aStream`	`TStream`	Flux source dont le contenu est délivré à chaque client correspondant sous forme de trame binaire WebSocket. L'appelant reste propriétaire du flux.
`aChannel`	`const string`	Lorsqu'il est non vide, le message est envoyé uniquement aux clients abonnés au canal donné.
`aProtocol`	`const string`	Lorsque non vide, le message est envoyé uniquement aux clients utilisant le sous-protocole WebSocket spécifié.
`Exclude`	`const String`	Liste séparée par des virgules des GUID de connexion qui doivent être ignorés par cette diffusion.
`Include`	`const String`	Liste de GUID de connexions séparés par des virgules limitant la diffusion à ce sous-ensemble ; ignorée si vide.
`aSize`	`const Integer`	Taille de fragment optionnelle en octets ; lorsqu'elle est supérieure à zéro, chaque client reçoit le flux découpé en fragments de cette taille. Utilisez 0 (valeur par défaut) pour envoyer le flux entier en une seule trame.
`aStreaming`	`const TwsStreaming`	Mode de streaming pour la transmission fragmentée (`stmNone`, `stmStart`, `stmContinue`, `stmFinish`). La valeur par défaut est `stmNone`, qui envoie un message autonome complet.

Remarques

Cette surcharge diffuse le contenu du flux comme trame binaire à chaque connexion qui passe les filtres de canal, de protocole, Include et Exclude. Le flux est lu depuis sa position courante ; le serveur n'en prend pas possession, donc l'appelant doit maintenir le flux actif jusqu'au retour de Broadcast. Lorsque LoadBalancer est activé, la charge utile binaire est transmise aux autres nœuds afin qu'ils puissent la re-livrer à leurs clients locaux. Utilisez aSize avec aStreaming pour diffuser de très grandes charges utiles sous forme de plusieurs fragments WebSocket plutôt qu'une seule trame surdimensionnée.

Exemple


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

Retour aux méthodes