Home

flutter_media_session Wiki

Welcome to the official documentation for flutter_media_session!

This plugin provides a robust and seamless way to integrate your Flutter application with system-level media controls across multiple platforms. Whether it's the lock screen on iOS, the notification tray on Android, or the System Media Transport Controls (SMTC) on Windows, this plugin has you covered.

---

Key Features

• Multi-Platform Support: Android, iOS, macOS, Windows, and Web.
• Modern Adapter Architecture: Out-of-the-box support for just_audio and media_kit via clean bind/unbind workflows, with easy support for custom players.
• Metadata Sync: Effortlessly display title, artist, album, and high-quality artwork.
• Playback Control: Synchronize play/pause states and seek positions.
• System Actions: Respond to hardware buttons, headsets, and system UI controls.
• Android Power User Features: Custom notification buttons and automatic audio focus handling.
• Windows Identity: Professional branding in the Windows media center.

---

Documentation Sections

Section	Description
Getting Started	Installation and initial project setup.
Usage Guide	How to manage metadata and handle playback events.
Platform Setup	Specific configuration required for each platform.
Windows Setup	Application identity configuration for Windows SMTC.
Android Custom Actions	Adding custom buttons to the Android notification.
Contributing	How to help improve this plugin.

---

Quick Links

• GitHub Repository
• Pub.dev Package
• Example Application