Skip to main content
app.realtime() 会打开一个 Server-Sent Events 流并返回原始的 Response。SDK 不会替你解析 SSE 帧,而是把流交给你,让你接入自己的事件循环。

连接限制

  • 每个连接最多持续 10 分钟(其 TTL)。达到 TTL 时服务器会执行一次透明的内部重连,但流结束后客户端仍需自行重新连接。
  • 单个账户最多可同时保持 5 个并发连接,并额外有按应用计算的上限。超过任一限制都会失败,报错代码为 REALTIME_MAX_CONNECTIONS
  • app.realtime() 返回原始的 Response;其 body 就是 SSE 流。

事件结构

该流发出两类帧:
  • event: system — 连接生命周期消息,例如 REALTIME_CONNECTINGREALTIME_TIMEOUT
  • event: message — JSON 应用负载

消费流

每次调用 app.realtime() 都会返回一个全新的 Response。若要在 10 分钟的服务器超时之后保持连接,请在流结束时重新连接。