omni_video_player

🐛 Fixes

• Sending one player fullscreen released every other player on the page: the fullscreen covers them, so they read as scrolled off-screen. They are now left alone while a fullscreen of ours is open, instead of coming back seconds later on a new controller.
• A player coming back on a new controller left the play/pause button listening to the old one: the icon stayed on play while the video ran, and only caught up once the controls were hidden and shown again.
• A controller disposed while its widgets were still mounted threw used after being disposed on the next rebuild, and the broken frame left the layout stuck. Listeners and notifications are now swallowed once a controller is disposed.

🐛 Fixes

• Fullscreen is now hoisted above the route stack for a player inside a page too, so an OverlayEntry the app put over it — a tutorial bubble, a banner, a PiP — no longer covers it.
• The fullscreen page keeps the themes around the player, its own among them.

🐛 Fixes

• Fullscreen on the WebView players (YouTube, Vimeo) tore the webview down and reloaded the video, a regression of 6.0.3.

🐛 Fixes

• Fullscreen now paints above any OverlayEntry the app inserted over the route stack, so a player living in one no longer shows its old controls through fullscreen.

🐛 Fixes

• A player placed outside a ModalRoute — in an OverlayEntry above the page, for instance — crashed on build with Null check operator used on a null value.

🐛 Fixes

• enableZoom works again, and now also on the WebView players (YouTube live, Vimeo) (#85).

⚠️ Breaking changes

• OmniPlaybackController.dispose() now returns Future<void>. Await it when you need the video's resources freed before doing something else, such as opening a camera. Custom implementations must change their signature.
• On Android only one video plays at a time, muted or not. On iOS and web muted videos still play together.
• On Android, a video with sound no longer stops the audio of other apps.
• CustomPlayerWidgets.loadingWidget now defaults to the player's own loader instead of a plain CircularProgressIndicator.

🐛 Fixes

• On Android replay() rewound the video but never started it again. It now restarts right away, even on a big 4K video.
• Dragging the progress bar no longer makes the video jump through every position you pass over.
• When one video failed, every other player on screen was closed too, and they did not come back. Now only the failing one is affected: it retries, then shows its errorPlaceholder.
• The spinner shown during a seek now uses your loadingWidget and respects showLoadingWidget. So do the two WebView players and the initial loading state.

🎛️ New

• isReplaying on the controller: true while the video is restarting. Use it to avoid offering a "tap to restart" on a restart already under way.
• PlayerUIVisibilityOptions.showSeekingIndicator (default true): hides the seek spinner alone.
• GlobalPlaybackController is now exported. Call releaseAllResources() on it to give the device's video resources back, before opening a camera for example; the players on screen come back on their own afterwards.

🐛 A custom loading widget is no longer letterboxed

• loadingWidget was boxed into a guessed 16/9 while the aspect ratio was still unknown, so a full-bleed loader came out the wrong shape on a portrait video. It now fills the player until the real ratio is known; a centred spinner is unaffected.

🔊 Several muted players at once

• Muted players no longer pause each other, so a list of short muted loops animates together. Exclusive playback still applies, but only among audible players — a single video with sound is unchanged.
• The wakelock is held only while a player is audible or fullscreen.

⏱️ "Finished" is now correct, on all four backends

• isFinished compares durations instead of whole seconds: a 1.96s video no longer reports finished at 1.0s, nor a sub-second one from position zero. A thumbnail therefore stops covering a still-playing video.
• onFinished fires once per playback at the real end and re-arms, so it can count loops — fullscreen used to fire it twice.

🔈 initialVolume survives

• No longer overwritten by the shared volume, and starting playback no longer changes it. Omit it to follow the shared volume; hasExplicitVolume tells the two apart.

🐛 Fixes

• copyWith dropped videoFile, so .file(...).copyWith(...) always crashed on init.
• YouTube live could hang on the loading spinner when the metadata lookup was blocked.
• YouTube in WebView could show the replay button instead of play on load, with taps unable to start playback, because the placeholder duration counted as "finished" (#84).

🧹 Static analysis

• Removed an unused catch stack-trace variable so the package passes pub.dev static analysis cleanly.

🎛️ YouTube WebView controls — grouped config (BREAKING)

• YouTube WebView flags moved into VideoSourceConfiguration.youtube(webView: YoutubeWebViewConfiguration(...)):
  • forceWebViewOnly (was forceYoutubeWebViewOnly), enableFallback (was enableYoutubeWebViewFallback).
  • useNativeControls (new, default true): use YouTube's native play/pause + double-tap (our bottom bar stays overlaid). Set false for the previous fully-custom controls.
  • onExternalLink: react to in-player links (Watch on YouTube, title, …) — they're always blocked.

Migration: move forceYoutubeWebViewOnly/enableYoutubeWebViewFallback into webView:; set useNativeControls: false to keep the old custom controls.

🐛 Bug Fixes — playback reliability (#82, #78)

• Videos now resume correctly after seeking, instead of stalling or getting stuck on an error (#82).
• YouTube and Vimeo recover on their own from the random "sometimes it plays, sometimes it doesn't" failures — no more restarting the app (#78).
• Smoother playback, faster loading, and less memory use when videos scroll off screen.
• YouTube in WebView now loads reliably, no longer pauses itself on the first play, and captions stay off.
• WebM videos now show the correct duration and progress bar (no more stuck at 00:00 or a permanent replay button).
• Playlists in fullscreen: fixed the freeze/black screen and the flickering next/previous buttons when changing video.
• Fullscreen controls now respect the notch / safe area.
• Text selection inside the video players is disabled.

🐛 Bug Fixes — fullscreen orientation (#75)

• Leaving fullscreen no longer forces all orientations, which previously overrode an app-wide lock such as SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp]).
• Added PlayerUIVisibilityOptions.restoreOrientationsAfterFullscreen: set it to your app's orientations (e.g. [DeviceOrientation.portraitUp]) and they are reapplied automatically when the player exits fullscreen.
• Default is null, which keeps the previous behavior (restore all orientations) — non-breaking.

🐛 Bug Fixes — kids/restricted YouTube playback

• When the androidVr manifest fails (kids/restricted videos), fall back to the default InnerTube clients and keep muxed streams only (~360p), avoiding the HTTP 403 that adaptive video+audio streams return in ExoPlayer for these videos.
• Skip the "no audio streams" error when the selected muxed stream already includes mp4a audio.
• Transient/network failures on the androidVr manifest are no longer treated as restricted: they are retried instead of triggering the mux-only fallback, so normal videos are never silently downgraded to 360p on a single network blip.
• Normal videos are unchanged: androidVr manifest with the existing Android/iOS stream selection (720p+ on Android).

🎬 Playlist

• New OmniVideoPlaylist widget with OmniPlaylistController, PlaylistConfiguration, and PlaylistCallbacks.
• Plays an ordered queue of videos with on-video previous/next buttons. Optional autoAdvance (advance automatically when a video finishes) and loop (wrap around the ends).
• Purely additive to single-video behaviour. Also adds value equality to VideoSourceConfiguration.

🎨 Theming (breaking)

• BREAKING: Renamed VideoPlayerColorScheme.playPauseBackground → controlButtonBackground and playPauseIcon → controlButtonIcon. These colors are shared by the play/pause, replay, loader and skip-indicator buttons, and now the playlist prev/next buttons too. Migration: rename these parameters in your VideoPlayerColorScheme(...) / .copyWith(...) calls.
• Playlist prev/next buttons are fully themeable, consistent with the other control buttons: colors (controlButtonBackground/controlButtonIcon), icons (VideoPlayerIconTheme.skipPrevious/skipNext), and accessibility labels (VideoPlayerAccessibilityTheme.previousTrackLabel/nextTrackLabel).

✨ Stability & Bug Fixes

• Safe Disposal Handling:
  • Added comprehensive isDisposed guards to all controller setters (volume, duration, playing, etc.) to prevent "ChangeNotifier used after being disposed" crashes during global resource cleanup.
  • Improved GlobalVolumeSynchronizer to safely ignore disposed controllers during global volume updates.
  • Added safety checks for JavaScript evaluation in WebView-based controllers after disposal.

✨ New Features & Bug Fixes

• Improved Resource Management:
  • Added isDisposed check to all controllers to prevent ChangeNotifier errors after disposal.
  • Enhanced OmniVideoPlayerView to safely handle controller disposal and listener removal.
• Auto-Reinitialization:
  • Added VisibilityDetector to OmniVideoPlayerInitializer to automatically re-initialize players that were disposed or failed when they become visible again.
  • This ensures a seamless user experience when scrolling back to a video after a global memory cleanup.

✨ New Features

• Hardware Decoder Auto-Recovery:
  • Added a global tracking system for OmniPlaybackController instances.
  • Implemented automatic cleanup and retry logic when Android reports NO_MEMORY or CodecException (error 0xfffffff4).
  • Added releaseAllResources() to GlobalPlaybackController to force-dispose all active players in critical memory situations.

🛠 Fix

• Fixed replay race condition on all player types (YouTube, Vimeo, WebM, network).

  • replay() now runs sequentially (pause → seekTo(0) → play) instead of in parallel, preventing the video from stalling at position 0 with the wrong button state.

• Fixed autoMuteOnStart + autoPlay ignored on Vimeo mobile.

  • play(), mute(), unMute(), and volume setter now use _executeOrQueue so deferred actions are correctly applied once the WebView is ready.
  • Fixed a bug where the volume setter was passing the old value ($volume) instead of the new value ($value) to the JS player.

✨ New Features

• Feat: New interactive Web volume slider (VolumeSliderControl) with hover support.
• Breaking (Theme): Renamed VideoPlayerOverlayTheme to VideoPlayerBackdropTheme.
• Theme: Introduced VideoPlayerMenuTheme, menuBorderRadius, volumeSliderThumbShape, and new volume-specific colors in VideoPlayerColorScheme.

🛠 Fix

• resolve autoMuteOnStart ignored
  • See issue: #73

🛠 Fix

• Fixed playback controls visibility and interaction issues on Web.
  • See issue: #70

✨ New Features

• Added activeGradient parameter to VideoPlayerColorScheme into OmniVideoPlayerThemeData

🛠 Fix

• Fixed an error on onSeekRequest

🛠 Fix

• Fixed an error when switching to fullscreen in youtube live video
  • See issue: #72

🛠 Fix

• Fixed an error into build for mobile

⬆️ Update documentation

✨ New Features

• Added native HTML iframe support for Vimeo on Flutter Web
  • See issue: #67

✨ New Features

• Added httpHeaders parameter to VideoSourceConfiguration.network()
  • See issue: #68

🛠 Fix

• Fixed an issue where YouTube live videos were failing to play.
  • See issue: #66

🛠 Fix

• Fixed minor bugs

✨ New Features

• Added autoFullScreenAtStart parameter to VideoSourceConfiguration.
  • This flag controls whether the video should automatically switch to fullscreen mode as soon as the player initialization is complete.
  • Default: false.

🛠 Fix

• Fixed audio-video synchronization issues for YouTube videos.
  • Resolved desynchronization occurring when seeking or changing playback speed.
  • See issue: #64

✨ New Features

• Added pauseWhenOutOfView parameter to VideoSourceConfiguration.
  • This flag controls whether the video should automatically pause when the player is scrolled out of the viewport or is no longer visible.
  • Default: true (the video will pause when it leaves the view).

⬆️ Update documentation

🛠 Fix

• Fixed network http player bug with duration
  • See issue: #56

• Fixed minor bugs on YouTube Webview isFinished
• Add support to webm on iOS (with a WebView)

• Fixed minor bugs:
  • Resolved video/audio desynchronization when using seekTo
  • Improved WebView rendering performance

🛠 Fix

• Fixed vimeo player bug
  • See issue: #54

⬆️ Updates pub.dev page

✨ New Features

• Added new enableZoom parameter in PlayerUIVisibilityOptions to allow pinch-to-zoom gestures on the video player (default: false).
• Fixed some minor bugs

🛠 Fix

• Fixed some minor bugs