aliplayer_widget-v7.12.2
[7.12.2] - Slot Builder Controller Parameter & Fullscreen Improvements
New Features
-
Slot Builder Controller Parameter for Fullscreen Support
- Introduced
SlotWidgetBuilderWithControllertype that passes the currentAliPlayerWidgetControllerinstance 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
SlotWidgetBuilderis still supported but deprecated. Automatic signature detection ensures seamless migration.
- Introduced
-
Custom Configuration Callbacks
- Added
OnGlobalInitCallbackviaAliPlayerWidgetGlobalSetting.setOnGlobalInit, called after global initialization for custom global settings (e.g.,setOption). - Added
OnPlayerConfigCallbackviaAliPlayerWidgetData.onPlayerConfig, called beforeprepare()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.
- Added
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
VidAuthvideo source instead of URL-based source. - Added
constconstructors for better performance.
- Updated to use recommended
-
Core Components Restructure
- Reorganized with numbered sections for improved readability and navigation.
-
Video Source Documentation
- Reordered to highlight
VidAuthas the recommended playback method. - Clarified the advantages and use cases of each video source type.
- Reordered to highlight
-
Global Configuration Clarification
- Emphasized default optimal settings.
- Clarified usage notes for custom configuration scenarios.