sgcUI Realtime UI 套件

TsgcUIPresenceModel 保存用户及其状态（在线、离开、忙碌或离线）和状态文本。头像控件跟随该模型，因此状态变化会同时重绘该用户的所有头像和指示器。

• 在线状态模型的变化来自代码中的 AddOrUpdate 和 SetStatus，或来自每次变化一条的实时消息。
• 头像、用“+N”标签表示放不下的用户的头像组，以及带状态圆点和状态文本的在线状态指示器。
• sgcDashboard 的活动源读取同一个模型，因此每个参与者都显示其头像和状态。

产品

sgcUICore，由每个 sgcUI 产品共用

Delphi 和 C++Builder

TsgcVCLAvatar、TsgcVCLAvatarGroup、TsgcVCLPresenceIndicator 及其 TsgcFMX 对应控件

版本

所有版本，社区版也包含，实时在线状态消息同样如此

帮助：在线状态和头像和在线状态指示器。

TsgcDashboardActivityModel 把每条活动记录为参与者、动词和对象，并带有变化的字段。活动源和审核跟踪是同一个模型的两种视图。

• 活动源：最新活动在前，带相对时间，以及来自在线状态模型的每个参与者的头像。
• 审核跟踪：行可展开显示变化字段的表格。
• 两者既是独立控件，也是可用于仪表板的活动磁贴和审计磁贴。

产品

sgcDashboard

Delphi 和 C++Builder

TsgcVCLActivityFeed、TsgcVCLAuditTrail、TsgcVCLDashboardActivityTile、TsgcVCLDashboardAuditTile 及其 TsgcFMX 对应控件

版本

所有版本，社区版也包含。实时活动消息仅限注册版。

帮助：活动源、实时活动消息、活动磁贴和审计磁贴。

• 数据源从不连接、订阅或发送。URL、凭据、TLS 和重新连接都属于客户端，并且 WatchDog 重新连接后挂接依然有效。
• 一个数据源通过其绑定为多个模型供数，因此一个连接即可驱动整个画面。绑定可以解开应用程序的信封，您自己的客户端事件处理程序仍会触发。
• 模型始终在主线程中被调用。在套接字线程中到达的消息会排入队列，按到达顺序在一次主线程访问中应用。
• 桥接只负责入站。用户阅读或关闭通知时，应用程序通过同一个客户端发送自己的帧。

四种消息形态

这里没有新协议。每个模型读取其数据流的实时消息：每次变化一个 JSON 对象，带有指明数据流的 type 成员和一个 op 成员。

{"type":"presence","op":"upsert","user":{"id":"u7","presence":"away","statusText":"Lunch"}}
{"type":"notification","op":"add","notification":{"id":"n2","title":"Build 812 passed","severity":"success"}}
{"type":"activity","op":"add","item":{"id":"a20","actorId":"u7","verb":"updated","objectName":"Invoice INV-17"}}
{"type":"log","op":"append","entry":{"level":"warning","source":"api","message":"Slow query"}}

oSource := TsgcUILiveSource_MQTT.Create(Self);
oSource.Client := MQTT;
// 每个模型一个绑定，按其主题选择
oBinding := oSource.Bindings.Add;
oBinding.Target := PresenceModel;
oBinding.Topic := 'ops/presence';
oBinding := oSource.Bindings.Add;
oBinding.Target := NotificationModel;
oBinding.Topic := 'ops/notifications';
oBinding := oSource.Bindings.Add;
oBinding.Target := ActivityModel;
oBinding.Topic := 'ops/activity';
oBinding := oSource.Bindings.Add;
oBinding.Target := LogModel;
oBinding.Topic := 'ops/log/+';
// 数据源从不订阅：请在客户端的 OnMQTTConnect 中订阅
MQTT.Subscribe('ops/#');

实时数据源仅限注册版，并且需要 sgcWebSockets，与 sgcUI 的每个 sgcWebSockets 桥接相同。没有服务器时，或在社区版构建中，应用程序改为调用各模型的 API：在线状态模型的 AddOrUpdate 和 SetStatus，通知模型的 Add 或 Post，活动模型的 Add 以及日志模型的 Append。

阅读实时数据源帮助主题

• 模型：TsgcUIPresenceModel（命名空间 esegece.sgcUICore）、TsgcNotificationModel 和 TsgcNotificationPreferences（esegece.sgcNavigation）、TsgcToolbarBadgeLink（esegece.sgcToolbar）、TsgcDashboardActivityModel（esegece.sgcDashboard），以及 TsgcGridLogModel 和 TsgcGridLogLink（esegece.sgcGrid）。
• 控件：TsgcWinFormsAvatar、TsgcWinFormsToastManager、TsgcWinFormsNotificationInbox、TsgcWinFormsActivityFeed、TsgcWinFormsAuditTrail 以及其他控件，每个都有对应的 TsgcWpf 和 TsgcAvalonia 版本。
• 实时数据源：包 esegece.sgcUICore.sgcWebSockets 中的 TsgcUILiveSource_WebSocket、TsgcUILiveSource_MQTT 和 TsgcUILiveSource_SSE，仅限注册版。
• NuGet 上免费的社区版包，例如 esegece.sgcNavigation.Community 和 esegece.sgcGrid.Community，省略的部分与 Delphi 社区版构建相同。
• .NET 演示提供 WinForms、WPF 和 Avalonia 宿主，共用一个包含模型、模拟器和自检的项目。

帮助：.NET 包和 Realtime UI 套件。