TEMPO REAL
Notificações push de um servidor por WebSocket, MQTT ou SSE
Um servidor mantém as notificações de um usuário atualizadas com mensagens ao vivo, um objeto JSON por mensagem.
ApplyMessage aplica uma mensagem ao modelo: add, update, remove, read, unread ou snapshot. Os toasts, a caixa de entrada e o indicador acompanham o modelo, então uma mensagem do servidor aparece na tela sem nenhum outro código. ApplyMessage nunca dispara exceção; ele retorna False e deixa o modelo inalterado quando uma mensagem não é para ele.
{"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"}
As fontes ao vivo da ponte sgcUICoreWS recebem as mensagens de um cliente sgcWebSockets e as entregam ao modelo: TsgcUILiveSource_WebSocket para um TsgcWebSocketClient, TsgcUILiveSource_MQTT para um TsgcWSPClient_MQTT e TsgcUILiveSource_SSE para os server-sent events de um TsgcHTTP1Client. As mensagens que chegam em uma thread de socket são enfileiradas e aplicadas na 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;
- A fonte nunca conecta, assina nem envia. A URL, as credenciais, o TLS e a reconexão pertencem ao cliente.
- A ponte é somente de entrada. Quando o usuário lê ou descarta uma notificação, trate
OnNotification e OnAction do modelo e envie seu próprio quadro pelo mesmo cliente.
As mensagens ao vivo e as fontes ao vivo fazem parte da edição Registered, e as fontes ao vivo exigem o sgcWebSockets. Sem um servidor, o aplicativo chama Add e Post do modelo.
Leia o tópico de ajuda Notification Live Messages