# native_video_view A video player widget displayed using the platform native player (VideoView in Android and AVPlayer in iOS). ![example_gif](https://raw.githubusercontent.com/LJaraCastillo/native_video_view/master/pictures/example.gif "Example GIF") ## Disclaimer This plugin uses VideoView because in some devices the ExoPlayer plugin is not working correctly (due to decoders or something) and VideoView is a reasonable alternative. In iOS is sorta similar to Google's [video_player](https://pub.dev/packages/video_player) so you should use their plugin if you want a player for iOS only. ## Installation First you need to add the dependency in your `pubspec.yaml`. ```yaml native_video_view: ^0.3.0 ``` Then import the plugin in the .dart file you want to use it. ```dart import 'package:native_video_view/native_video_view.dart'; ``` ### Android You need to add the necessary permissions to play the videos. If you are playing videos from the internet, you need to add the internet permissions in your `AndroidManifest.xml` located in the `android` folder in your project. ```xml ``` If you are going to play videos from the device storage, you need to add the storage permissions. ```xml ``` ### iOS In this platform you need to configure some options in your `Info.plist` file. This file is located in `/ios/Runner/ Info.plist`. First add the embedded views configuration. ```plist io.flutter.embedded_views_preview ``` If you want to play videos from the internet add the following. ```plist NSAppTransportSecurity NSAllowsArbitraryLoads ``` ## Usage This plugin has a widget to use in your dart files. Example: ```dart @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: const Text('Plugin example app'), ), body: Container( alignment: Alignment.center, child: NativeVideoView( keepAspectRatio: true, showMediaController: true, onCreated: (controller) { controller.setVideoSource( 'assets/example.mp4', sourceType: VideoSourceType.asset, ); }, onPrepared: (controller, info) { controller.play(); }, onError: (controller, what, extra, message) { print('Player Error ($what | $extra | $message)'); }, onCompletion: (controller) { print('Video completed'); }, onProgress: (progress, duration) { print('$progress | $duration'); }, ), ), ); } ``` ***keepAspectRatio***: Wraps the video player in a `AspectRatio` widget. The aspect ratio is calculated once the video is loaded. By default the aspect ratio is 4/3. ***showMediaController***: Shows a default media controller overlay in the video player widget. ***enableVolumeControl***: Adds an option in the MediaController to control the volume of the playback. ***useExoPlayer***: Use ExoPlayer as the underlying player. **Android Only**. ***autoHide***: Automatically hides the media controller after a few seconds of no use. Default is `true`. ***autoHideTime***: The time after which the controller is hidden. Default is `2 seconds`. ***onCreated***: (required) Callback called when the PlatformView is finished creating. ***onPrepared***: (required) Callback called when the player has finished loading the video. ***onCompletion***: (required) Callback called when the video reached the end. ***onError***: Callback called if an error occurs in the player. ***onProgress***: Callback used to notify progress in the video playback. ### AudioFocus To make the player get the audio focus of the system you just have to use the setting ***requestAudioFocus*** when setting the video source. See the example below. ```dart @override Widget build(BuildContext context) { return NativeVideoView( onCreated: (controller) { controller.setVideoSource( 'assets/example.mp4', requestAudioFocus: true, sourceType: VideoSourceType.asset, ); }, ); } ```

excellent projects related to LJaraCastillo/native_video_view recommend downloading