omni_video_player

🧹 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

🛠 Fix

• Fixed the issue where unlisted YouTube videos kept loading.

  • See issue: #50

✨ New Features

• Added new fitVideoToBounds parameter in PlayerUIVisibilityOptions to control whether the video fills the available area (default: true).

🛠 Fix

• Minor stability and UI fixes.

✨ New Features

• Added scrubbing thumbnail preview in the video player UI.

  • Introduced a new showScrubbingThumbnailPreview parameter in PlayerUIVisibilityOptions.
  • This parameter allows developers to enable or disable the small preview thumbnail that appears when dragging the seek bar.
  • Default value is true, ensuring the preview is shown unless explicitly turned off.