app.realtime() öffnet einen Server-Sent-Events-Stream und liefert die rohe Response. Das SDK parst die SSE-Frames nicht für dich — es gibt dir den Stream, damit du ihn in deine eigene Event-Loop einbinden kannst.
Verbindungslimits
- Jede Verbindung dauert bis zu 10 Minuten (ihre TTL). Der Server führt beim Erreichen der TTL einen transparenten internen Reconnect durch, aber der Client muss trotzdem selbst neu verbinden, sobald der Stream endet.
- Ein einzelnes Konto kann höchstens 5 gleichzeitige Verbindungen offen halten, mit einem zusätzlichen Limit pro Anwendung. Das Überschreiten eines der beiden Limits schlägt mit
code: "REALTIME_MAX_CONNECTIONS" fehl.
app.realtime() liefert die rohe Response; ihr body ist der SSE-Stream.
Der Stream sendet zwei Arten von Frames:
event: system — Nachrichten zum Verbindungslebenszyklus wie REALTIME_CONNECTING, REALTIME_TIMEOUT usw.
event: message — die JSON-Anwendungs-Payload
Konsumieren des Streams
Jeder Aufruf von app.realtime() liefert eine frische Response. Um über das serverseitige 10-Minuten-Timeout hinaus verbunden zu bleiben, stelle die Verbindung wieder her, wenn der Stream endet.