Broadcast 方法

向所有已连接的客户端发送相同的消息，可选地按通道、协议或连接 GUID 列表进行过滤。

重载

重载 1

语法

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

参数

名称	类型	描述
`aMessage`	`const string`	以 WebSocket 文本帧形式投递给每个匹配客户端的文本负载。
`aChannel`	`const string`	当非空时，消息仅发送给订阅了给定频道的客户端。
`aProtocol`	`const string`	当非空时，消息仅发送给使用给定 WebSocket 子协议的客户端。
`Exclude`	`const String`	此广播应跳过的连接 GUID 的逗号分隔列表。
`Include`	`const String`	以逗号分隔的连接 GUID 列表，将广播限制在该子集内；为空时忽略。

备注

此重载向匹配所提供过滤条件的每个活动连接发送文本帧。过滤条件以 AND 语义组合：只有同时满足所有非空过滤条件的连接才会收到消息，GUID 出现在 Exclude 中的连接则不会收到。当启用 LoadBalancer 时，调用将在集群中转发，使远程节点也向其本地客户端投递消息。调用在调用方线程上运行，并在帧交给每个套接字后返回；每个连接的写入错误通过 OnException 报告，不会中止广播。

示例


oServer.Broadcast('Hello From Server');

重载 2

语法

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

参数

名称	类型	描述
`aStream`	`TStream`	源流，其内容作为 WebSocket 二进制帧投递给每个匹配的客户端。调用方保留流的所有权。
`aChannel`	`const string`	当非空时，消息仅发送给订阅了给定频道的客户端。
`aProtocol`	`const string`	当非空时，消息仅发送给使用给定 WebSocket 子协议的客户端。
`Exclude`	`const String`	此广播应跳过的连接 GUID 的逗号分隔列表。
`Include`	`const String`	以逗号分隔的连接 GUID 列表，将广播限制在该子集内；为空时忽略。
`aSize`	`const Integer`	可选的分片大小（字节）；大于零时，每个客户端以该大小的分片接收流。使用 0（默认值）将整个流作为单个帧发送。
`aStreaming`	`const TwsStreaming`	分片传输的流模式（`stmNone`、`stmStart`、`stmContinue`、`stmFinish`）。默认为 `stmNone`，发送完整的独立消息。

备注

此重载将流内容作为二进制帧广播到通过频道、协议、Include 和 Exclude 过滤器的每个连接。流从当前位置读取；服务器不取得所有权，因此调用方必须在 Broadcast 返回之前保持流有效。当 LoadBalancer 启用时，二进制载荷将转发到其他节点，以便它们能够将其重新传递给本地客户端。结合使用 aSize 和 aStreaming 可将非常大的载荷作为多个 WebSocket 片段流式传输，而非一次性发送一个超大帧。

示例


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

返回方法