Repository navigation
CalloraVoipSdk 4.11.0
CalloraVoipSdk 4.11.0
Media over a TCP/TLS TURN relay, and a WebRTC peer that survives an ICE restart — the two limits the 4.10 line called out. A purely additive minor: no public API was removed or changed (verified against the tracked PublicApi.approved.txt baseline).
✨ Highlights
📡 TCP/TLS TURN relay (#240)
The relay data path is no longer UDP-only. Add a TURN server with IceTransport.Tcp / IceTransport.Tls and a relay candidate carries media over a persistent TCP/TLS connection to the server (RFC 8656 §12 ChannelData), as a first-class ICE candidate. Media rides the transport the winning pair selects — the model libwebrtc and pjnath use — while the UDP relay keeps its in-place whole-socket switch. TLS gives a last-resort path across firewalls that allow only outbound 443.
services.AddCalloraWebRtc()
.WithTurnServer("turn.example.com", "user", "secret",
port: 5349, transport: IceTransport.Tls); // or IceTransport.Tcp🔄 ICE restart on a connected peer (#226)
IPeerConnection.CreateIceRestartOfferAsync(...) re-gathers and re-nominates connectivity in place — the DTLS association and SRTP contexts are preserved — instead of forcing a dispose-and-rebuild. A WLAN → mobile handover no longer drops the call.
📶 Receive-side simulcast (#317)
A receive-only offerer (a conference host) can ask the peer to simulcast via WebRtcConfiguration.SimulcastRecvLayers; IPeerConnection.NegotiatedReceiveSimulcastRids reads back the negotiated set.
📦 Also in this release
- Media-flow / silence monitoring on
ICall(MediaFlowChanged,MediaSilenceNotifyAfter) — media silence no longer tears the call down. - RTP header-extension coverage — RFC 8285 two-byte header extensions and the AV1 Dependency Descriptor (
EncodedFrame.KeyFrameSource/SpatialId/TemporalId). - SIP hardening — RFC 3261 §19.1.4 URI comparison corrected across all ten worked examples; served-user gating (
ServedUserAors, §8.2.2.1). - Static-IP trunks —
SipAccount.Register,LineState.Ready,Usernameno longer required,VoipConfiguration.LocalSipPort/LocalSipTlsPort. - Video — opaque (E2EE) frame format (
WebRtcConfiguration.OpaqueVideoFrames), per-track key-frame requests.
🔧 Compatibility
- Backward-compatible. 0 public API removals, 0 signature changes, 46 additions (verified). Interface additions (
IPeerConnection,ICall) are additive per ADR-006 §2. - Targets
net8.0,net9.0,net10.0.
dotnet add package CalloraVoipSdk --version 4.11.0⚠️ Honest open edges
The TCP/TLS stream relay is unit-proven; its browser / real-server data-path validation is tracked in the interop matrix (#228), and the working path is the controlling (offerer) agent. TLS certificate validation currently uses the platform default (custom-CA config is a follow-up).
🔗 Links
📄 RELEASE_NOTES_4.11.0.md · CHANGELOG.md · ADR-073 — stream relay transport