🎵 MediaPlayer Package – Play, Record & Enjoy Audio/Video #

A simple Flutter media player package with a user-friendly interface and powerful features.

The MediaPlayer package is a versatile, all-in-one multimedia solution that provides seamless audio playback, video playback, and audio recording capabilities for Flutter applications. Whether you want to play music, stream videos, or record audio, this package makes it effortless.

🚀 Key Features #

🎵 Audio Player #

• ✅ Supports local and online MP3, AAC, WAV, FLAC, and more.
• ✅ Background playback for uninterrupted listening.
• ✅ Displays album artwork and metadata (title, artist, album).
• ✅ Provides play, pause, seek, and stop controls.
• ✅ Loop and shuffle support for playlists.
• ✅ Handles both network streaming and local file playback.

🎬 Video Player #

• ✅ Supports MP4, AVI, MKV, WEBM, and other popular formats.
• ✅ Full-screen mode with adjustable playback speed.
• ✅ Online video streaming support.
• ✅ Gesture controls (seek, volume, brightness adjustments).
• ✅ Subtitles and captions support.

🎤 Audio Recorder #

• ✅ Record audio in WAV formats with high quality.
• ✅ Pause/resume recording functionality.
• ✅ Saves recordings to local storage for easy access.
• ✅ Built-in waveform visualization for recording progress.

📦 Installation #

To use this package, add the following to your pubspec.yaml:

dependencies:
  media_player: latest_version

Then, fetch the package by running:

flutter pub get

🎯 Usage #

Audio Player #

     onPressed: () {
                NavigationRoutes.openAudioPlayer(
                    title: 'Audio Header',
                    items: [
                  AudioMetadata(
                      album: 'Test Album',
                      title: 'Song Maan1',
                      artwork:
                          'https://cover.djpunjab.is/57180/300x700/hawa-de-bulle-ep-sharry-maan.webp',
                      audioLink:
                          'https://p320.djpunjab.is/data/48/57180/306937/Hawa%20De%20Bulle%20-%20Sharry%20Maan.mp3')
                ]);
              },

Audio Recorder #

onPressed: () async {
                  var file = await NavigationRoutes.openAudioRecorder(
                      maxDuration: Duration(seconds: 10),
                      title: "Recorder",
                      description: "");
                  if (kDebugMode) {
                    print('File Path : ${file?.path}');
                  }
                }

  onPressed: () async {
                  NavigationRoutes.openVideoPlayer(
                      videoPath:
                          'https://www.w3schools.com/tags/mov_bbb.mp4',
                      title: 'Video');
                }

_buildPlayerController #

  Widget _buildPlayerController(
      {required String title, required VoidCallback onPressed}) {
    return ElevatedButton(
      onPressed: () {
        onPressed.call();
      },
      child: Text(title),
    );
  }

📌 Features:

• Start, pause, and stop recording.
• Specify a maximum recording duration.
• Customize the title and description.
• Save recordings in formats (WAV).
• Retrieve the recorded file upon completion.

📜 Example Usage:

Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            _buildPlayerController(
              title: "Play Music",
              onPressed: () {
                NavigationRoutes.openAudioPlayer(
                    title: 'Audio Header',
                    items: [
                  AudioMetadata(
                      album: 'Test Album',
                      title: 'Song Maan1',
                      artwork:
                          'https://cover.djpunjab.is/57180/300x700/hawa-de-bulle-ep-sharry-maan.webp',
                      audioLink:
                          'https://p320.djpunjab.is/data/48/57180/306937/Hawa%20De%20Bulle%20-%20Sharry%20Maan.mp3')
                ]);
              },
            ),
            const SizedBox(height: 50),
            _buildPlayerController(
                onPressed: () async {
                  var file = await NavigationRoutes.openAudioRecorder(
                      maxDuration: Duration(seconds: 10),
                      title: "Recorder",
                      description: "");
                  if (kDebugMode) {
                    print('File Path : ${file?.path}');
                  }
                },
                title: 'Audio Decoder'),
            const SizedBox(height: 50),
            _buildPlayerController(
                onPressed: () async {
                  NavigationRoutes.openVideoPlayer(
                      videoPath:
                          'https://www.sample-videos.com/video321/mp4/360/big_buck_bunny_360p_10mb.mp4',
                      title: 'Video');
                },
                title: 'Video Player'),
          ],
        ),
      )}
      

Light Theme Handler

    primaryColor: Colors.green,
        textTheme: TextTheme(
          headlineSmall: TextStyle(
              fontSize: 18, fontWeight: FontWeight.w600, color: Colors.black),
          bodyLarge: TextStyle(
              fontFamily: FontFamily.poppins, // Font family used
              color:
                  Colors.black, // Text color for better visibility in dark mode
              fontSize: 14),

          titleLarge: TextStyle(
              fontFamily: FontFamily.poppins, // Font family used
              color:
                  Colors.black, // Text color for better visibility in dark mode
              fontSize: 14),
          headlineMedium: TextStyle(
              fontFamily: FontFamily.poppins, // Font family used
              color:
                  Colors.black, // Text color for better visibility in dark mode
              fontSize: 14),
          // Medium display text style configuration
          displayMedium: TextStyle(
            fontFamily: FontFamily.poppins, // Font family used
            color: Colors.black, // Text color
            fontSize: 14,
          ),
        ),

Dark Theme Handler

       primaryColor: Colors.white70,
          textTheme: TextTheme(
            headlineSmall: TextStyle(
                fontSize: 18, fontWeight: FontWeight.w600, color: Colors.white),
            bodyLarge: TextStyle(
                fontFamily: FontFamily.poppins, // Font family used
                color: Colors
                    .white, // Text color for better visibility in dark mode
                fontSize: 14),
            titleLarge: TextStyle(
                fontFamily: FontFamily.poppins, // Font family used
                color: Colors
                    .white, // Text color for better visibility in dark mode
                fontSize: 14),

            // Medium display text style
            headlineMedium: TextStyle(
              fontFamily: FontFamily.poppins, // Font family used
              color:
                  Colors.white, // Text color for better visibility in dark mode
              fontSize: 14,
            ),

🎥 Video Player Module #

📄 Description #

The Video Player Module allows you to open a video player screen with specified video details. It initializes the VideoController if it is not already registered and navigates to the VideoPlayerScreen with the provided video information.

📜 License #

This project is licensed under the MIT License.