Presence Protocol

リアルタイムアプリケーション向けのチャネルベースユーザープレゼンス認識機能です。オンラインユーザーを把握し、参加/離脱イベントを追跡し、コラボレーティブなエクスペリエンスを構築できます。

TsgcWSPClient_Presence / TsgcWSPServer_Presence

チャネルベースのプレゼンス:ルームにいるユーザー、参加・退室したユーザー、グループ招待、オプションの Base64 ペイロードエンコードを伴うチャネルスコープのパブリッシュ/サブスクライブ機能を提供します。

コンポーネントクラス

TsgcWSPClient_Presence

プロトコル

WebSocket 上のプレゼンス+チャネルパブリッシュ/サブスクライブ

プラットフォーム

Windows, macOS, Linux, iOS, Android

エディション

Professional / Enterprise

コンポーネントを配置してプロパティを設定するだけ

Presence.Name を設定し、チャネルをサブスクライブして Publish でブロードキャスト、Invite で招待、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) ライブラリ内のすべてのコンポーネントを網羅した総合マニュアルです。

プレゼンス認識を追加しますか?

体験版をダウンロードして、コラボレーティブなリアルタイムアプリケーションを構築しましょう。