video_view 1.1.4

video_view: ^1.1.4 copied to clipboard

About #

video_view is a lightweight media player with subtitle rendering¹ and audio track switching support, leveraging system or app-level components for seamless playback. For API documentation, please visit here.

NOTE: video_view requires Flutter 3.32 or higher. For older versions, please use av_media_player instead.

Demo #

You may try the online demo, or run the demo app locally by cloning this repository:

git clone -c core.symlinks=true https://github.com/xxoo/flutter_video_view.git
cd flutter_video_view/example

For basic usage, just run:

flutter run

For advanced usage, please run:

flutter run lib/main_advanced.dart

Installation #

1. Add dependency in your project by running:

flutter pub add video_view

2. Reference video_view in your Dart code:

import 'package:video_view/video_view.dart';

3. If your project has web support, you may also need to initialize the web entry point by running the following command after installing or updating video_view package:

dart run video_view:webinit

4. If you encounter "setState while widget is building or locked" issue, then you probably need to install set_state_async package as well.

Platform support #

Supported media formats #

For user who only cares about Android and iOS, the following formats are supported without condition:

A more complete list with conditions:

How to specify format manually #

Most backends don't support manually specifying media format, with Android and Web being the exceptions. Therefore, there's no formal API planned for this feature. However, supported platforms can automatically detect the format from the URL. You can simply append a file extension to the query string or hash fragment to specify the format. Please note that only 3 extensions are recognized: .m3u8, .mpd, and .ism/manifest. If multiple extensions are found, the last one takes precedence. For example:

// No need to specify format, the url already contains `.m3u8`
final example0 = 'https://example.com/video.m3u8';

// Missing extension in path, add `.m3u8` in hash fragment
final example1 = 'https://example.com/video#.m3u8';

// Or in query string
final example1 = 'https://example.com/video?.m3u8';

// Override HLS to DASH
final example2 = 'https://example.com/video.m3u8#.mpd';