@streaming-cdn/rtc-web 1.3.10 → 1.3.12

package/README.md

@@ -1,4 +1,4 @@
-# RTC Web SDK 1.3.9
+# RTC Web SDK 1.3.12
 
 The customer package contains compiled ESM/UMD JavaScript and TypeScript declarations. It intentionally excludes implementation source and source maps. Example source remains available under `examples/`.
 
@@ -147,6 +147,20 @@ side receives a terminal call state. Manual integrations must call
 `await media.leave(); media.destroy()` for `ended`, `cancelled`, `rejected`,
 `busy`, `failed`, and `missed`. Calling the same terminal action twice is safe.
 
+## Transports
+
+`transport: "mesh"` (the default) opens one connection per pair, which suits
+direct calls and small rooms. `transport: "sfu"` sends media once to the
+platform SFU and receives each remote participant from it, which is what a
+large room needs — media no longer grows with the participant count. The
+credential, the events and the rest of the API are identical, so an
+application switches transports without changing its UI or call flow. SDP for
+the SFU travels over `/v1/rtc/sfu/*` authenticated by the same signaling
+token; no separate credential exists. With a single uplink there is no
+per-connection tier, so `peerquality` is not emitted on this transport and
+`setQuality` applies to the uplink directly. The React Native adapter
+currently ships the mesh transport.
+
 ## Quality and codecs
 
 Use `setQuality("low" | "medium" | "high" | "audio" | "auto")` at runtime.
@@ -154,6 +168,13 @@ Use `setQuality("low" | "medium" | "high" | "audio" | "auto")` at runtime.
 available outgoing bitrate plus encoder CPU/bandwidth limits to step down
 quickly and recover conservatively. It starts at `medium`; severe latency or
 loss falls directly to `low`, while promotion requires six healthy samples.
+
+The requested quality is a ceiling, not an instruction. Calls are a peer mesh,
+so every participant has its own connection with its own link: each connection
+settles at or below the ceiling on its own evidence, and one participant on a
+poor network no longer decides what everybody else receives. A new connection
+starts one step below the ceiling and proves itself upward. Listen for
+`peerquality` (`{ participantId, quality }`) when one connection's tier moves.
 Use `setPreferredVideoCodec("vp8" | "h264" | "auto")`; compatible fallback
 codecs remain in the offer. `packetLossPct` is the loss measured since the
 previous sample. `packetLossCumulativePct` is the value since the call began.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streaming-cdn/rtc-web",
-  "version": "1.3.10",
+  "version": "1.3.12",
   "type": "module",
   "main": "dist/rtc-web.umd.js",
   "module": "dist/rtc-web.es.js",