Skip to main content

November 2026 SDK Release and Migration Notes

Calls now connect on networks that block the usual media ports, and a person who opens the room again on another tab or device keeps one clean session. Video uses less bandwidth at the same quality, language pickers show how good each language is, and HLS players switch to a backup address on their own. No public API was removed, so upgrading is a version bump for most apps.

The versions below were checked against npm, pub.dev, Maven Central and GitHub on 21 November 2026. They cover everything released after the October notes.

SDKVersionHighlights
ReactJSmediasfu-reactjs@4.5.3Restrictive networks, leaner video, language pickers, HLS failover, phone backgrounds
Angularmediasfu-angular@2.7.1Restrictive networks, one session per person, rejoin after reload, leaner video
Vuemediasfu-vue@1.5.1Restrictive networks, one session per person, rejoin after reload, leaner video
React Nativemediasfu-reactnative@2.7.1Restrictive networks, one session per person, rejoin after restart, leaner video
Expomediasfu-reactnative-expo@2.8.1Restrictive networks, one session per person, rejoin after restart, leaner video
Shared coremediasfu-shared@1.5.1The runtime behind every feature below, for custom renderers
Fluttermediasfu_sdk: 2.5.2Restrictive networks, one session per person, connection recovery, headless fix
Androidcom.mediasfu:mediasfu-sdk-android:1.0.11Restrictive networks
Kotlin Multiplatformcom.mediasfu:mediasfu-sdk:1.0.9Unchanged this month
Swift / AppleMediaSFUAppleSDK 0.1.7Unchanged this month
Unitycom.mediasfu.unity@0.1.0-preview.3Restrictive networks

Calls connect on restrictive networks​

Some corporate, hotel and VPN networks block the ports media normally uses, so a call could connect with no audio or video. When the media server offers a relay, a connection that is still not up a few seconds after it starts now retries once through that relay, over ports those networks allow. People on those networks hear and see the room without changing anything.

If the network still blocks the call, the participant sees one clear message instead of a silent room: "Your network is blocking the call connection. Try another network (a phone hotspot works) or turn off your VPN, then rejoin."

The relay is controlled by MediaSFU's servers. There is nothing to configure in your app, and no client option to force it.

In Unity, a blocked network is reported once per media connection through ErrorOccurred with the NetworkBlocked operation, so your scene can show its own message. Unity needs com.mediasfu.mediasoup-client-unity 0.1.0-preview.2 or later.

One session per person​

When the same person joins a room again from another tab, phone or browser, the older window now shows "You joined from another tab or device." with a Use this one button, instead of a generic disconnect. It doesn't rejoin by itself, which would push the newer window out. Pressing Use this one takes the session back. ReactJS and Flutter gained this in October; Angular, Vue, React Native, Expo and the shared core have it now.

For a custom UI, mediasfu-shared exports sessionReplaced, wasSessionReplaced, clearSessionReplaced, SESSION_REPLACED_MESSAGE and SESSION_REPLACED_EVENT. On the web, the cancelable mediasfu:session-replaced window event fires first, so you can show your own dialog.

Rejoin after a reload or restart​

The create and join helpers remember the room credential for 24 hours, per room and name. A reload (Angular, Vue) or an app restart (React Native, Expo) then rejoins as the same participant instead of failing. React and Flutter added this in October.

Native apps choose where the credential is kept. React Native and Expo use AsyncStorage by default; call configureRejoinCredentialStorage to use your own store.

Leaner video at the same quality​

Camera bitrates are now sized for webcam content at each quality tier, so HD and Full HD rooms use noticeably less bandwidth and cost less, and hold up better on weak connections. MediaSFU sets camera bitrates from the room's quality tier. The short-lived videoBitrateProfile option is ignored if your app still passes it.

Language pickers that show quality​

The translation settings group listener languages by how well they work (natural voice, captions with a basic voice, or captions only) and mark speaker languages as supported or beta. People pick languages that will sound good.

HLS playback that fails over​

getHlsPlaybackCandidates(broadcast) lists a broadcast's playback addresses in order, and attachPlayback accepts fallbackSources, onSourceChange and onPlaybackError. A player that loses its address moves to the next one on its own. See Broadcast with HLS.

Backgrounds on phones​

Background blur and virtual backgrounds now follow the frame the camera really delivers, so a phone held upright publishes an upright, unstretched picture, and the edges around the person are softer. This is in the web SDKs (ReactJS, Angular, Vue) and the shared core.

Flutter fixes​

  • Headless rooms (returnUI: false) join again (2.5.1).
  • A send or receive connection that drops restarts as intended, and is reset cleanly if the restart doesn't work (2.5.2).

Upgrade checklist​

  1. Install the versions in the table above. Angular, Vue, React Native and Expo need mediasfu-shared 1.5.1 or later, which npm installs for you.
  2. Remove videoBitrateProfile from your room options if you added it.
  3. If your custom UI handles disconnects, show the "You joined from another tab or device" message and offer Use this one, or let the supplied room do it.
  4. Test a call from a network that blocks media ports, such as a strict VPN. It should connect, or show the network message.