TEMPS RÉEL
Notifications push depuis un serveur par WebSocket, MQTT ou SSE
Un serveur garde à jour les notifications d'un utilisateur avec des messages en direct, un objet JSON par message.
ApplyMessage applique un message au modèle : add, update, remove, read, unread ou snapshot. Les toasts, la boîte de réception et le badge suivent le modèle, si bien qu'un message du serveur s'affiche à l'écran sans autre code. ApplyMessage ne lève jamais d'exception ; il renvoie False et laisse le modèle inchangé quand un message ne le concerne pas.
{"type":"notification","op":"add","notification":{"id":"n2","title":"Build 812 passed","severity":"success","group":"ci"}}
{"type":"notification","op":"update","notification":{"id":"n2","body":"All 1,204 tests passed"}}
{"type":"notification","op":"read","ids":["n1","n2"]}
{"type":"notification","op":"remove","id":"n1"}
Les sources en direct de la passerelle sgcUICoreWS prennent les messages d'un client sgcWebSockets et les transmettent au modèle : TsgcUILiveSource_WebSocket pour un TsgcWebSocketClient, TsgcUILiveSource_MQTT pour un TsgcWSPClient_MQTT et TsgcUILiveSource_SSE pour les événements envoyés par le serveur d'un TsgcHTTP1Client. Les messages qui arrivent dans un thread de socket sont mis en file d'attente et appliqués dans le thread principal.
uses
Classes, SysUtils,
sgcWebSocket, sgcUICoreWS_Live, sgcUICoreWS_Live_WebSocket,
sgcNavigation_Notification;
function BindNotifications(aOwner: TComponent; aClient: TsgcWebSocketClient;
aModel: TsgcNotificationModel): TsgcUILiveSource_WebSocket;
var
oBinding: TsgcUILiveBinding;
begin
Result := TsgcUILiveSource_WebSocket.Create(aOwner);
Result.Client := aClient;
oBinding := Result.Bindings.Add;
oBinding.Target := aModel;
oBinding.FilterPath := 'channel';
oBinding.FilterValue := 'alerts';
oBinding.MessagePath := 'data';
end;
- La source ne se connecte, ne s'abonne et n'envoie jamais. L'URL, les identifiants, TLS et la reconnexion relèvent du client.
- La passerelle est en entrée uniquement. Quand l'utilisateur lit ou ferme une notification, gère
OnNotification et OnAction du modèle et envoie ta propre trame via le même client.
Les messages en direct et les sources en direct font partie de l'édition Registered, et les sources en direct nécessitent sgcWebSockets. Sans serveur, l'application appelle Add et Post du modèle.
Lire la rubrique d'aide Messages de notification en direct