adaptive_video_player 1.1.0

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

Adaptive Video Player 🎥

🔥 One Widget. All Platforms. YouTube + MP4. Zero Headaches.

A powerful cross-platform Flutter video player that supports YouTube, MP4, HLS, and local videos with one unified widget.

Android · iOS · Windows · macOS · Linux · Web

---

Quick Start ⚡

AdaptiveVideoPlayer(
  config: VideoConfig(
    videoUrl: "https://youtu.be/VIDEO_ID",
  ),
);

Just drop it in — it automatically adapts to YouTube or direct video streams.

---

Screenshots 📸

Android	Windows	Web
[Android]	[Windows]	[Web]

---

Features ✨

Adaptive Video Player 🎬

• 🔍 Smart YouTube vs MP4 detection
• 🎯 Unified API (one widget for everything)
• 🌍 True Cross-Platform support
• 📊 Native analytics events & callbacks (onAnalyticsEvent)
• 🧠 Production-ready architecture

---

YouTube Support 📺

• Native-like mobile experience
• Native YouTube controls on Desktop & Web
• Live Stream support (isLive, viewerCount)
• Force Desktop Mode on mobile
• Settings panel (HD, captions, loop, mute)
• Safe external link handling
• Fullscreen with state preservation
• WASM ready (Web via package:web)

---

Direct Video Support 🎞️

• MP4 · MOV · MKV · WebM · HLS · Local files
• Quality selection
• Subtitle support (SRT/VTT)
• Custom control builders
• Error handling
• Windows plugin integration
• Fully custom adaptive controls (No Chewie dependency)

---

Comparison With Popular Packages 🆚

Feature	adaptive_video_player	youtube_player_flutter	chewie	video_player
YouTube Support	✅	✅	❌	❌
MP4/HLS Support	✅	❌	✅	✅
Desktop Support	✅	❌	⚠️	⚠️
Unified Widget	✅	❌	❌	❌
Live Stream	✅	❌	❌	❌

---

Platform Behavior 🖥

Platform	Engine
Android / iOS	youtube_player_flutter
Windows / macOS / Linux	InAppWebView + localhost
Web	HTML iframe via package:web

Desktop uses http://localhost to bypass YouTube iframe Error 153 restriction.

---

Installation 📦

dependencies:
  adaptive_video_player: ^1.1.0

---

Example Usage 🚀

YouTube

AdaptiveVideoPlayer(
  config: VideoConfig(
    videoUrl: 'https://www.youtube.com/watch?v=vM2dC8OCZoY',
  ),
);

Direct MP4

AdaptiveVideoPlayer(
  config: VideoConfig(
    videoUrl: 'https://example.com/video.mp4',
  ),
);

Live Stream

AdaptiveVideoPlayer(
  config: VideoConfig(
    videoUrl: 'https://www.youtube.com/watch?v=LIVE_ID',
    isLive: true,
    viewerCount: "1.2K",
  ),
);

---

Roadmap (Planned) 🔮

• 🎬 Playlist Support (Coming Soon)
• 📺 Picture-in-Picture (In Progress)

---

Author 👨💻

Ahmed Mohamed Alam GitHub: https://github.com/ahmedalam782

---

License 📝

MIT License