adaptive_video_player 1.2.0

A Flutter video player package that seamlessly handles both YouTube videos and direct video URLs with adaptive player selection. Supports Android, iOS, Windows, macOS, Linux, and Web.

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:adaptive_video_player/adaptive_video_player.dart';

void main() {
  AdaptiveVideoPlayerPlatform.ensureInitialized();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Videos Player Example',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Videos Player Example'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  void _navigateToVideo(String title, VideoConfig config) {
    Navigator.push(
      context,
      MaterialPageRoute(
        builder: (context) => VideoPlayerPage(title: title, config: config),
      ),
    );
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: ListView(
        padding: const EdgeInsets.all(16.0),
        children: <Widget>[
          _buildVideoButton(
            'Quality Picker & HLS Stream',
            VideoConfig(
              videoUrl:
                  'https://www.mp3quran.net/uploads/videos/group1_pbuh/maher.mp4',
              subtitles: [
                const SubtitleTrack(
                  id: 'en',
                  title: 'English',
                  content: '''
1
00:00:01,000 --> 00:00:04,000
This is a sample English subtitle.

2
00:00:04,500 --> 00:00:08,000
It shows how subtitles overlay on video.
                  ''',
                ),
                const SubtitleTrack(
                  id: 'ar',
                  title: 'عربي',
                  content: '''
1
00:00:01,000 --> 00:00:04,000
هذه ترجمة تجريبية باللغة العربية.

2
00:00:04,500 --> 00:00:08,000
تظهر كيف يتم دمج الترجمة بدقة عالية على الفيديو.
                  ''',
                ),
              ],
              initialSubtitle: const SubtitleTrack(
                id: 'en',
                title: 'English',
                content: '''
1
00:00:01,000 --> 00:00:04,000
This is a sample English subtitle.

2
00:00:04,500 --> 00:00:08,000
It shows how subtitles overlay on video.
                  ''',
              ),
              qualities: [
                const VideoQuality(
                  title: 'Auto (HLS)',
                  url: 'https://upload.mp3quran.net/group1_pbuh/maher.mp4',
                ),
                const VideoQuality(
                  title: 'HD',
                  url: 'https://upload.mp3quran.net/group1_pbuh/maher.mp4',
                ),
                const VideoQuality(
                  title: 'SD',
                  url: 'https://upload.mp3quran.net/group1_pbuh/maher.mp4',
                ),
              ],
              initialQuality: const VideoQuality(
                title: 'Auto (HLS)',
                url: 'https://upload.mp3quran.net/group1_pbuh/maher.mp4',
              ),
              onAnalyticsEvent: (event, data) {
                debugPrint('Analytics: $event - Data: $data');
              },
            ),
          ),
          const SizedBox(height: 16),
          _buildVideoButton(
            'Video with "Live" Option in Settings',
            const VideoConfig(
              // Here is the non-live MP4 stream
              videoUrl: 'https://upload.mp3quran.net/group1_pbuh/maher.mp4',
              viewerCount: '93k VIEWERS', // Demonstration of the viewer count!
              qualities: [
                VideoQuality(
                  title: 'Recorded (MP4)',
                  url: 'https://upload.mp3quran.net/group1_pbuh/maher.mp4',
                  isLive: false,
                ),
                VideoQuality(
                  title: 'Live broadcast',
                  url: 'https://win.holol.com/live/quran/playlist.m3u8',
                  isLive:
                      true, // This makes the "LIVE" text appear inside the settings & bottom bar when selected!
                ),
              ],
            ),
          ),
          const SizedBox(height: 16),
          _buildVideoButton(
            'YouTube Video',
            VideoConfig(
              videoUrl: 'https://www.youtube.com/watch?v=2Or3_FX1KrA',
              playerConfig: YouTubePlayerConfig(
                playback: PlayerPlaybackConfig(forceDesktopMode: true),
                text: PlayerTextConfig(
                  invalidYoutubeUrlText: 'Invalid YouTube URL provided.',
                  videoLoadFailedText: 'We failed to load the video.',
                  videoUnavailableText: 'Sorry, video is unavailable.',
                  videoNotCompatibleText: 'Incompatible video format.',
                  videoCannotBeLoadedSecurityPolicyText:
                      'Security policy error.',
                  playerSettingsText: 'Settings',
                  autoPlayText: 'Auto Play (enabled)',
                  loopVideoText: 'Loop',
                  forceHdQualityText: 'Force HD',
                  enableCaptionsText: 'Captions',
                  muteAudioText: 'Mute',
                ),
              ),
            ),
          ),
          const SizedBox(height: 16),
          _buildVideoButton(
            'YouTube Live Stream',
            const VideoConfig(
              // Example: YouTube live stream provided by user
              videoUrl: 'https://www.youtube.com/watch?v=81x2EKtlklU',
              isLive:
                  true, // This enables the special YouTube Live controls/ui hiding
            ),
          ),
          const SizedBox(height: 24),
          const Text(
            'This player supports YouTube features and normal MP4/network videos adaptively.',
            textAlign: TextAlign.center,
          ),
        ],
      ),
    );
  }

  Widget _buildVideoButton(String title, VideoConfig config) {
    return ElevatedButton(
      style: ElevatedButton.styleFrom(
        padding: const EdgeInsets.symmetric(vertical: 20, horizontal: 16),
        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
      ),
      onPressed: () => _navigateToVideo(title, config),
      child: Text(
        'Play: $title',
        style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
        textAlign: TextAlign.center,
      ),
    );
  }
}

class VideoPlayerPage extends StatelessWidget {
  final String title;
  final VideoConfig config;

  const VideoPlayerPage({super.key, required this.title, required this.config});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(title),
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
      ),
      body: Center(child: AdaptiveVideoPlayer(config: config)),
    );
  }
}