omni_video_player 2.3.21

omni_video_player: ^2.3.21 copied to clipboard

🛠 Fix

• Update exports

🛠 Fix

• Fix issue with error into initializer

✨ New Features

• Add showOpenExternallyInErrorPlaceholder option to PlayerUIVisibilityOptions

  • When set to true, displays a “Open Externally” button inside the error placeholder if video playback fails.
  • Defaults to true.
  • Enables users to open the video in an external app or browser when the player encounters an error.

✨ New Features

• Add onSeekRequest callback to VideoPlayerCallbacks

  • Invoked before a seek operation is performed.
  • Returns a bool indicating whether the seek should proceed (true) or be cancelled (false).
  • Useful for implementing custom seek restrictions or validations.
  • ⚠️ Available only for videos that are not rendered inside a WebView

🛠 Fix

• Fix issue with swipe to exit from fullscreen

🛠 Fix

• Fix issue with seeking when the video has ended
  • Previously, attempting to seek after the video finished could cause unexpected behavior.
  • Now, seeking works correctly even when the video is at its end.

✨ New Features

• Add showBottomControlsBarOnEndedFullscreen option to PlayerUIVisibilityOptions
  • When set to true, the video bottom controls bar is displayed in fullscreen mode after the video ends.
  • Defaults to false.

🛠 Fix

• showPlayPauseReplayButton option to PlayerUIVisibilityOptions
  • Applies only when not in full screen

✨ New Features

• Add showPlayPauseReplayButton option to PlayerUIVisibilityOptions
  • Allows controlling the visibility of the main play / pause / replay overlay button (centered on the video)
  • Defaults to true

🛠 Fix

• Fixed a bug with youtube_explode_dart by forcing the use of YoutubeApiClient.androidVr when retrieving the video manifest.
  • See issue: youtube_explode_dart #361

🛠 Fix

• Fixed an issue where autoplay videos would start even when the player was no longer visible on screen.
  • See issue: #29

✨ New Features

• Added timeoutDuration parameter to VideoSourceConfiguration
  • Maximum wait time before considering playback failed
  • Defaults to 6 seconds
  • In the case of YouTube, the player will proceed with the fallback if enabled (default)
  • See issue: #33

✨ New Features

• Add support for dynamically changing the video source after player initialization.
  • Introduced loadVideoSource(VideoSourceConfiguration configuration) in OmniPlaybackController
  • Lets you seamlessly switch between YouTube, Vimeo, network, or asset sources without rebuilding the widget — or simply load a different video
  • See issue: #26

🛠 Fix

• Fixed Youtube WebView Error

✨ New Features

• Show YouTube video thumbnail while controller initializes.
  • Thumbnail is displayed immediately when available
  • See issue: #28

🛠 Fix

• Fixed CHANGELOG

✨ New Features

• Added video finish callback support.

  • Introduced onFinished in VideoPlayerCallbacks.
  • Triggered once when a video reaches the end of playback.

• Added replay callback support.

  • Introduced onReplay in VideoPlayerCallbacks.
  • Triggered when the user presses the replay button after video completion.

• See issue: #25

🛠 Fix

• Fixed window.onMessage handling by checking if data is String before casting
  • See issue: #24

✨ New Features

• Added keyboard arrow key support for web.
  • Users can now use the left (←) and right (→) arrow keys to skip backward and forward during playback.
  • Skip duration follows the same logic as double-tap gestures (5s, 10s, 30s depending on consecutive presses).
  • See issue: #23

✨ New Features

• Added showSwitchWhenOnlyAuto flag to PlayerUIVisibilityOptions.
  • Controls whether the Switch Quality button is displayed when no qualities are available and only the "Auto" option would appear in the dialog.
  • Default: true (button is still shown with "Auto").
  • If set to false, the button will be hidden when only "Auto" is available.
  • See issue: #22

✨ New Features

• On YouTube WebView, in addition to showing "auto", the player now also displays the current playback quality
  • See issue: #22

✨ New Features

• Added support for playing videos from the device's local file system
  • New factory: VideoSourceConfiguration.file
  • See issue: #18

🛠 Fix

• Fixed incorrect duration display for YouTube videos in the video player
  • See issue: #15

🛠 Fix

• Fixed autoplay issue with Vimeo videos

🛠 Fix

• Ensure quality menu is always visible, positioned above or below the video depending on available space.
  • See issue: #22

🛠 Clean code

🛠 Fix

• Show HQ quality options for Live YouTube videos that not use webview.
  • See issue: #22

✨ New Features

• Added custom aspect ratio support for both normal and fullscreen modes.

  • New properties in PlayerUIVisibilityOptions: customAspectRatioNormal and customAspectRatioFullScreen.
  • If not provided, the aspect ratio defaults to the one from the video controller.

• Added fullscreen orientation support.

  • New property in PlayerUIVisibilityOptions: fullscreenOrientation.
  • If null, the orientation is inferred from the video size (portrait if height > width, otherwise landscape).

✨ New Features

• Added playback speed support to VideoSourceConfiguration and the player UI.

  • New properties: initialPlaybackSpeed (default 1.0) and availablePlaybackSpeed (e.g., [0.5, 1, 1.5, 2]).
  • Added showPlaybackSpeedButton to PlayerUIVisibilityOptions to toggle visibility of the speed button.
  • Added playbackSpeedButton icon in VideoPlayerIconTheme for customization.
  • See issue: #16

• YouTube videos are now playable on web platforms, in addition to mobile.

🛠 Fix

• Fixed a bug where toggling back from fullscreen caused the status bar to turn black.
  • See issue: #20

🛠 Fix

• Fixed some imports

🛠 Fix

• Fixed an aspect ratio issue.
  • See issue: #17

🛠 Fix

• Updated supported video codecs to prevent playback errors on Android devices.
  • See issue: #17

🛠 Fix

• Fixed an issue on iOS where the Vimeo player failed to initialize.

✨ Improvements

• Vimeo WebView Migration

  • Replaced flutter_inappwebview with webview_flutter for Vimeo playback.

🛠 Fix

• Fixed a problem where some YouTube videos failed to play due to no compatible streams being found or WebView initialization timing out.
  • See issue: #13

🛠 Fix

• Fixed an issue where the onControllerCreated callback was invoked before the video controller was fully constructed.

  • This caused incorrect initialization behavior for WebView videos.

✨ New Features

• Added controlsPersistenceDuration to PlayerUIVisibilityOptions.

  • This property controls the duration the video player controls remain visible after user interaction while the video is playing.
  • After this duration without interaction, the controls are hidden automatically.
  • Default value is Duration(seconds: 3).

✨ New Features

• Added support for disabling automatic orientation lock in fullscreen mode via PlayerUIVisibilityOptions.enableOrientationLock (default: true).

• When set to false, the player will not change or lock the device orientation in fullscreen, allowing manual control over orientation changes (e.g., via your own fullscreen callbacks).

🛠 Fix

• Fixed audio-video sync issue when seeking in YouTube and network videos.

✨ New Features

• YouTube WebView Fallback & Forced Mode

  • Added two new parameters inside VideoSourceConfiguration.youtube to improve robustness of YouTube playback:

    • enableYoutubeWebViewFallback (default: true) — enables an automatic fallback to a WebView-based YouTube player (via webview_flutter) when native playback using youtube_explode_dart fails.
    • forceYoutubeWebViewOnly (default: false) — skips native extraction entirely and plays YouTube videos only through the WebView player.

💡 Why this change? The youtube_explode_dart library, used by default to extract YouTube stream URLs, can be temporarily blocked due to YouTube’s rate-limiting mechanism when too many requests are made. When this happens:

• Extraction fails for all videos (even those not previously blocked).
• The issue typically resolves after waiting several hours.
• Using a VPN does not bypass the block.

With this update:

• If fallback is enabled, the player transparently switches to the WebView-based implementation, ensuring playback continues without waiting for the rate-limit block to expire.

✨ New Features

• HLS (network) video support:
  • The player now supports HLS streams (.m3u8 files).
  • Allows quality selection for network-based HLS videos, just like with YouTube.
  • Controlled via the same preferredQualities and availableQualities parameters in VideoSourceConfiguration.network.
  • Automatically selects the best matching stream based on preferences or falls back to the highest quality.

🛠 Fixes

• Resolved an issue where Vimeo videos would not autoplay as expected.
• Fixed a bug causing the video to pause unexpectedly Issue #8 on GitHub

⚠️ Breaking Change

The customOverlayLayer field in CustomPlayerWidgets has been replaced by customOverlayLayers, a list of CustomOverlayLayer objects.

This allows adding multiple overlays on top of the video content, with fine-grained control over their rendering order.

Overlays are inserted into the rendering stack based on their level and order into list.

• Added ignoreOverlayControlsVisibility flag to CustomOverlayLayer, this allows custom overlays to remain visible even when player controls are hidden (e.g., during auto-hide).

✨ New Features

• Custom Overlay Layering Support:
  • Introduced CustomOverlayLayer, allowing insertion of custom widgets into the video player's visual stack.
  • Each overlay can now specify a level, which determines its rendering order relative to built-in player elements.

⚠️ Breaking Change

• preferredQualities has changed from List<int> to List<OmniVideoQuality> to improve clarity and flexibility when selecting video quality.
• Introduced new model: OmniVideoQuality, replacing raw integer representations with a structured quality model.

✨ New Features

• YouTube quality switching:
  • Added support for changing video quality in YouTube playback.
  • Controlled via the new flag: showSwitchVideoQuality.
  • New parameter: availableQualities: List<OmniVideoQuality>? added to VideoSourceConfiguration of YouTube videos.

🎨 Theming Enhancements

New theme properties added to OmniVideoPlayerTheme:

• menuBackground — dropdown background color
• menuText — color for unselected quality options
• menuTextSelected — color for the selected quality
• menuIconSelected — checkmark color for selected quality
• qualityChangeButton — icon used to open the quality menu
• qualitySelectedCheck — icon used to mark the selected option

• Fixed a bug where seeking in long YouTube videos caused noticeable delays

• Improvement: autoplay is now managed correctly for better user experience
• No parameter changes needed—just update the package to fix the issue

• Feature: Added gesture-based fast-forward (enableForwardGesture)
• Feature: Added gesture-based rewind (enableBackwardGesture)
• Feature: Added gesture to exit fullscreen on vertical swipe (enableExitFullscreenOnVerticalSwipe)
• All new gesture flags are enabled by default

• Fix: Fallback to null if GlobalPlaybackController is not found

• Fix bug when useGlobalPlaybackController: false

• Resolve pub.dev analysis issues

• Initial development release