Skip to content
pubscout

audio_session

0.2.4, released 5 months ago by ryanheise.com

Manages iOS audio session categories, Android audio attributes, and audio focus/ducking.

$ flutter pub add audio_session
Source repository

What it does

This plugin configures the operating system's audio session settings for your app. It handles audio interruptions like phone calls and manages audio focus, mixing, and ducking behavior across platforms.

AI-written summary of version 0.2.4, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You are building a music, podcast, or voice app that needs to handle audio focus and interruptions correctly.
  • You need to configure low-level iOS AVAudioSession or Android AudioManager attributes.
  • You are writing a custom audio plugin and need to coordinate audio focus and interruptions.

Skip it when

  • Your app does not play or record any audio.
  • You only need high-level media playback without worrying about system audio sessions or phone call interruptions.

Strengths

  • Provides a unified API for managing audio sessions on both iOS and Android.
  • Exposes useful streams for audio interruptions, becoming noisy events, and device changes.
  • Essential companion for coordinating multiple audio plugins smoothly.

Weaknesses

  • Requires platform-specific configuration and understanding of native audio session concepts.
  • iOS microphone usage requires specific Info.plist settings and build options.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
2

If using microphone APIs on iOS, add NSMicrophoneUsageDescription to Info.plist and configure AUDIO_SESSION_MICROPHONE=1 in your Podfile or environment.

final session = await AudioSession.instance;
await session.configure(AudioSessionConfiguration.music());

session.interruptionEventStream.listen((event) {
  if (event.begin) {
    // Handle interruption begin
  } else {
    // Handle interruption end
  }
});

Alternatives

Packages that do the same job and could replace audio_session.

Works with

Packages commonly used together with audio_session: ones it builds on, ones built on it, and its own family.