NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #3581 most downloaded on pub.dev
The Official UI package for Stream Video, a service for building video calls, audio rooms, and live-streaming applications.
Latest stable
1.7.2
Last release 1 months ago
22 Oct 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
77 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
fix(llc): set CallState.endedAt from the call.ended event by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1452
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.7.1...v1.7.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
LivestreamPlayer speaker button now mutes and unmutes the stream instead of switching between speaker and earpiece.StreamLobbyView now says "N people are in the call" instead of "N more people are in the call".VideoFit.adaptive now compares the video's orientation with the widget's instead of looking at the video alone. The video fills the widget when both are landscape or both are portrait, and is letterboxed when they differ.stream_video now requires jose 0.3.5+2 or newer.RtcMediaDeviceNotifier.isAudioPlayoutPaused, audioPlayoutPausedChanges and isAudioPlayoutPauseSupported.RtcMediaDeviceNotifier.pauseAudioPlayout() and resumeAudioPlayout() now work on web.LivestreamPlayer.fullscreenVideoFit, the fit used in fullscreen mode. It defaults to VideoFit.adaptive. Pass VideoFit.cover to restore the previous always-fill behaviour.AudioConfigurationPolicy.defaultsToSpeaker, which is true for the viewer policy. AudioConfigurationPolicy.custom takes an optional defaultsToSpeaker, which otherwise follows the base policy.CallState.participantCount and anonymousParticipantCount are set from the call's session as soon as it is fetched, instead of staying 0 until the first count update. Once you join, the SFU's counts still take over.LivestreamBackstageContent and StreamLobbyView show the correct call's participant count for large calls.LivestreamPlayer fullscreen mode no longer crops a feed whose orientation differs from the player's, such as a landscape stream on a portrait phone. The feed is letterboxed instead, and still fills the player when both share an orientation.CallState.endedAt is now set when the call ends while you are joined or watching it.AudioConfigurationPolicy.viewer() now hear the stream through the loudspeaker instead of the earpiece, whatever the call type's audio settings say. Headphones and Bluetooth devices still take priority, and an output picked with Call.setAudioOutputDevice still applies.Call.resumeAudio now restores the audio output the call was using, such as the loudspeaker, instead of falling back to the earpiece.chore(repo): update the SDK size badges with each release by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1404
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.7.0...v1.7.1
unregisterDevice() incorrectly trying to delete an APN device token when registerApnDeviceToken is false.StreamLivestreamViewerService, the foreground service for calls under AudioConfigurationPolicy.viewer.StreamVideoFlutterBackground.startService takes the AndroidCallServiceKind to start a call in.AndroidCallServiceKind and AudioConfigurationPolicy.androidCallServiceKind, which pick the Android foreground service a call runs in.StreamCallService no longer requests or declares the mediaPlayback foreground service type.FOREGROUND_SERVICE_* permission is declared, so unused ones can be removed with tools:node="remove".shortService instead of failing to start.fix(llc): stop sending deprecated SendStats fields by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1420
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.6.0...v1.7.0
CallParticipantsBuilder, which builds from Call.participantsStream.Call.participantsStream, which emits the participant list at an interval that grows with the participant count.CallPreferences.participantsThrottleIntervalResolver to override that interval, or set it to null to emit every change. DefaultCallPreferences provides a default. If your app implements CallPreferences directly, add the getter to your implementation.PartialCallStateBuilder now reports partial state errors to FlutterError.onError.Call.participantsStream, which is throttled by participant count.StreamCallParticipants and StreamLivestreamHosts no longer rebuild when an update leaves the rendered participants unchanged.LivestreamContent renders participants from Call.participantsStream instead of the raw call state.LivestreamBackstageContent only rebuilds when the participant count changes.ToggleScreenShareOption and the call controls of StreamCallContent no longer rebuild on local participant changes they don't use.kotlin-parcelize with hand-written Parcelable implementations for the notification payloads. kotlin-parcelize is a Kotlin compiler plugin and does not run under built-in Kotlin: it applies without error but generates no writeToParcel, so @Parcelize classes fail to compile. Behaviour is unchanged.https://stream-io-repo.com) to the Android build repositories.Call.partialState now compares maps, sets and nested collections by their contents.CallState keeps its ownCapabilities, blockedUserIds, custom, capabilitiesByRole and callMembers instances when a call update leaves their contents unchanged.CallParticipantState.audioLevel and audioLevels now hold at their last value while a participant is silent.CallParticipantState.audioLevels and CallState.ringingMembers now return unmodifiable lists, so call .toList() before sorting or otherwise mutating them.CallState.localParticipant, otherParticipants and activeSpeakers are now computed once per participant list instead of on every read, which keeps them cheap in calls with many participants.RtcMediaDeviceNotifier now enumerates devices once per burst of device-change events, and calls made while an enumeration is running share its result instead of starting another one. The device list emitted by RtcMediaDeviceNotifier.onDeviceChange is now unmodifiable, so copy it with .toList() before sorting or otherwise mutating it.PartialCallStateBuilder re-subscribing to the call state on every rebuild with an unchanged selector, and showing the previous selector's value after it changed.PartialCallStateBuilder throwing a cast error instead of surfacing a partial state error.StreamCallParticipants not applying a changed sort or filter until the participant list changed.Call.participantsStream error reaching the zone uncaught instead of being logged.LivestreamPlayer calling Call.join again on each call status change while its automatic join was still in progress.LivestreamPlayer repainting the whole screen it is embedded in every second as the call duration updates.Call.partialState streams staying subscribed to the call state after their last listener cancelled.CallParticipantState.copyWithUpdatedAudioLevels mutating the audio level history of the previous state.Call.join being rejected with "a call with the same cid is in progress" when called again while a join was in progress. A repeated call now returns the result of the join already in flight.removeTrack on the publisher for received tracks, which failed and logged sender is null on every leave.maxBitrate of 0 when the SFU's publish option carries no bitrate, and an empty publish option dimension being used as the bitrate target instead of the 1280x720 default.chore(repo): video smoke test skill by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1316
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.5.0...v1.6.0
EncryptionManager with Call.setE2EEManager prior to joining, or by specifying encryption at call creation using StreamEncryptionSettings. Supported on Android, iOS, and macOS. For implementation details and examples, refer to the encryption guide.CallPreferences.encryptionKeyResolver, which supplies the key for calls your app does not join itself, such as those answered from a ringing notification. See the documentation for details.ActionCallIncomingFailed and IncomingCallFailureReason to notify when the system blocks showing an incoming call (e.g. due to Do Not Disturb or block list). Listen via onRingingEvent<ActionCallIncomingFailed>.AndroidPushConfiguration(telecom: TelecomPushConfiguration(...)).dart_webrtc to 1.8.2, required for WebAssembly builds.phoneCall foreground service, which Android 17's background audio hardening requires for audio played while no activity is visible.consumeIncomingCall could create multiple Call instances for the same ringing flow, causing state conflicts and UI issues.chore(repo): add update_goldens workflow by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1304
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.4.3...v1.5.0
stopTrackOnMute parameter to ToggleMicrophoneOption, passed through to Call.setMicrophoneEnabled. Set it to false to keep the audio track alive on mute — required on iOS/macOS for speaking-while-muted detection.CallState.isWebAudioPlaybackBlocked, which reports whether the browser's autoplay policy is blocking playback of remote audio. Observe it through call.state to show a "tap to enable sound" affordance the moment playback is blocked. Always false on every other platform.RtcMediaDeviceNotifier.resumeWebAudioPlayback(), which retries playback of the blocked remote audio elements. Call it from within a user gesture (e.g. a button tap) so the browser allows playback. A no-op on every other platform. Unrelated to the existing resumeAudioPlayout(), which unmutes playout paused via pauseAudioPlayout().SpeakingWhileMutedRecognition) now works on iOS, macOS and web (previously Android-only). On iOS/macOS it requires muting with stopTrackOnMute: false. Check the cookbook for details and per-platform requirements.stopTrackOnMute parameter to Call.setMicrophoneEnabled. The default (true, unchanged) stops and releases the audio track on mute; false keeps the track alive and sends silence instead. See the documentation for the trade-offs.RtcRemoteTrack.setSinkId is now asynchronous (Future<RtcRemoteTrack> instead of RtcRemoteTrack) and throws when the browser cannot route the track to the requested device.RtcRemoteTrack.stop takes an optional disposeWebAudioPlayer flag (defaults to true, no effect on native). Pass false when the track may resume on the same transceiver, to keep its <audio> element and the selected output device.autoplay attribute and failing with no indication.Call.setAudioOutputDevice reporting success when the browser rejected the device or did not support output selection at all.Call.setAudioOutputDevice leaving playback split across two output devices when one remote track rejected the switch. The switch is now attempted for every remote audio track, the tracks that accept it are updated, and the selection is only rejected when every track rejected the device.RtcRemoteTrack.copyWith dropping the transceiver, so a remote track lost it as soon as a copy was made — which on web happens every time an audio output device is applied to the track.Call.setAudioBitrateProfile unmuting already-muted participants. Muted tracks now stay muted and update constraints on next unmute.Call.suspendAudio() resume unintentionally unmuting users who muted while audio was suspended. Resume now preserves mute state.Nothing published for this version
ci(repo): add automated pub.dev publishing pipeline by @xsahil03x in https://github.com/GetStream/stream-video-flutter/pull/1294
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.4.2...v1.4.3
(trackType, publishOptionId) before creating the sender, so a concurrent one reuses that sender instead of adding a second, and a repeated enable joins the media acquisition already in flight rather than opening the camera twice.mid after a renegotiation or publish retry. It's now resolved from the current peer-connection state so the SFU can reliably match the track to its media.FormatException when sending requests if the application name (or other device/app info) contains non-ASCII characters. Values included in the X-Stream-Client header are now sanitized to valid header characters.feat(samples): Update chat sdk in dogfooding by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1253
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.4.1...v1.4.2
Full Changelog: v1.4.1...v1.4.2
VideoFit.adaptive, which picks between cover and contain based on the video's own orientation: landscape/square video fills the tile while portrait/tall video is letterboxed so the whole frame stays visible.Call.state.audioOutputDevice now stays in sync with the active native audio route when the output changes outside of Call.setAudioOutputDevice (e.g. via the native route-selection UI, or when the system re-routes on device connect/disconnect).ClientEventReporter).VideoFit.adaptive on web and desktop (so portrait feeds such as phone cameras are shown in full instead of being cropped) and VideoFit.cover on mobile. Set videoFit explicitly on StreamCallParticipantThemeData (or the renderer widgets) to override.chore(deps): bump the all-actions group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/GetStream/stream-video-flutter/pul
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.4.0...v1.4.1
Full Changelog: v1.4.0...v1.4.1
X-Stream-Client header and SFU ClientDetails being sent with stale or incomplete device/app info.TransparentActivity is recreated with a null intent action (e.g. after process death or restore from recents) (#1256).TransparentActivity when the activity is recreated with a null intent action (e.g. after process death or restore from recents) (#1256).fix(llc): deprecate precacheGenericSdps instead of removing it by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1242
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.3.3...v1.4.0
Full Changelog: v1.3.3...v1.4.0
Each call now owns an isolated native PeerConnectionFactory. This fixes cross-call audio interference, sibling-call microphone capture loss, and noise cancellation failing to engage during lobby preview.
Call.ensureNativeFactory(), which returns the per-call native NativePeerConnectionFactory. Use it to pin pre-join media (e.g. lobby-preview tracks created via RtcLocalTrack.camera(nativeFactory: …)) to the same factory the call uses after joining.audioConfigurationPolicy override on DefaultCallPreferences. It falls back to StreamVideoOptions.audioConfigurationPolicy when null.degradationPreference for video quality, falling back to maintain-framerate when it is unspecified.new state).dropIfAloneInRingingFlow (the remote party hung up first). Call.end() and Call.leave() now share a single _disconnect cleanup path.Call._clear multi-call aware. The audio processor is owned by StreamVideo rather than by an individual Call, so disabling it during one call's teardown silently dropped noise cancellation on any other still-active call. _clear now stops the global processor only when no other active call is configured to use NoiseCancellationSettingsMode.autoOn.double.AudioDeviceModule. Previously, all calls shared the global ambient factory. This per-call isolation is what enables clean multi-call audio. Integrators building tracks directly should pass nativeFactory: await call.ensureNativeFactory() to the RtcLocalTrack.* constructors.feat(llc): high scale livestream publisher hint added by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1219
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.3.2...v1.3.3
Full Changelog: v1.3.2...v1.3.3
TranscriptionSettingsResponse.fromJson crashing with a null check error when the backend returns an empty string for the language field.isPinned: true on a ParticipantJoined event, the participant is now automatically pinned.hintHighScaleLivestreamPublisher parameter to Call.join() to allow marking the participant as publishing to a large audience.chore(llc): openAPI models regen by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1209
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.3.1...v1.3.2
Full Changelog: v1.3.1...v1.3.2
consumeAndAcceptActiveCall auto-accepting incoming calls on Android when the user opens the app without pressing the Accept button on the notification. The method now only consumes calls that the user explicitly accepted.CallDiagnosticsContent throwing failed to call super.dispose when the widget was disposed while awaiting stats subscription cancellation.StreamHlsSettings.qualityTracks (List<String>) is deprecated — use StreamHlsSettings.qualities (List<StreamVideoQuality>) instead.PartialCallStateBuilder for reactive state updates instead of one-shot call.state.value reads.fix(llc): fixed ringing race conditions by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1185
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.3.0...v1.3.1
Full Changelog: v1.3.0...v1.3.1
Call.join when another connect is already in progress, with proper timeout handling.consumeAndAcceptActiveCall to ensure the coordinator WS is connected before consuming incoming calls during cold start.feat(llc): hifi stereo playout (Android and iOS) by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1173
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.2.4...v1.3.0
Full Changelog: v1.2.4...v1.3.0
VideoModerationConfig in CallPreferences. Check cookbook for more details.SfuAudioBitrateProfile to select an audio quality profile before joining a call:
SfuAudioBitrateProfile.voiceStandard – Standard voice (64 kbps, default)SfuAudioBitrateProfile.voiceHighQuality – High-quality voice (128 kbps)SfuAudioBitrateProfile.musicHighQuality – HiFi music mode (128 kbps, audio processing disabled)audioConfigurationPolicy in StreamVideoOptions. Includes predefined policies:
AudioConfigurationPolicy.broadcaster() – Mono playout with voice processing enabled (default)AudioConfigurationPolicy.viewer() – Stereo playout with voice processing disabled, ideal for passive listenersAudioConfigurationPolicy.hiFi() – Stereo capture and playout with voice processing disabled, ideal for hosts streaming high-fidelity audioAudioConfigurationPolicy.custom() – Full control over platform-specific audio settings with optional basePolicy fallbackRtcMediaDeviceNotifier.reinitializeAudioConfiguration() to switch audio configuration policy at runtime (must be called before starting a call).See the documentation for details.
androidAudioConfiguration in StreamVideoOptions. Use audioConfigurationPolicy instead.iceRestart event — the client now correctly performs ICE restart and renegotiation when instructed by the SFU, improving fast reconnect reliability.dropIfAloneInRingingFlow is set to true in CallPreferences the call will now end when the last participant leaves the call.fix(llc): fix call connection issues on web by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1171
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.2.3...v1.2.4
chore(repo): fixes required for pana by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1152
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.2.2...v1.2.3
Full Changelog: v1.2.2...v1.2.3
call.leave() performanceincludesCallsInRecents to iOS push configuration to control whether CallKit calls appear in Recents.reconnectReason to reconnect details for sfu logs.fix(ui): ensure proper cleanup when app terminated by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1143
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.2.1...v1.2.2
fix(ui): extract callkit manager to make it independent of flutter initialization by @Brazol in https://github.com/GetStream/stream-video-flutter/pull
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.2.0...v1.2.1
startScreenSharingNotificationService now returns a boolean indicating success/failure, preventing screen share attempts when the service fails to start.fix(ui): Adding foregroundServiceType camera by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1131
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.1.0...v1.2.0
captureScreenAudio to true in ScreenShareConstraints. See documentation for more details.chore(llc): improved join call time by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1126
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.0.2...v1.1.0
pipTrackPriority parameter to PictureInPictureConfiguration to control whether screen sharing or camera track is preferred in PiP mode. When set to camera, the camera track is preferred, but screen share will still be shown as a fallback if the camera is disabled.LivestreamPlayer and LivestreamContent.
showMultipleHosts, layoutMode, screenShareMode.livestreamHostsParticipantBuilder and livestreamHostsParticipantsFilter to customize how hosts are selected and rendered.videoFit parameter in LivestreamPlayer to control contain/cover behavior when not in fullscreen.LivestreamPlayer/LivestreamContent: added livestreamFastReconnectingOverlayBuilder to customize the UI shown during fast reconnect.LivestreamContent: livestreamNotConnectedBuilder provides isMigrating/isReconnecting flags to tailor messaging when not connected.StreamCallContent: added callFastReconnectingOverlayBuilder to render a custom overlay while fast reconnecting.StreamCallContent: callNotConnectedBuilder now exposes CallNotConnectedProperties with isMigrating/isReconnecting to customize the not-connected/reconnecting view.call.join() performance - reduced join time by optimizing WebRTC setup and deferring non-critical operations.fix(llc): handle incoming call timeout by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1121
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.0.1...v1.0.2
🐞 Fixed
streamVideo.observeCoreRingingEventsForBackground() instead of streamVideo.observeCallDeclinedRingingEvent() in firebaseMessagingBackgroundHandler to support all necessary events.feat(ui): livestream player improvements by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1118
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v1.0.0...v1.0.1
call.setCameraTargetResolution() method.pictureInPictureConfiguration parameter. For platform-specific setup, refer to the documentation.joinBehaviour parameter, allowing control over whether and when the LivestreamPlayer automatically connects the user to a call.showRecordingsWhenEnded parameter to LivestreamPlayer, which enables you to show or hide the recordings list in the default livestream ended UI.LivestreamPlayer to leverage call.partialState for more efficient state management. New builder methods have been introduced to accommodate this change, and some previous builder methods are now deprecated.chore(repo): remove deprecated members by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1107
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.11.2...v1.0.0
This release removes the dependency on flutter_callkit_incoming, resulting in several breaking changes to CallKit and ringing functionality:
pushParams parameter in StreamVideoPushNotificationManager with the new pushConfiguration field (StreamVideoPushConfiguration).nameCaller parameter has been standardized and renamed to callerName across all relevant locations.callerCustomizationCallback and backgroundVoipCallHandler have been fully removed from StreamVideoPushNotificationManager.appName field in pushParams has been removed as it was deprecated. On iOS, the app’s product name from build settings is now used instead.onCallKitEvent is now onRingingEventobserveCoreCallKitEvents is now observeCoreRingingEventsobserveCallAcceptCallKitEvent is now observeCallAcceptRingingEventobserveCallDeclinedCallKitEvent is now observeCallDeclinedRingingEventobserveCallEndedCallKitEvent is now observeCallEndedRingingEventCallKitEvent type is now RingingEventstream_video_filters. To use video filters, add the package to your pubspec.yaml and update your relevant imports.StreamVideo.muteVideoWhenInBackground → StreamVideo.options.muteVideoWhenInBackgroundStreamVideo.muteAudioWhenInBackground → StreamVideo.options.muteAudioWhenInBackgroundStreamCallType() constructor → StreamCallType.defaultType()Call.setParticipantPinned() → Call.setParticipantPinnedLocally() (local-only pin)startRtmpBroadcasts parameter from Call.goLive()localParticipant parameter from AddReactionOption constructorandroidAudioAttributesUsageType and androidAudioAttributesContentType parameters in RtcMediaDeviceNotifier.handleCallInterruptionCallbacks()[!IMPORTANT]
Flutter's iOS SPM is experimental and disabled by default. You can enable it viaflutter config --enable-swift-package-manager. Flutter will fall back to CocoaPods for plugins that don't support SPM. See the Flutter SPM docs.
Call.ring() to ring specific members of an existing call. Example: call.ring(userIds: ['<userId>'], video: true). Sends a ringing/VoIP push to the users’ devices. Users must already be members - use call.addMembers() first if needed.RtcMediaDeviceNotifier.pauseAudioPlayout() / RtcMediaDeviceNotifier.resumeAudioPlayout() to mute and restore remote playback with platform-specific handling for iOS/macOS and Android.RtcMediaDeviceNotifier.handleCallInterruptionCallbacks().RtcMediaDeviceNotifier.regainAndroidAudioFocus() to request audio focus when it was lost without automatic regain.chore(ci): configure Dependabot and update PR title validation by @xsahil03x in https://github.com/GetStream/stream-video-flutter/pull/1080
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.11.1...v0.11.2
🐞 Fixed
CallConnectOptions as well as switching those devices during the call.callMembers collection wasn't reflecting the actual members list after starting the call session.✅ Added
checkIfAudioOutputChangeSupported() to the Call class to check whether the browser supports changing the audio output device.fix(llc): Improved participant sorting based on source type by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1073
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.11.0...v0.11.1
🔄 Changed
byParticipantSource participant sorting now accepts a list of sources. The default sorting for speaker and livestream presets now include other ingress sources.fix(llc): fix leave call throwing exception by @xsahil03x in https://github.com/GetStream/stream-video-flutter/pull/1065
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.10.4...v0.11.0
🚧 Build breaking changes
Important: This release includes breaking changes for Android development.
Android Requirements:
- Minimum compileSDK 36
- Android Gradle Plugin >=8.12.1
- Gradle wrapper >=8.13
- Kotlin 2.2.0
🚧 Breaking changes
Call.stats payload structure changed
({ CallStats publisherStats, CallStats subscriberStats })({ PeerConnectionStatsBundle publisherStatsBundle, PeerConnectionStatsBundle subscriberStatsBundle })Stats-related fields removed from CallState
publisherStats, subscriberStats, latencyHistory
call.stats streamcall.statsReporter?.currentMetricsDependency updates
✅ Added
call.statsReporter property provides access to currentMetricscall.statsReporter?.currentMetrics🔄 Changed
Call.stats record field names and types updated as noted in breaking changes section🐞 Fixed
fix(llc): fix for multitasking camera enabling on iOS by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1061
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.10.3...v0.10.4
✅ Added
CallParticipantState with participantSource. This indicates the participant's source channel (e.g., WebRTC, RTMP, WHIP) and can be used in filtering and sorting criteria.SfuClientCapability.subscriberVideoPause (on by default). Control via Call.enableClientCapabilities() / Call.disableClientCapabilities().SfuInboundStateNotificationEvent notifies when inbound tracks are paused or resumed.CallParticipantState.pausedTracks and CallParticipantState.isTrackPaused() let you check which tracks are currently paused.call.kickUser(). Requires the kick-user permission.🐞 Fixed
feat(llc): option to set android audio configuration to WebRTC by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1046
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.10.2...v0.10.3
🐞 Fixed
✅ Added
StreamVideo instance by providing androidAudioConfiguration to StreamVideoOptions.feat(llc): configuration for reconnect timeouts by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/1031
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.10.1...v0.10.2
✅ Added
reconnectTimeout option in CallPreferences, allowing you to set the maximum duration the SDK will attempt to reconnect to a call before giving up.🔄 Changed
callRejoinTimeout in RetryConfig, instead added networkAvailabilityTimeout to CallPreferences to control how long the SDK waits for network connectivity to be restored during reconnection attempts before timing out.🔄 Dependency updates
flutter_callkit_incoming dependency to version 2.5.7. That version contains Android 14 compatibility fixes for ringing notifications and lock screen handling.🐞 Fixed
DtlsSrtpKeyAgreement audio constraint parameter mappingfix(llc): Reset reaction timer on new reaction by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/1018
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.10.0...v0.10.1
🐞 Fixed
✅ Added
display_name custom data to the call. See the documentation for details.fix(ui): Remove some deprecations for useful parameters by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/998
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.6...v0.10.0
🚧 (Android) Picture-in-Picture (PiP) Improvements - Breaking Change
StreamFlutterActivity - extend it instead of FlutterActivity for automatic PiP support.MainActivity, remove the manual onUserLeaveHint() implementation and extend the MainActivity with StreamFlutterActivity. Previously required manually calling PictureInPictureHelper.enterPictureInPictureIfInCall(this) - now handled automatically.setPictureInPictureEnabled method from StreamVideoFlutterPlatform, StreamVideoFlutterBackground, and MethodChannelStreamVideoFlutter classes, and the deprecated enterPictureInPictureIfInCall method from PictureInPictureHelper (Android). PiP is now handled automatically by StreamPictureInPictureAndroidView.🔄 Partial State Updates:
For a more detailed explanation check the dedicated documentation.
call.partialState for more specific and efficient state updates.StreamCallContainer, StreamCallContent, StreamIncomingCallContent, and others that no longer return a state.
By (only) using these callbacks the root widgets will use more efficient partial state updates.PartialCallStateBuilder to help with making widgets that depend on partialState.✅ Added
setMirrorVideo method to Call class to control video mirroring for participants.maxParticipantsExcludeOwner and maxParticipantsExcludeRoles to Call limits settings, providing finer control over participant limits by allowing exclusion of call owners and specific roles from the maximum count.🐞 Fixed
chore(repo): workflow updates by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/978
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.5...v0.9.6
✅ Added
handleCallInterruptionCallbacks method to RtcMediaDeviceNotifier that provides an option to handle system audio interruption like incoming calls, or other media playing. See the documentation for details.sort in PictureInPictureConfiguration that enables customization of PiP participant selection.🐞 Fixed
chore: improve app distribution for dev and prod by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/969
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.4...v0.9.5
✅ Added
extendBody parameter in StreamCallContent that extends the participants view to the bottom edge of the scaffold when enabled.allowMultipleActiveCalls option in StreamVideoOptions enabling support for concurrent active calls. See the documentation for details.🐞 Fixed
chore: fix warnings after SharePlus upgrade by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/966
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.3...v0.9.4
🐞 Fixed
ScreenShareCallParticipantsContent with Spotlight view on very wide windows.✅ Added
LivestreamPlayer for enhanced customization:
videoRendererBuilder: Build a custom video renderer.videoPlaceholderBuilder: Build a placeholder for the video renderer.livestreamHostsUnavailableBuilder: Customize the UI when a livestream is connected but no hosts have video enabled.livestreamNotConnectedBuilder: Customize the UI when the livestream is not connected.feat: stats-v2 by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/944
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.2...v0.9.3
✅ Added
callDurationStream to the Call class. A Stream<Duration> that emits the current call duration.createdByUser property to the CallState for better tracking of the initiating user.livestreamControlsBuilder parameter to LivestreamPlayer allowing customisation of controls panel.🐞 Fixed
chore: cleanup logging by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/933
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.1...v0.9.2
🐞 Fixed
✅ Added
ring, audio, video, screenshare, session and frameRecordings settings to Call.getOrCreate() method.members list parameter to Call.getOrCreate() method to allow assigning roles when creating a call.session and frameRecordings settings to Call.update() method.🔄 Updated
LivestreamPlayer widget with a refreshed look and feel. Added livestreamEndedBuilder and livestreamBackstageBuilder for enhanced configuration options.chore: bump flutter callkit incoming by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/926
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.9.0...v0.9.1
✅ Added
Call.setZoom() method to adjust the camera’s zoom level.Call.focus() method for setting focus and exposure points on the camera.🐞 Fixed
feat: Noise cancellation feature by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/873
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.8.4...v0.9.0
✅ Added
networkMonitorSettings to StreamVideoOptions for configuring network monitoring, including customization of test URLs for connection checks.🚧 (Breaking Changes)
onCallDisconnected callback in StreamCallContainer to include a CallDisconnectedProperties parameter with detailed disconnection reason information.setScreenShareEnabled method in CallSession class to return the screen sharing track.callPreferences property from CallStateNotifier to CallState for better state management.🐞 Fixed
CallPreferences could be ignored when accepting a ringing call.battery_plus plugin on older Android devices.chore: bump webrtc to 0.12.12 by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/889
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.8.3...v0.8.4
🐞 Fixed
🔄 Changed
device_info_plus dependency to support a wider range of versions and resolve potential conflicts.setParticipantPinned() method in the Call class — use setParticipantPinnedLocally() instead.isPinned parameter in CallParticipantState with a pin object, which now differentiates between local and remote pinning.✅ Added
membersLimit parameter in the getOrCreate() and join() methods of the Call class to limit the number of members included in the response.setParticipantPinnedForEveryone(), allowing users with the required permissions to pin participants for all. The setParticipantPinned() method has been replaced with setParticipantPinnedLocally(), which, as before, only pins participants locally.🔄 Changed
fix: don't handle deeplink on login by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/881
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.8.2...v0.8.3
✅ Added
CallParticipantState.audioLevels, which stores the last 10 audio levels of a participant.CallState.activeSpeakers to retrieve a list of currently active speakers.observeCoreCallKitEvents() in StreamVideo with a new CallPreferences? preferences parameter, allowing for configuration of the accepted call.🐞 Fixed
chore: bump thermal package to support Android <=9 by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/876
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.8.1...v0.8.2
✅ Added
CallPreferences? preferences parameter to consumeIncomingCall() method in StreamVideo to make it possible to configure the consumed call.🐞 Fixed
thermal package throwing exception on Android 9 and lower.chore: Add formatting check in CI workflow by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/861
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.8.0...v0.8.1
✅ Added
onCallDisconnected callback in StreamCallContainer, enabling customization of the default behavior, which invokes Navigator.pop upon call disconnection.registerDevice() and unregisterDevice() methods publicly available in PushNotificationManager.chore(dogfooding) Update macOS project files by @renefloor in https://github.com/GetStream/stream-video-flutter/pull/845
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.7.2...v0.8.0
flutterfire_cli for push notifications you might need to reactivate it by running: dart pub global activate flutterfire_cli.✅ Added
disposeAfterResolvingRinging() and consumeAndAcceptActiveCall() methods in StreamVideo to simplify the ringing flow implementation.
🔄 Changed
backgroundVoipCallHandler parameter in StreamVideoPushNotificationManager, as it is no longer required for iOS ringing to function in a terminated state.🐞 Fixed
StreamLobbyVideo to support more screen sizes.stream_webrtc_flutter package.🚧 (Breaking) Picture-in-Picture (PiP) Improvements & Fixes
disablePictureInPictureWhenScreenSharing configuration option to PictureInPictureConfiguration. When true (default), PiP is disabled if the local device is screen sharing.ignoreLocalParticipantVideo parameter in IOSPictureInPictureConfiguration is replaced by includeLocalParticipantVideo. By default, local video is enabled and will appear in PiP mode if the iOS device supports Multitasking Camera Access.ignoreLocalParticipantVideo parameter in StreamPictureInPictureUiKitView is also replaced by includeLocalParticipantVideo.chore(dogfooding): fix for iOS Distribution workflow by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/826
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.7.1...v0.7.2
🐞 Fixed
battery_plus and thermal packages were erroneously called on web. #837🔄 Changed
handleVoipPushNotification() method in the StreamVideo class. Use handleRingingFlowNotifications() instead.fix(llc): fix for anonymous user joining the call by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/827
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.7.0...v0.7.1
chore: added workflow_dispatch trigger to Distrubute dogfooding app CI by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/821
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.6.1...v0.7.0
🚧 Breaking changes
flutter_callkit_incoming package to version 2.5.0, which also requires Java 17. #820resolution parameter of Call.setPreferredIncomingVideoResolution() method changed type from VideoResolution to VideoDimension.Call.onPermissionRequest callback changed the event type passed as an argument from CoordinatorCallPermissionRequestEvent to StreamCallPermissionRequestEvent✅ Added
Call.closedCaptions stream to overlay captions during your call.CallPreferences to configure:
closedCaptionsVisibilityDurationMs for controlling how long captions are displayed.closedCaptionsVisibleCaptions for managing the number of captions in the display queue.ToggleClosedCaptionsOption widget.🐞 Fixed
feat: call quality rating by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/793
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.6.0...v0.6.1
✅ Added
call.collectUserFeedback() method which allows users to send call quality rating. These ratings are visible on the Dashboard and are aggregated in call stats for easy tracking. For a sample implementation, please refer to the documentation.StreamVideoPushNotificationManager.ensureFullScreenIntentPermission() method. This resolves an issue on some Android 14 devices where full-screen notifications would not appear due to missing permissions.
You can now invoke this method to show a settings screen, allowing users to enable the required permission if it's not already enabled.🐞 Fixed
fix(dogfooding): dogfooding uni_links dependency changed to app_links by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/773
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.5.5...v0.6.0
This release introduces a major rework of the join/reconnect flow in the Call class to support Reconnect V2, enhancing reconnection handling across various scenarios. Most updates are within the internals of the Call class, though some changes are outward-facing, including a few breaking changes.
🔄 Changed
Call.reject() method will now always call Call.leave() method internally.🚧 Breaking changes
Call.joinLobby() method.maxDuration and maxParticipants parameters of Call.getOrCreate() are now combined into the StreamLimitsSettings? limits parameter.🔄 Dependency updates
✅ Added
registerPushDevice optional parameter (default is true) to the StreamVideo.connect() method,allowing the prevention of automatic push token registration.participantCount and anonymousParticipantCount to CallState reflecting the current number of participants in the call.watch parameter to Call.get() and Call.getOrCreate() methods (default is true). When set to true, this enables the Call to listen for coordinator events and update its state accordingly, even before the call is joined (Call.join()).targetResolution setting set on the Dashboard to determine the max resolution the video stream.Call.setPreferredIncomingVideoResolution() allows you to manually set a preferred video resolution, while Call.setIncomingVideoEnabled() enables or disables incoming video. For more details, refer to the documentation.🐞 Fixed
StreamVideo now stores registered token in SharedPreferences, performing an API call only when the token changes.dropIfAloneInRingingFlow is set to true.fix: migrating to internet connection checker plus by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/771
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.5.4...v0.5.5
🐞 Fixed
internet_connection_checker to internet_connection_checker_plus due to license issues.callAppBarBuilder in StreamCallContent can now return null in order to hide the app bar.backgroundColor field in StreamCallControls is now correctly applied.chore: remove the deprecated flutter_background package by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/763
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.5.3...v0.5.4
🐞 Fixed
🚧 Breaking changes
The regular push notification handling has been removed from iOS, providing more control over the implementation. VoIP push notifications will continue to be handled as before. For more details, refer to the documentation.
Dependency updates
docs: docs rewrite by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/753
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.5.2...v0.5.3
🐞 Fixed
chore(llc): Regenerated open-api models by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/740
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.5.1...v0.5.2
🐞 Fixed
onLeaveCallTap callback in StreamCallContent. It's now correctly handled.🔄 Changed
SortParam changed to SortParamRequest in queryMembers() method inside Call and StreamVideo classfix: dismissing reactions after 5s by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/730
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.5.0...v0.5.1
✅ Added
backstage parameter to call.getOtCreate() method with backstage settings. For more information, refer to the documentation
joinAheadTimeSeconds parameter (part of StreamBackstageSettings)startsAt parameter to call.getOtCreate() methodmaxDuration and maxParticipants parameters to call.getOtCreate() methodvideo parameter to call.getOtCreate(), call.getCall() and call.join() methods. This parameter is used to distinguish between audio-only and video calls for ringing purposes.
video parameter is false by default. If you want your call to be treated as a video call while ringing set it to true.streamVideo paramter to StreamLobbyView and StreamLobbyVideo widgets provide a custom StreamVideo instance.🐞 Fixed
CallPreferences).chore(llc): removed previously deprecated paramteres by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/726
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.4.4...v0.5.0
✅ Added
🐞 Fixed
🚧 Breaking changes
BroadcastSampleHandler, used for broadcast screen-sharing mode on iOS is now moved from stream_video_flutter package to a separate stream_video_screen_sharing package.
Migration steps:stream_video_screen_sharing dependency to your pubspec.yaml fileSampleHandler.swift file from stream_video_flutter to stream_video_screen_sharingPodfile file from stream_video_flutter to stream_video_screen_sharingFor complete screen-sharing guide please refer to the documentaiton
String type parameters in makeCall() and getCallRingingState() methods are now removed. Use StreamCallType callType parameter now.events and coordinatorEvents streams are now removed from Call class. Use callEvents instead.Small fixes to the docs by @martinmitrevski in https://github.com/GetStream/stream-video-flutter/pull/719
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.4.3...v0.4.4
✅ Added
watch parameter to StreamVideo.queryCalls() method, allowing you to subscribe to queried call events. For more information, refer to the documentation.listRecordings() to StreamVideo object, enabling you to query call recordings using a provided call CID.🔄 Changed
StreamCallType is now deprecated. Instead, use the StreamCallType.defaultType() factory constuctor.🐞 Fixed
ScreenSharingConstraints to adjust the quality.FloatingViewAlignment enum is now properly exported in the stream_video_flutter package.docs: added additional cookbook guides by @deven98 in https://github.com/GetStream/stream-video-flutter/pull/540
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.4.2...v0.4.3
🐞 Fixed
✅ Added
CallMissedEvent event will be sent now when the user misses the call.startTranscription(), stopTranscription() and listTranscriptions() methods to Call class.takeScreenshot() method to Call class.recordingExternalStorage optional param to call.startRecording() method.requestScreenSharePermission() method to Call class that ensures correct permissions are given for screen-sharing on Android.🔄 Changed
role member to roles, to reflect the possibility of the user having multiple roles, in CallParticipantState and CallMember.SortParamRequest to SortParam.🔄 Changed some of the signatures
listRecordings() method in PermissionsManager doesn't require sessionId param now.setParticipantPinned() method in Call and CallSession now requires sessionId, userId, and pinned params instead of SetParticipantPinned action.updateViewportVisibility() method in CallSession now requires visibilityChange param instead of UpdateViewportVisibility action.setSubscriptions() and updateSubscription() methods in CallSession now require a list of subscriptionChanges param instead of a list of SetSubscription actions.reason param to reject() method in Call class.Removed
updateSubscriptions method from Call.chore(llc): Added missing ClientDetails to sfu join request by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/678
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.4.1...v0.4.2
✅ Added
ClientDetails to SFU's join request.🐞 Fixed
feat(llc): add handling of participantUpdated SFU event by @esarbanis in https://github.com/GetStream/stream-video-flutter/pull/672
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.4.0...v0.4.1
🚧 Build breaking changes
connectivity_plus dependency to 6.0.3Note, that this changes the plugin requirements:
- compileSDK 34 for Android part
- Java 17 for Android part
- Gradle 8.4 for Android part
🐞 Fixed
docs: small changes and doc fixes by @deven98 in https://github.com/GetStream/stream-video-flutter/pull/665
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.3.9...v0.4.0
🚧 Breaking changes
Updated minimum supported dart SDK version to 3.3.0 (which requires min Flutter SDK 3.19.0)
Updated flutter_webrtc to 0.10.4
🐞 Fixed
chore(dogfooding): update dogfooding deps to 0.3.8 by @Brazol in https://github.com/GetStream/stream-video-flutter/pull/659
Full Changelog: https://github.com/GetStream/stream-video-flutter/compare/v0.3.8...v0.3.9
flutter_webrtc dependency version back to 0.9.47 to fix the compilation issues for web in Flutter 3.19.One column per quarter.