AliPlayerWidget is a Flutter video playback widget built on the Alibaba Cloud Player SDK flutter_aliplayer. Use it to integrate video playback into a Flutter application with a small amount of code and to customize the playback UI and behavior for VOD, live streaming, playlist, and short drama scenarios.
Project introduction
AliPlayerWidget targets Flutter applications that need video playback, and covers common use cases in education, entertainment, e-commerce, and short drama scenarios. The widget exposes an API that lets you enable playback with a few lines of code, and it ships with built-in controls, gesture handling for brightness, volume, and progress, and hooks for overlaying your own UI.
Core features
Multi-scenario support — VOD, live streaming, playlist playback, and full-screen playback.
Playback controls — Playback control, settings panel, cover image, resolution switching, and gesture-based brightness, volume, and progress adjustments.
Multiple video source types — URL, VID+STS, and VID+Auth.
UI customization — Replace or hide the top bar, bottom bar, control area, cover, and subtitles through the slot system. Includes reusable modular components and automatic landscape and portrait adaptation.
Playback management — Built-in strategies for first-frame statistics and stutter detection, with support for custom strategies. Real-time monitoring of playback status, video dimensions, and buffering progress, plus event callbacks and log-based debugging.
Scan to try
To evaluate AliPlayerWidget without setting up a development environment, install the prebuilt demo package on your device.
How to get the demo
Scan the following QR code with your phone to download and install the demo package:
Make sure that you have enabled the permission to install third-party apps on your device.
Project download
After you decide to integrate AliPlayerWidget into your own application, download the project from AliPlayerWidget. The project provides documentation and step-by-step instructions that both AI tools and developers can follow. Dedicated Skills support is planned for a more complete integration experience.
Quick integration
AliPlayerWidget provides an API that lets you add video playback in a few steps. For step-by-step instructions, see Integration preparation and Quick start.
Customization
AliPlayerWidget exposes several extension points that let you tailor the UI and playback behavior without modifying the player core.
Slot system — Slots are the basic building blocks of the player UI. Built-in default UIs with a unified design are ready to use out of the box. You can also replace slots, hide default UI elements at fine granularity, and insert custom components such as ads, bullet comments, and watermarks at any level. For details, see Slot system.
Strategy system — Strategies are the basic organizational units of player behavior logic. Built-in recommended strategies cover first-frame statistics and stutter detection, and you can add custom strategies for playback quality monitoring and business event tracking without modifying the player core. See Strategy system.
Video source support — Configure playback sources as direct URL, VID+STS, or VID+Auth. Details in Multiple video sources.
UI themes — Follow a unified UI design specification and swap player skins by passing in an icon resource path for brand customization. See UI theme.
API reference — A set of external interfaces that let you directly control player behavior. See API reference.