Skip to content

CalloraVoipSdk 4.11.0

Choose a tag to compare

@BechsteinDigital BechsteinDigital released this 19 Aug 12:54
· 49 commits to main since this release
316c133

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, Username no 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