aliplayer_widget 7.8.1 copy "aliplayer_widget: ^7.8.1" to clipboard
aliplayer_widget: ^7.8.1 copied to clipboard

A high-performance video playback component specifically designed for Flutter applications, built on top of the AliCloud Player SDK `flutter_aliplayer`.

AliPlayerWidget Changelog #

7.8.0 Enhanced Subtitles, Scene Control, Download and Screenshot #

New Features #

  • External Subtitle Support
    Added comprehensive support for external subtitles, including:
    • Toggle button to show/hide external subtitles
    • Customizable display logic and positioning
    • Dedicated SubtitleBuilder and configuration moved to AliPlayerWidgetData
    • Optimized rendering performance and code structure
  • Advanced Scene Types for UI Control
    Introduced new scene types to enable fine-grained UI behavior:
    • SceneType.minimal: Surface-only playback with no UI elements
    • SceneType.restricted: Disables all controls and gestures for secure or limited playback scenarios
  • Enhanced Media Operations: Download, Screenshot & Live Refresh Implemented key user-facing media control capabilities:
    • Video Download: Support for downloading VOD content, including authenticated VID-based sources (VidSts/VidAuth)
    • In-Player Screenshot: Capture and save the current video frame during playback (supports both VOD and live)
    • Live Stream Refresh: Dedicated refresh button to reload live streams when encountering network or playback issues
  • Playback Tracking with Trace ID
    Added traceId support in AliPlayerWidget to enable end-to-end video playback tracking and diagnostics.
  • Multi-Definition VOD Playback Logic
    Expanded playback logic to better handle multi-definition Video-on-Demand (VOD) content.

Improvements #

  • Player View Default Update
    Changed default player view type on Android to AliPlayerViewTypeForAndroid.textureview for improved compatibility and performance.

  • Documentation Enhancements

    • Updated README with integration diagrams (Integration.png, Integration_en.png)
    • Revised usage examples to use the modern videoSource API
    • Deprecated videoUrl and AliPlayerWidgetData.fromUrl in favor of videoSource

Breaking Changes #

  • Recommended Global Configuration Initialization To ensure proper storage path setup and platform-specific behavior (e.g., Android external storage vs. iOS sandbox), it is recommended to initialize AliPlayerWidgetGlobalSetting early in your application lifecycle.

    Migration Suggestion: Please refer to example/main.dart for the suggested initializeGlobalSettings() implementation, which intelligently configures cache and file directories based on the platform:

    /// Initialize aliplayer_widget global settings, including storage paths.
    /// Call this once at app startup.
    Future<void> initializeGlobalSettings() async {
      await AliPlayerWidgetGlobalSetting.setupConfig();
      // ... (platform-specific path logic as shown in example)
      AliPlayerWidgetGlobalSetting.setStoragePaths(cachePath: ..., filesPath: ...);
    }
    

    Failure to initialize global settings may result in missing directories, cache errors, or playback failures. This change ensures proper file management and platform compliance.

  • Deprecated Controller Methods
    The following methods in AliPlayerWidgetController are now deprecated and will be removed in a future release:

    • getWidgetVersion() → Use AliPlayerWidgetGlobalSetting.kWidgetVersion
    • clearCaches() → Use AliPlayerWidgetGlobalSetting.clearCaches()

    Widget version has been updated to 7.8.0 as part of this change (included in 7.8.0 release).


Note: This release significantly enhances subtitle capabilities, introduces powerful scene-based UI control, and provides greater flexibility in storage and file management. The breaking changes around cache and version APIs require minor migration. Upgrading is recommended for apps needing external subtitles, secure playback modes, or customizable storage paths.


7.3.0 Screen Keep-On & Streaming Protocol Fixes #

New Features #

  • Screen Keep-On Support
    Added screen keep-on functionality to prevent the device screen from dimming or locking during video playback.
    This feature is especially useful for long-form content, live streaming, and educational video applications.

Improvements #

  • The method for switching between portrait and landscape modes has been modified. Now, the navigation bar will not be included when switching orientations.
  • The functionality to select a decoder has been integrated, allowing you to choose between software decoding or hardware decoding for playback based on your needs.

Bug Fixes #

  • Fixed URL-based Video Source Playback for RTMP/ARTC Streams
    Resolved an issue where URL-formatted video sources were unable to play RTMP/ARTC format streams correctly.
    This update ensures better compatibility with various streaming protocols across different playback scenarios.

Note: This release enhances playback reliability and improves user experience for streaming use cases. Upgrading is recommended for apps requiring support for RTMP/ARTC and screen keep-on behavior.

7.2.0 Enhanced Video Source Support #

New Features #

  • Multiple Video Source Support: Added compatibility for various video source types, enabling playback through:

    • Direct URL playback for publicly accessible videos.
    • VID+STS token-based playback for secure access and enhanced control.
    • VID+Auth authentication-based playback for simplified authorization scenarios.

    This enhancement ensures that developers can meet diverse playback requirements across different use cases, such as VOD (Video on Demand), live streaming, and secure media distribution.

Improvements #

  • Streamlined video source configuration to make it easier for developers to switch between different playback modes dynamically.
  • Updated the example project to demonstrate the integration of all supported video source types, providing a comprehensive reference for implementation.

Documentation Updates #

  • Expanded the README documentation to include detailed guidance on configuring and utilizing each video source type.
  • Added code examples for integrating URL, VID+STS, and VID+Auth playback modes, ensuring clarity for developers adopting these features.

Note: This release focuses on enhancing video source flexibility and improving developer experience. Upgrading is recommended for projects requiring multi-source playback support.

7.0.3 Bug Fixes and Feature Enhancements #

Bug Fixes #

  • Resolved issues related to pub.flutter-io.cn compliance, ensuring smoother package publication and integration.
    • Addressed metadata and dependency-related warnings.
    • Improved package validation to meet pub.flutter-io.cn quality standards.

New Features #

  • Introduced business identifier support, allowing developers to tag player instances with custom identifiers for better tracking and analytics.

    • This feature enhances the ability to monitor and manage player usage in complex multi-scenario applications.
  • Added video source switching functionality to the example project, enabling seamless transitions between different video sources during playback.

    • This update provides a practical demonstration of dynamic source management and enhances the flexibility of the example project for developers.

7.0.2 UI Performance Optimization #

Performance Improvements #

  • Enhanced PageView scrolling performance, significantly reducing lag during transitions.
  • Optimized UI rendering for smoother interactions and improved responsiveness.

Bug Fixes #

  • Fixed video loading delays during PageView scrolling on certain devices.
  • Resolved UI layout issues during full-screen mode transitions.

Note: This release focuses on UI performance optimization. Upgrading is recommended for a smoother experience.


7.0.1 Documentation Improvements #

Documentation Updates #

  • README Enhancements
    • Improved clarity and structure of the README documentation for better readability.
    • Included additional guidance on integrating AliPlayerWidget in multi-scenario applications (e.g., VOD, live streaming, short videos).

No Functional Changes #

This release focuses solely on improving documentation and does not include any functional changes or bug fixes. All features and APIs remain consistent with version 7.0.0.


7.0.0 Initial Release #

Features #

  • Core Player Functionality

    • Implemented basic video playback capabilities including play, pause, stop and seek operations.
    • Added support for multiple playback rates with setRate() method.
    • Integrated brightness and volume control with delta adjustments.
  • Controller Architecture

    • Developed AliPlayerWidgetController as the main interface for player interactions.CHANGELOG.md
    • Implemented various notifiers including:
      • mirrorModeNotifier
      • isMuteNotifier
      • scaleModeNotifier
      • isLoopNotifier
      • speedNotifier
      • trackInfoListNotifier
      • thumbnailNotifier
  • Event Handling System

    • Established comprehensive callback mechanisms for player events:
      • Video size change detection
      • Loading status notifications (begin, progress, end)
      • Seek completion events
      • Playback position tracking

UI Components #

  • Setting Menu Panel

    • Created customizable settings menu with visibility control.
    • Implemented setting items builder for dynamic configuration options.
  • Overlay System

    • Introduced flexible overlay system allowing custom widgets to be positioned over the player.
    • Supports multiple overlay elements with absolute positioning.

Technical Implementation #

  • Platform Integration

    • Implemented platform brightness detection for automatic theme mode adjustment.
    • Developed robust initialization and destruction processes for player instances.
  • Data Management

    • Created AliPlayerWidgetData class for managing video source information.
    • Supports various media sources including VOD and live streams.

Documentation #

  • Provided complete README documentation including:
    • Quick start guide
    • Core component descriptions
    • Customization instructions
    • Code examples for common use cases
5
likes
140
points
145
downloads

Publisher

unverified uploader

Weekly Downloads

A high-performance video playback component specifically designed for Flutter applications, built on top of the AliCloud Player SDK `flutter_aliplayer`.

Homepage
Repository (GitHub)
View/report issues

Topics

#player #video #video-player #aliyun #short-drama

Documentation

API reference

License

MIT (license)

Dependencies

flutter, flutter_aliplayer, wakelock_plus

More

Packages that depend on aliplayer_widget