app.realtime() ouvre un flux Server-Sent Events et renvoie la Response brute. Le SDK ne parse pas les trames SSE pour vous — il vous remet le flux afin que vous l’intégriez dans votre propre boucle d’événements.
Limites de connexion
- Chaque connexion dure jusqu’à 10 minutes (son TTL). Le serveur effectue une reconnexion interne transparente lorsque le TTL est atteint, mais le client doit tout de même se reconnecter une fois le flux terminé.
- Un même compte peut maintenir au maximum 5 connexions simultanées ouvertes, avec une limite supplémentaire par application. Dépasser l’une ou l’autre limite échoue avec
code: "REALTIME_MAX_CONNECTIONS".
app.realtime() renvoie la Response brute ; son body est le flux SSE.
Le flux émet deux types de trames :
event: system — messages de cycle de vie de la connexion tels que REALTIME_CONNECTING, REALTIME_TIMEOUT, etc.
event: message — la charge utile JSON de l’application
Consommer le flux
Chaque appel à app.realtime() renvoie une nouvelle Response. Pour rester connecté au-delà du timeout serveur de 10 minutes, reconnectez-vous lorsque le flux se termine.