Pusher Channels API

从 Delphi/C++ Builder 连接到 Pusher Channels——单个类型化组件支持公共频道、presence 频道和 HMAC 签名的私有频道。

TsgcWSAPI_Pusher

适用于 Pusher Channels WebSocket 协议的 Delphi/C++ Builder 类型化客户端——订阅公共、私有和 presence 频道,并通过类型化处理程序路由事件。

组件类

TsgcWSAPI_Pusher

支持平台

Windows, macOS, Linux, iOS, Android

版本

Standard / Professional / Enterprise

放置组件,设置密钥,订阅频道

与目标为 ws.pusherapp.com 的 TsgcWebSocketClient 配对,设置 Pusher.Key(私有/presence 频道还需设置 Pusher.Secret),然后按频道调用 Subscribe。

uses
  sgcWebSocket, sgcWebSocket_API_Pusher;

var
  WSClient: TsgcWebSocketClient;
  Pusher: TsgcWSAPI_Pusher;
begin
  WSClient := TsgcWebSocketClient.Create(nil);

  Pusher := TsgcWSAPI_Pusher.Create(nil);
  Pusher.Client := WSClient;
  Pusher.Pusher.AppKey := 'your-app-key';
  Pusher.Pusher.Secret := 'your-app-secret';

  WSClient.Active := True;

  Pusher.Subscribe('public-channel');
  Pusher.Subscribe('private-orders');
  Pusher.Subscribe('presence-chat');
end;
// uses: sgcWebSocket, sgcWebSocket_API_Pusher
TsgcWebSocketClient *WSClient = new TsgcWebSocketClient(this);
TsgcWSAPI_Pusher *Pusher = new TsgcWSAPI_Pusher(this);
Pusher->Client = WSClient;
Pusher->Pusher->AppKey = "your-app-key";
Pusher->Pusher->Secret = "your-app-secret";

WSClient->Active = true;
Pusher->Subscribe("public-channel");
Pusher->Subscribe("private-orders");

内部功能

Implements the Pusher WebSocket protocol with built-in HMAC signing for private and presence channels.

公共 / 私有 / presence 频道

使用频道名称调用 Subscribe——组件自动将 public-*private-*presence-* 频道路由到正确的身份验证方案。

HMAC 签名

设置 Pusher.AppKeyPusher.Secret,以使用 HMAC-SHA256 对私有和 presence 频道的 pusher:subscribe 请求进行签名。

事件路由

绑定 Pusher.SubscribeOnPusherEventOnPusherSubscriptionSucceededOnPusherSubscriptionError,以处理每个频道的状态和有效载荷。

重连机制

Pusher 协议协商 activity_timeout;组件调度客户端 ping 并在重连时重新订阅每个活跃频道。

集群选择

根据您的 Pusher 应用设置,将底层 TsgcWebSocketClient 指向合适的集群主机(ws-eu.pusher.comws-ap1.pusher.com 等)。

客户端事件

在 presence/私有频道上,可通过 Pusher.TriggerEvent 触发客户端事件——适用于无需服务器往返的点对点信令。

规范与参考

本组件实现的 API 的权威来源。

文档与演示

直接访问组件参考文档,获取即用型演示项目,并下载试用版。

在线帮助 — API_Pusher 本组件的完整属性、方法和事件参考。
免费试用 — sgcWebSockets 下载试用包 to subscribe to Pusher Channels (Delphi 版)。
技术文档 (PDF) 本组件的功能介绍、快速入门、Delphi & C++ Builder 代码示例及主要来源参考。
用户手册 (PDF) 涵盖库中所有组件的综合手册。

准备好订阅 Pusher Channels 了吗?

下载免费试用版,将 Pusher 实时事件集成到您的 Delphi 应用程序中。