文件传输协议

基于 WebSocket 的二进制传输协议,用于在已连接客户端之间传输文件,支持可配置的数据包大小、授权控制和 QoS 投递保证。

TsgcWSPClient_Files / TsgcWSPServer_Files

分块、可续传的文件传输子协议,支持可选 QoS、可配置缓冲区大小和保存目录。通过逐片段确认机制支持大文件传输。

组件类

TsgcWSPClient_Files

协议

通过 WebSocket 通道进行分块文件传输

支持平台

Windows, macOS, Linux, iOS, Android

版本

Professional / Enterprise

放置组件,配置属性,即刻运行

设置 BufferSize、SaveDirectory、QoS.Level,然后调用 Subscribe 和 SendFile。

uses
  sgcWebSocket, sgcWebSocket_Server, sgcWebSocket_Protocol_Files_Server,
  sgcWebSocket_Protocol_Files_Client, sgcWebSocket_Protocol_Files_Message;

// --- Server ----------------------------------------------------
ServerFiles := TsgcWSPServer_Files.Create(nil);
ServerFiles.Server := WSServer;

// --- Client — chunked + resumable -----------------------
ClientFiles := TsgcWSPClient_Files.Create(nil);
ClientFiles.Client := WSClient;
ClientFiles.Files.BufferSize    := 8192;
ClientFiles.Files.SaveDirectory := 'C:\\inbox\\';
ClientFiles.Files.QoS.Level     := qosLevel1;  // acknowledged delivery

ClientFiles.Subscribe('files');
ClientFiles.SendFile('C:\\data\\report.pdf');

内部功能

5 个已发布属性、4 个方法、19 个事件 — 摘自组件参考文档。

连接

已发布属性:ClientBrokerGuid

消息传递

事件:OnMessageOnBinaryOnFragmented

生命周期

事件:OnConnectOnDisconnectOnError

高级功能

方法:WriteData

诊断

已发布属性:Version

文件

属性:Files

规范与参考资料

该组件实现的协议权威来源。

文档与示例

直达组件参考文档、获取即用示例项目并下载试用版。

示例项目 — Demos\Protocols\Files 即用示例项目,包含在 sgcWebSockets 包中 — 请从下方下载试用版。
技术文档(PDF) 功能介绍、快速入门、Delphi 与 C++ Builder 代码示例及原始参考资料 — 仅限此组件。
用户手册(PDF) 涵盖库中每个组件的综合手册。

准备好通过 WebSocket 传输文件了吗?

下载免费试用版,为您的应用程序添加文件传输支持。