Advanced Video Player #

Un reproductor de video avanzado para Flutter con controles modernos, diseño atractivo y funcionalidades completas de streaming y compartir pantalla.

✨ Características Principales #

🎬 Reproductor de Video Avanzado #

• Soporte Multi-fuente: URLs de red, assets locales y streams
• Controles Intuitivos: Play/Pause, retroceder, avanzar y pantalla completa
• Barra de Progreso Interactiva: Navegación precisa por el video
• Indicadores de Tiempo: Tiempo actual y duración total
• Estados Manejados: Carga, error, reproducción y finalización

🎨 Diseño y UX #

• UI Moderna: Diseño atractivo con gradientes y animaciones suaves
• Controles Automáticos: Aparecen y desaparecen inteligentemente
• Personalización Completa: Colores, duración de salto y más
• Responsivo: Optimizado para web, móvil y tablet

📱 Funcionalidades Avanzadas #

• Picture-in-Picture (PiP): Reproducción en ventana flotante
• Screen Sharing: Compartir video a Chromecast y dispositivos compatibles
• AirPlay: Soporte nativo para AirPlay en iOS
• Google Cast: Integración completa con Google Cast

🚀 Instalación #

Agrega esta dependencia a tu archivo pubspec.yaml:

dependencies:
  advanced_video_player: ^0.0.1

Luego ejecuta:

flutter pub get

📋 Requisitos #

• Flutter: >= 1.17.0
• Dart: >= 3.4.4
• Android: API 21+ (Android 5.0+)
• iOS: 11.0+

📦 Dependencias Incluidas #

El paquete incluye automáticamente:

• video_player: ^2.8.1 - Reproductor de video base
• url_launcher: ^6.2.2 - Apertura de URLs externas

⚙️ Configuración Requerida #

⚠️ Importante: Para usar todas las funcionalidades del reproductor, necesitas configurar tu proyecto Flutter con los permisos y configuraciones necesarias.

📋 Configuraciones Mínimas Requeridas #

Android

• Permisos de red en AndroidManifest.xml
• Soporte para Picture-in-Picture en la actividad principal
• Dependencias de Google Cast en build.gradle

iOS

• Modos de fondo para PiP y audio en Info.plist
• Orientaciones soportadas para pantalla completa
• Configuración de red para AirPlay

📖 Documentación de Configuración #

Para ver las configuraciones detalladas paso a paso, consulta:

• Guía de Configuración Android
• Guía de Configuración iOS

🚨 Solución de Problemas Comunes #

Android

• Error de permisos: Verifica que todos los permisos estén en AndroidManifest.xml
• Problemas de PiP: Asegúrate de que supportsPictureInPicture="true"
• Google Cast no funciona: Verifica las dependencias en build.gradle

iOS

• PiP no funciona: Verifica UIBackgroundModes en Info.plist
• AirPlay no aparece: Asegúrate de tener audio en UIBackgroundModes
• Orientación incorrecta: Verifica UISupportedInterfaceOrientations

Uso Básico #

import 'package:advanced_video_player/advanced_video_player.dart';

AdvancedVideoPlayer(
  videoSource: 'https://example.com/video.mp4',
  onVideoEnd: () {
    print('Video terminado');
  },
  onError: (error) {
    print('Error: $error');
  },
)

📋 Parámetros de Configuración #

🎯 Ejemplos de Uso #

Uso Básico #

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

class VideoPlayerPage extends StatelessWidget {
  const VideoPlayerPage({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Mi Reproductor')),
      body: Center(
        child: Container(
          constraints: const BoxConstraints(
            maxWidth: 800,
            maxHeight: 450,
          ),
          child: AdvancedVideoPlayer(
            videoSource: 'https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4',
            onVideoEnd: () {
              ScaffoldMessenger.of(context).showSnackBar(
                const SnackBar(content: Text('¡Video terminado!')),
              );
            },
            onError: (error) {
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(content: Text('Error: $error')),
              );
            },
            primaryColor: Colors.blue,
            secondaryColor: Colors.purple,
            skipDuration: 15,
          ),
        ),
      ),
    );
  }
}

Uso Avanzado con Todas las Funcionalidades #

AdvancedVideoPlayer(
  videoSource: 'https://example.com/video.mp4',
  isAsset: false,
  onVideoEnd: () => print('Video terminado'),
  onError: (error) => print('Error: $error'),
  skipDuration: 30,
  
  // Funcionalidades avanzadas
  enablePictureInPicture: true,
  enableScreenSharing: true,
  enableAirPlay: true,
  
  // Metadatos para compartir
  videoTitle: 'Mi Video Favorito',
  videoDescription: 'Un video increíble compartido desde mi app',
  
  // Personalización visual
  primaryColor: Colors.deepPurple,
  secondaryColor: Colors.orange,
)

Video Local (Asset) #

AdvancedVideoPlayer(
  videoSource: 'assets/videos/mi_video.mp4',
  isAsset: true,
  videoTitle: 'Video Local',
  enablePictureInPicture: false, // PiP puede no funcionar con assets
)

Configuración Mínima para Streaming #

AdvancedVideoPlayer(
  videoSource: 'https://stream.example.com/live.m3u8',
  enableScreenSharing: true,
  enableAirPlay: true,
  videoTitle: 'Stream en Vivo',
)

🎮 Controles Disponibles #

Controles Básicos #

• ▶️ Play/Pause: Botón central para reproducir o pausar
• ⏪ Retroceder: Retrocede X segundos (configurable con skipDuration)
• ⏩ Avanzar: Avanza X segundos (configurable con skipDuration)
• ⛶ Pantalla Completa: Alterna entre modo normal y pantalla completa

Controles Avanzados #

• 🖼️ Picture-in-Picture: Reproduce el video en una ventana flotante
• 📺 Screen Sharing: Comparte el video a Chromecast y dispositivos compatibles
• 📱 AirPlay: Transmite el video a dispositivos Apple (solo iOS)

Funcionalidades Automáticas #

• 👁️ Controles Inteligentes: Aparecen y desaparecen automáticamente
• ⏰ Indicadores de Tiempo: Muestra tiempo actual y duración total
• 🔄 Estados Manejados: Carga, error, reproducción y finalización
• 📱 Responsivo: Se adapta automáticamente al tamaño de pantalla

🎨 Personalización #

Colores Personalizados #

AdvancedVideoPlayer(
  videoSource: 'your_video_url',
  primaryColor: Colors.red,
  secondaryColor: Colors.orange,
)

Duración de Salto Personalizada #

AdvancedVideoPlayer(
  videoSource: 'your_video_url',
  skipDuration: 30, // 30 segundos
)

Video Local (Asset) #

AdvancedVideoPlayer(
  videoSource: 'assets/videos/my_video.mp4',
  isAsset: true,
)

🚀 Funcionalidades Avanzadas #

Picture-in-Picture (PiP) #

El reproductor soporta Picture-in-Picture nativo en ambas plataformas:

AdvancedVideoPlayer(
  videoSource: 'your_video_url',
  enablePictureInPicture: true, // Habilitado por defecto
)

Requisitos:

• Android: API 24+ (Android 7.0+)
• iOS: iOS 14.0+

Screen Sharing / Google Cast #

Comparte videos a dispositivos Chromecast y compatibles:

AdvancedVideoPlayer(
  videoSource: 'your_video_url',
  enableScreenSharing: true, // Habilitado por defecto
  videoTitle: 'Mi Video',
  videoDescription: 'Descripción del video',
)

Características:

• Descubrimiento automático de dispositivos
• Soporte para múltiples tipos de dispositivos
• Reconexión automática

AirPlay (iOS) #

Transmite videos a dispositivos Apple:

AdvancedVideoPlayer(
  videoSource: 'your_video_url',
  enableAirPlay: true, // Habilitado por defecto en iOS
)

Requisitos:

• iOS: iOS 11.0+
• Dispositivos Apple compatibles (Apple TV, AirPlay speakers, etc.)

🧪 Ejecutar el Ejemplo #

Para ver el reproductor en acción:

cd example
flutter pub get
flutter run

Plataformas Soportadas #

• ✅ Android (API 21+)
• ✅ iOS (11.0+)

🤝 Contribuir #

Las contribuciones son bienvenidas! Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Guías de Contribución #

• Sigue las convenciones de código de Flutter
• Añade tests para nuevas funcionalidades
• Actualiza la documentación cuando sea necesario
• Verifica que funcione en ambas plataformas

📄 Licencia #

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

📝 Changelog #

0.0.1 #

• ✨ Versión inicial
• 🎬 Reproductor de video básico con controles modernos
• 🌐 Soporte para URLs de red y assets locales
• 🎨 UI personalizable con gradientes
• ⚡ Manejo de estados (carga, error, finalización)
• 🖼️ Picture-in-Picture nativo (Android/iOS)
• 📺 Screen Sharing con Google Cast
• 📱 Soporte para AirPlay (iOS)
• 🎮 Controles avanzados y personalizables

🆘 Soporte #

Si encuentras algún problema o tienes preguntas:

1. Revisa la sección de Solución de Problemas
2. Busca en los Issues existentes
3. Crea un nuevo issue con detalles del problema
4. Incluye logs y configuración de tu dispositivo