Skip to content

aliplayer_widget-v7.12.2

Choose a tag to compare

@JunHui-Ye JunHui-Ye released this 15 Apr 07:55
· 8 commits to master since this release

[7.12.2] - Slot Builder Controller Parameter & Fullscreen Improvements

New Features

  • Slot Builder Controller Parameter for Fullscreen Support

    • Introduced SlotWidgetBuilderWithController type that passes the current AliPlayerWidgetController instance to slot builders.
    • Enables custom slot UI to correctly control the player in fullscreen mode.
    • The new signature: Widget Function(BuildContext context, AliPlayerWidgetController controller).
    • Backward Compatible: Old single-parameter SlotWidgetBuilder is still supported but deprecated. Automatic signature detection ensures seamless migration.
  • Custom Configuration Callbacks

    • Added OnGlobalInitCallback via AliPlayerWidgetGlobalSetting.setOnGlobalInit, called after global initialization for custom global settings (e.g., setOption).
    • Added OnPlayerConfigCallback via AliPlayerWidgetData.onPlayerConfig, called before prepare() for per-instance player configuration (e.g., setConfig, setOption). Supports async operations (FutureOr<void>).
    • Enables customers to configure player APIs not directly exposed by AliPlayerWidget within the best-practice configuration flow.

Improvements

  • Simplified Fullscreen Toggle Logic
    • Refactored fullscreen toggle logic for better maintainability.
    • Unified system UI handling across portrait and landscape modes.

Bug Fixes

  • Documentation Language Switching
    • Fixed case-insensitive language switching in the documentation site.

Documentation Updates

  • README Simplification

    • Removed inline code examples from README.md and README-EN.md, directing users to the Quick Start Guide for complete implementation details.
    • Improved example READMEs with structured scenario descriptions (core features, implementation points, execution effects).
  • Quick Start Guide Enhancement

    • Updated to use recommended VidAuth video source instead of URL-based source.
    • Added const constructors for better performance.
  • Core Components Restructure

    • Reorganized with numbered sections for improved readability and navigation.
  • Video Source Documentation

    • Reordered to highlight VidAuth as the recommended playback method.
    • Clarified the advantages and use cases of each video source type.
  • Global Configuration Clarification

    • Emphasized default optimal settings.
    • Clarified usage notes for custom configuration scenarios.