audio_session
0.2.4, released 5 months ago by ryanheise.com
Manages iOS audio session categories, Android audio attributes, and audio focus/ducking.
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.
- ffmpeg_kit_flutter_new_audio
Run FFmpeg and FFprobe commands from Dart with prebuilt audio codecs for multiple platforms.
79Compare - kplayer
A cross-platform audio player wrapper supporting assets, network, files, and bytes.
47Compare - audiofileplayer
A Flutter plugin for audio playback.
30Compare
Works with
Packages commonly used together with audio_session: ones it builds on, ones built on it, and its own family.
- rxdartaudio_session depends on itImplementation of the ReactiveX API for asynchronous programming leveraging native Dart Streams.
- audio_service_platform_interfaceSame familyPlatform interface for the audio_service plugin
- just_audioBuilt on audio_sessionFeature‑rich audio player for Flutter supporting gapless playlists and multiple sources
- audio_serviceBuilt on audio_sessionFlutter plugin for background audio playback with media controls.
- just_audio_backgroundBuilt on audio_sessionAdds background playback and media controls to a just_audio player
- gravix_rtcBuilt on audio_sessionReal-time video and audio rooms for Flutter on Gravix Cloud.