在线状态协议

面向实时应用程序的频道式用户在线状态感知。了解谁在线,追踪加入/离开事件,打造协作体验。

TsgcWSPClient_Presence / TsgcWSPServer_Presence

频道式在线状态管理:房间成员、加入者、离开者、群组邀请,以及支持可选 Base64 载荷编码的频道范围发布/订阅。

组件类

TsgcWSPClient_Presence

协议

基于 WebSocket 传输的在线状态 + 频道发布/订阅

支持平台

Windows, macOS, Linux, iOS, Android

版本

Professional / Enterprise

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

设置 Presence.Name,订阅频道,发布消息,发出邀请,调用 GetMembers 列出成员。

uses
  sgcWebSocket, sgcWebSocket_Server, sgcWebSocket_Protocol_Presence_Server,
  sgcWebSocket_Protocol_Presence_Client, sgcWebSocket_Protocol_Presence_Message;

// --- server side --------------------------------------------
ServerPresence := TsgcWSPServer_Presence.Create(nil);
ServerPresence.Server := WSServer;

// --- client side --------------------------------------------
ClientPresence := TsgcWSPClient_Presence.Create(nil);
ClientPresence.Client := WSClient;
ClientPresence.Presence.Name := 'alice';
WSClient.Active := True;

ClientPresence.Subscribe('room-42');
ClientPresence.Publish('hello room-42', 'room-42');
ClientPresence.GetMembers;

内部功能

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

连接

已发布属性:ClientBrokerGuid

生命周期

事件:OnConnectOnDisconnectOnError

高级功能

方法:WriteData

诊断

已发布属性:Version

在线状态

属性:PresenceAcknowledgmentEncodeBase64

订阅

方法:SubscribeUnSubscribe

规范与参考资料

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

文档与示例

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

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

准备好添加在线状态感知了吗?

下载免费试用版,构建实时协作应用程序。