just_audio/README.md

just_audio

A Flutter plugin to play audio from URLs, files, assets and DASH/HLS streams. This plugin can be used with audio_service to play audio in the background and control playback from the lock screen, Android notifications, the iOS Control Center, and headset buttons.

Features

Feature	Android	iOS	Web
read from URL	✅	✅	✅
read from file	✅	✅
read from asset	✅	✅
DASH	✅	(untested)	(untested)
HLS	✅	(untested)	(untested)
play/pause/stop/seek	✅	✅	✅
set volume	✅	(untested)	(untested)
set speed	✅	(untested)	(untested)
custom actions	✅	(untested)	(untested)
clip audio	✅		✅
dispose	✅	✅	✅

This plugin has been tested on Android and Web, and is being made available for testing on iOS. Please consider reporting any bugs you encounter here or submitting pull requests here.

Example

Initialisation:

final player = AudioPlayer();
var duration = await player.setUrl('https://foo.com/bar.mp3');

Standard controls:

player.play();
await player.seek(Duration(seconds: 10));
await player.pause();
await player.stop();

Clipping audio:

await player.setClip(start: Duration(seconds: 10), end: Duration(seconds: 20));
await player.play(); // Waits for playback to finish

Release resources:

await player.dispose();

Connecting to HTTP URLS

If you wish to connect to HTTP URLS, some additional platform-specific configuration is required.

iOS

Add the following to your Info.plist file:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <key>NSAllowsArbitraryLoadsForMedia</key>
    <true/>
</dict>

Android

Add the following attribute to the application element of your AndroidManifest.xml file:

    <application ... android:usesCleartextTraffic="true">

Todo

• FLAC support
• Gapless playback