flutter:assets:    -assets/audios/

AssetsAudioPlayer.newPlayer().open(Audio("assets/audios/song1.mp3"),    autoStart:true,    showNotification:true,);

📥 Import

dependencies:assets_audio_player:^3.0.8

📁 Import assets files

flutter:assets:    -assets/audios/

🛠️ Getting Started

final assetsAudioPlayer=AssetsAudioPlayer();assetsAudioPlayer.open(Audio("assets/audios/song1.mp3"),);

final assetsAudioPlayer=AssetsAudioPlayer();try {await assetsAudioPlayer.open(Audio.network("http://www.mysite.com/myMp3file.mp3"),    );}catch (t) {//mp3 unreachable}

final assetsAudioPlayer=AssetsAudioPlayer();try {await assetsAudioPlayer.open(Audio.liveStream(MY_LIVESTREAM_URL),    );}catch (t) {//stream unreachable}

//create a new playerfinal assetsAudioPlayer=AssetsAudioPlayer();assetsAudioPlayer.open(Audio.file(FILE_URI),);

assetsAudioPlayer.playOrPause();assetsAudioPlayer.play();assetsAudioPlayer.pause();

assetsAudioPlayer.seek(Duration to);assetsAudioPlayer.seekBy(Duration by);

assetsAudioPlayer.forwardRewind(double speed);//if positive, forward, if negative, rewind

assetsAudioPlayer.stop();

Notifications

final audio=Audio.network("/assets/audio/country.mp3",    metas:Metas(            title:"Country",            artist:"Florent Champigny",            album:"CountryAlbum",            image:MetasImage.asset("assets/images/country.jpg"),//can be MetasImage.network          ),   );

_player.open(audio, showNotification:true)

Custom notification

By ResourceName

await _assetsAudioPlayer.open(        myAudio,        showNotification:true,        notificationSettings:NotificationSettings(            customStopIcon:AndroidResDrawable(name:"ic_stop_custom"),            customPauseIcon:AndroidResDrawable(name:"ic_pause_custom"),            customPlayIcon:AndroidResDrawable(name:"ic_play_custom"),            customPrevIcon:AndroidResDrawable(name:"ic_prev_custom"),            customNextIcon:AndroidResDrawable(name:"ic_next_custom"),        )

<?xml version="1.0" encoding="utf-8"?><resourcesxmlns:tools="http://schemas.android.com/tools"tools:keep="@drawable/ic_next_custom, @drawable/ic_prev_custom, @drawable/ic_pause_custom, @drawable/ic_play_custom, @drawable/ic_stop_custom"/>

By Manifest

<meta-dataandroid:name="assets.audio.player.notification.icon"android:resource="@drawable/ic_music_custom"/>

<meta-data    android:name="assets.audio.player.notification.icon.play"    android:resource="@drawable/ic_play_custom"/><meta-data    android:name="assets.audio.player.notification.icon.pause"    android:resource="@drawable/ic_pause_custom"/><meta-data    android:name="assets.audio.player.notification.icon.stop"    android:resource="@drawable/ic_stop_custom"/><meta-data    android:name="assets.audio.player.notification.icon.next"    android:resource="@drawable/ic_next_custom"/><meta-data    android:name="assets.audio.player.notification.icon.prev"    android:resource="@drawable/ic_prev_custom"/>

Handle notification click (android)

AssetsAudioPlayer.setupNotificationsOpenAction((notification) {//custom actionreturntrue;//true : handled, does not notify others listeners//false : enable others listeners to handle it});

AssetsAudioPlayer.addNotificationOpenAction((notification) {//custom actionreturnfalse;//true : handled, does not notify others listeners//false : enable others listeners to handle it});

Custom actions

open(AUDIO,   showNotification:true,   notificationSettings:NotificationSettings(       prevEnabled:false,//disable the previous button//and have a custom next action (will disable the default action)       customNextAction: (player) {print("next");       }   ))

Update audio's metas / notification content

audio.updateMetas(       player: _assetsAudioPlayer,//add the player if the audio is actually played       title:"My new title",       artist:"My new artist",//if I not provide a new album, it keep the old one       image:MetasImage.network(//my new image url       ),);

Bluetooth Actions

HeadPhone Strategy

assetsAudioPlayer.open(   ...  headPhoneStrategy:HeadPhoneStrategy.pauseOnUnplug,//headPhoneStrategy: HeadPhoneStrategy.none, //default//headPhoneStrategy: HeadPhoneStrategy.pauseOnUnplugPlayOnPlug,)

<uses-permissionandroid:name="android.permission.BLUETOOTH" />

⛓ Play in parallel / simultaneously

///play 3 songs in parallelAssetsAudioPlayer.newPlayer().open(Audio("assets/audios/song1.mp3"));AssetsAudioPlayer.newPlayer().open(Audio("assets/audios/song2.mp3"));//another way, with create, open, play & dispose the player on finishAssetsAudioPlayer.playAndForget(Audio("assets/audios/song3.mp3"));

final player=AssetsAudioPlayer.withId(id:"MY_UNIQUE_ID");

🗄️ Playlist

assetsAudioPlayer.open(Playlist(    audios: [Audio("assets/audios/song1.mp3"),Audio("assets/audios/song2.mp3")    ]  ),  loopMode:LoopMode.playlist//loop the full playlist);assetsAudioPlayer.next();assetsAudioPlayer.prev();assetsAudioPlayer.playlistPlayAtIndex(1);

Audio Widget

//inside a stateful widgetbool _play=false;@overrideWidgetbuild(BuildContext context) {returnAudioWidget.assets(     path:"assets/audios/country.mp3",     play: _play,     child:RaisedButton(           child:Text(               _play?"pause":"play",           ),           onPressed: () {setState(() {                 _play=!_play;               });           }      ),      onReadyToPlay: (duration) {//onReadyToPlay      },      onPositionChanged: (current, duration) {//onPositionChanged      },  );}

🎧 Listeners

🎵 Current song

//The current playing audio, filled with the total song durationassetsAudioPlayer.current//ValueObservable<PlayingAudio>//Retrieve directly the current played assetfinalPlayingAudio playing= assetsAudioPlayer.current.value;//Listen to the current playing songassetsAudioPlayer.current.listen((playingAudio){final asset= playingAudio.assetAudio;final songDuration= playingAudio.duration;})

⌛ Current song duration

//Listen to the current playing songfinal duration= assetsAudioPlayer.current.value.duration;

⏳ Current position (in seconds)

assetsAudioPlayer.currentPosition//ValueObservable<Duration>//retrieve directly the current song positionfinalDuration position= assetsAudioPlayer.currentPosition.value;returnStreamBuilder(    stream: assetsAudioPlayer.currentPosition,    builder: (context, asyncSnapshot) {finalDuration duration= asyncSnapshot.data;returnText(duration.toString());    }),

PlayerBuilder.currentPosition(     player: _assetsAudioPlayer,     builder: (context, duration) {returnText(duration.toString());     })

_assetsAudioPlayer.builderCurrentPosition(     builder: (context, duration) {returnText(duration.toString());     })

▶ IsPlaying

assetsAudioPlayer.isPlaying// ValueObservable<bool>//retrieve directly the current player statefinalbool playing= assetsAudioPlayer.isPlaying.value;//will follow the AssetsAudioPlayer playing statereturnStreamBuilder(    stream: assetsAudioPlayer.isPlaying,    builder: (context, asyncSnapshot) {finalbool isPlaying= asyncSnapshot.data;returnText(isPlaying?"Pause":"Play");    }),

PlayerBuilder.isPlaying(     player: _assetsAudioPlayer,     builder: (context, isPlaying) {returnText(isPlaying?"Pause":"Play");     })

_assetsAudioPlayer.builderIsPlaying(     builder: (context, isPlaying) {returnText(isPlaying?"Pause":"Play");     })

🔊 Volume

assetsAudioPlayer.setVolume(0.5);

_player.open(PLAYABLE, respectSilentMode:true);

returnStreamBuilder(    stream: assetsAudioPlayer.volume,    builder: (context, asyncSnapshot) {finaldouble volume= asyncSnapshot.data;returnText("volume : $volume");    }),

PlayerBuilder.volume(     player: _assetsAudioPlayer,     builder: (context, volume) {returnText("volume : $volume");     })

✋ Finished

assetsAudioPlayer.playlistAudioFinished//ValueObservable<Playing>assetsAudioPlayer.playlistAudioFinished.listen((Playing playing){})

assetsAudioPlayer.playlistFinished//ValueObservable<bool>assetsAudioPlayer.playlistFinished.listen((finished){})

🔁 Looping

finalLoopMode loopMode= assetsAudioPlayer.loop;// possible values// LoopMode.none : not looping// LoopMode.single : looping a single audio// LoopMode.playlist : looping the fyll playlistassetsAudioPlayer.setLoopMode(LoopMode.single);assetsAudioPlayer.loopMode.listen((loopMode){//listen to loop})assetsAudioPlayer.toggleLoop();//toggle the value of looping

🏃 Play Speed

assetsAudioPlayer.setPlaySpeed(1.5);assetsAudioPlayer.playSpeed.listen((playSpeed){//listen to playSpeed})//change play speed for a particular AudioAudio audio=Audio.network(    url,    playSpeed:1.5);assetsAudioPlayer.open(audio);

🎙️ Pitch

assetsAudioPlayer.setPitch(1.2);assetsAudioPlayer.pitch.listen((pitch){//listen to pitch})//change pitch for a particular AudioAudio audio=Audio.network(    url,    pitch:1.2);assetsAudioPlayer.open(audio);

Error Handling

_player.onErrorDo= (handler){  handler.player.stop();};

_player.onErrorDo= (handler){  handler.player.open(ANOTHER_AUDIO);};

_player.onErrorDo= (handler){  handler.player.open(      handler.playlist.copyWith(        startIndex: handler.playlistIndex      ),      seek: handler.currentPosition  );};

Network Policies (android/iOS/macOS)

<?xml version="1.0" encoding="utf-8"?><manifest ...>    <uses-permission android:name="android.permission.INTERNET" />    <application        ...        android:usesCleartextTraffic="true"        ...>        ...    </application></manifest>

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

<key>NSAppTransportSecurity</key><dict>    <key>NSAllowsArbitraryLoads</key>    <true/></dict><key>UIBackgroundModes</key><array>    <string>audio</string>    <string>fetch</string></array><key>com.apple.security.network.client</key><true/>

<key>com.apple.security.network.client</key><true/>

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict><key>com.apple.security.app-sandbox</key><true/><key>com.apple.security.cs.allow-jit</key><true/><key>com.apple.security.network.server</key><true/><key>com.apple.security.network.client</key><true/></dict></plist>

🎶 Musics