docs(streams): document experimental SFU scaffold endpoints

This commit is contained in:
2026-02-08 14:20:00 +00:00
parent 1c8256bf57
commit 8eed0df577

View File

@@ -145,6 +145,11 @@ Stream realtime events:
- Client receives `stream:started` when camera accepts.
- Both devices receive `stream:ended` when session is closed.
Experimental SFU scaffolding endpoints (`MEDIA_MODE=single_server_sfu`):
- `GET /streams/:streamSessionId/sfu/session` fetch in-memory SFU session state for participant devices
- `POST /streams/:streamSessionId/sfu/publish-transport` camera creates publish transport descriptor
- `POST /streams/:streamSessionId/sfu/subscribe-transport` participant creates subscribe transport descriptor
#### Streaming Scale Tradeoffs (Current Prototype)
- The current implementation is **not production-grade at scale**.
- Video quality and reliability currently depend on direct browser-to-browser WebRTC success, with a low-fps frame relay fallback in the simulator.