Note: This release has breaking changes.

• FIX: Use unique tmp location for each AudioCache (#1724). (2333cb7f)
• FIX: Race condition when playing/pausing audio (#1705). (463b2a11)
• FIX: Seek not applied in play method (#1695). (f6138fef)
• FIX: Propagate Stream Errors through the same Future (#1732). (00d041df)
• FIX: Wait for seek to complete (#1712). (fd33b1d0)
• FEAT: Support byte array and data URIs via mimeType (#1763). (eaf7ce86)
• FEAT(ios): Improved AudioContextConfig assertions, fix example (#1619). (df342c52)
• FEAT(web): Support compilation to Wasm (#1766). (1b1a0cf9)
• DOCS: Improve Docs (#1710). (4208463a)
• BREAKING REFACTOR: Remove deprecated methods (#1583). (8d0cbeda)
• BREAKING FEAT: FramePositionUpdater & TimerPositionUpdater (#1664). (1ea93536)
• BREAKING FEAT: Extend AudioContextConfig.duckAudio to AudioContextConfig.focus (#1720). (87f3cb7e)
• BREAKING FEAT(ios): Improve AudioContextIOS (#1591). (25fbec05)
• BREAKING DEPS: Update min Flutter to v3.13.0, compatibility with v3.16.8 (#1715). (e4262f4c)
• BREAKING CHORE: Upgrade to Flutter 3.13.0 (#1612). (1a3de1ac)

• FIX: Avoid decoding already encoded character in URI (#1679). (1923205c)
• FIX(android): Released wrong source in LOW_LATENCY mode (#1672). (d9c5f693)

• REFACTOR: Lint Swift (#1613). (737aa94f)
• REFACTOR: Lint Kotlin, C and C++ code (#1610). (05394668)
• FIX: Cancel onPreparedSubscription on error (#1660). (c11dbf30)
• FIX: Set playback rate only when playing (#1658). (d73c7d5c)
• FIX: Improve Error handling for Unsupported Sources (#1625). (a4d84422)
• FIX: Return null for duration and position, if not available (#1606). (2a79644a)
• FEAT(windows): Support for BytesSource on Windows (#1601). (a9e14710)
• FEAT: Allow adding custom media sources to example (#1637). (1eabe619)
• DOCS: Deploy live example app to GH pages (#1623). (fe81f3b1)

• REFACTOR(darwin): Rearrange code (#1585). (13639d1f)
• FEAT: Get current volume, balance and playbackRate (#1582). (0c2ff7b1)

Note: This release has breaking changes.

• REFACTOR(windows): simplify position and duration processing (#1553). (ca63c5a4)
• FIX(example): Use kotlin version compatible with AGP8 (#1577). (8f4b1bb0)
• FIX(linux): allow reusing event channel with same name (#1555). (5471189f)
• FEAT(android): Add support for AGP 8 in example, add compileOptions to build.gradle (#1503). (7c08e4e1)
• BREAKING FIX: Default audio output to system preferences (#1563). (381c43e3)
• BREAKING CHORE: Bump Flutter to version 3.10.x (#1529). (c1296c9b)

• REFACTOR: Adapt to flame_lint v0.2.0+2 (#1477). (e1d7fb6a)
• FIX: Timeout on setting same source twice (#1520). (5d164d1f)
• FIX: test and fix compatibility with min flutter version (#1510). (9f39e95f)
• FIX: onPrepared event to wait until player is ready / finished loading the source (#1469). (50f56365)
• FIX: rework dispose (#1480). (c64ef6d9)
• FEAT: Adapt position update interval of darwin, linux, web (#1492). (ab5bdf6a)
• DOCS: Improve docs (#1518). (4c0d5546)

• FIX: dispose player implementation (#1470). (d9026c15)

Note: This release has breaking changes.

• FIX(android): Avoid calling onDuration on position event (closes #136) (#1460). (6cfb3753)
• FEAT: replace Platform.isX with defaultTargetPlatform (#1446). (6cd5656c)
• FEAT(example): add invalid asset, small refactor, colored source buttons (#1445). (92a20fad)
• FEAT(android): add setBalance (#58) (#1444). (3b5de50e)
• FEAT: extract AudioContext from audio_context_config (#1440). (e59c3b9f)
• FEAT(ios): set player context globally on setAudioContext for iOS only (#1416). (19af364b)
• FEAT(example): update app icons (#1417). (ac35df89)
• FEAT: AudioPool (moved and improved from flame_audio) (#1403). (ab15cb02)
• DOCS: update AudioCache explanation, migration guide, replace package READMEs (#1457). (b8eb1974)
• DOCS: update example app and screenshots (#1419). (c48eaf38)
• BREAKING REFACTOR: prevent from confusing and conflicting class names (#1465). (7cdb8586)
• BREAKING REFACTOR: improve separation of global audioplayer interface (#1443). (c0b3f85c)
• BREAKING FEAT: event channel (#1352). (c9fd6a76)
• BREAKING FEAT: expose classes of package audioplayers_platform_interface (#1442). (a6f89be1)

Migration instructions #

Before	After
deprecated AudioPlayer.global.changeLogLevel(LogLevel.info)	AudioLogger.logLevel = AudioLogLevel.info
deprecated AudioPlayer.global.logLevel	AudioLogger.logLevel
deprecated AudioPlayer.global.log()	AudioLogger.log() or AudioLogger.error()
deprecated AudioPlayer.global.info()	AudioLogger.log()
deprecated AudioPlayer.global.error()	AudioLogger.error()
GlobalPlatformInterface	GlobalAudioScope
deprecated AudioPlayer.global.setGlobalAudioContext()	AudioPlayer.global.setAudioContext()
ForPlayer<>	removed

• Update a dependency to the latest release.

Note: This release has breaking changes.

• FEAT: add and remove player actions (#1394). (f06cab91)
• FEAT: example improvements (#1392). (002e2fc9)
• BREAKING REFACTOR: rename logger_platform_interface.dart to global_platform_interface.dart (#1385). (6e837c1c)
• BREAKING FEAT: configurable SoundPool and AudioManager.mode (#1388). (5697f187)

Note: This release has breaking changes.

• BREAKING FIX: remove unused defaultToSpeaker in AudioContextIOS and replace with AVAudioSessionOptions.defaultToSpeaker (#1374). (d844ef9d)

Note: This release has breaking changes.

• FIX: Duration precision on Windows (#1342). (3cda1a65)
• FIX: infinity / nan on getDuration (#1298). (a4474dcf)
• FEAT: upgrade flutter to v3.0.0 and dart 2.17 to support "Super initializers" (#1355). (4af417b4)
• FEAT: local test server (#1354). (06be429a)
• FEAT: get current source (#1350). (7a10be38)
• FEAT: log path and url of sources (#1334). (8a13f96d)
• FEAT: add setBalance (#58) (#1282). (782fc9df)
• DOCS: Fix repos and homepages on pubspecs (#1349). (0bdde4d9)
• BREAKING FIX: Cache should take key to be properly cleared (#1347). (1a410bba)

• FIX: infinity / nan on getDuration (#1298). (a4474dcf)

• FIX: player state not being updated to completed (#1257). (70a37afb)
• FIX: lowLatency bugs (closes #1176, closes #1193, closes #1165) (#1272). (541578cc)
• FIX: ios/macos no longer start audio when calling only setSourceUrl (#1206). (c0e97f04)
• FEAT: improve example (#1267). (a8154da1)
• FEAT: Platform integration tests 🤖 (#1128). (b0c84aab)
• DOCS: Remove 11-month old outdated doc file (#1180). (bae43cb1)

• FIX: Make sure onComplete resets the position even when not looping (#1175). (6e6005ac)

• FEAT: Upgrade flame lint dependency (#1132). (0d6dae3e)

• Update a dependency to the latest release.

• FIX: Volume and rate can be set before audio playing on iOS (#1113). (eca1dd0e)
• FEAT: Linux platform support (closes #798) (#1110). (74616c54)

• Bump "audioplayers" to 1.0.0-rc.2.

• First release after federation

Changelog #

• Fix bug with inversed log levels

• Fix enum parsing on release mode on android

• Fix android/kotlin build for old projects
• Add method to clearNotification
• Add currentPosition stream on web
• Add seek on web
• Add a proper Logger
• Make setPlaybackRate signature consistent
• Fix fatal exception on Android API < 21 in WrappedMediaPlayer.kt setAttributes
• Add clearNotification method

• Add missing awaits for AudioCache
• Fix Kotlin Core version to v1.6.0
• Fix iOS warning
• Fix README link to audio_cache.md to work on pub
• Fix documentation referencing old class
• Add web support for audioPlayer.getCurrentPosition
• Add web support for audioPlayer.getDuration
• Add web support for audioPlayer.setPlaybackRate
• Fix local file playback in LOW_LATENCY mode on Android

• Refactor Notifications code (small breaking changes)
• AudioCache for web
• Fixing basic features for Android lower than API 23
• Fixing error after playing music several times with AudioCache
• Re-organize folder and file structure on the Dart side (project layout)
• Re-organize folders into a mono-repo
• Fix several bugs

• Fix Float vs Double mixup on Swift that prevent non-integer values for volume/playback
• Fix open sink issue / resource leak

• Changing Android minSdk verison to 16
• Improve build processes and other small bug fixes

• Fix kotlin config issue for some apps
• Fix warning from pub
• Fix iOS lock screen
• Fix setUrl method

• Stable null-safety release
• Removed all the @deprecated code blocks

• Fix java.lang.UnsupportedOperationException on read-only kotlin map

• Backport some code to old kt (for now)

• Fix macos compilation issue
• Fix android for non-kotlin projects

• Use better algorithm for speed modulation on iOS
• Extracted and refactored all the notifications code onto the new file
• Add more checks and make sure notifcations code is not ran when it shouldn't
• Add more useful info to the troubleshoot guide

• Swift conversion of the darwin code

• Overhauled our contributing guidelines
• Improve docs around player state
• Update dependencies versions

• Fix Exception thrown when calling audioPlayer.dispose
• Fix bug with AudioCache crash on iOS

• Implemented stream routing for iOS
• Call release on dispose
• Fix iOS build
• Breaking change audio cache prefix in order to allow override 'assets'

audioplayers 0.15.1 #

• Fix web for release mode

audioplayers 0.15.0 #

• Improve loop/readme for web support
• Audio cache support for web
• Re-adding partial web support

audioplayers 0.14.3 #

• Add next and previous command for ios

audioplayers 0.14.2 #

• Fix pubspec problem because of web file

audioplayers 0.14.1 #

• Adding linter, tests and flutter_driver integration tests to a CI (github actions)
• Minor fixes to the APIs and documentation
• Fix restarting the playback of a failed AVPlayerItem
• Prevent exceptions when null values are passed to notifications center
• Prevent crash by checking if headlessServiceInitialized before invoking onNotificationBackgroundPlayerStateChanged

audioplayers 0.14.0 #

• Adding macOs support
• ios:fix lack of seek completion handle
• ios Delay start fixed

audioplayers 0.13.7 #

• Bump dependencies, improve gitignore
• Upgrade pubspec pattern

audioplayers 0.13.6 #

• added setPlaybackRate feature for Android
• Automatic detect address is local or remote (thanks, @saeed-golshan)

audioplayers 0.13.5 #

• fixed crash on iOS when startHeadlessService() wasn't called on AudioPlayer (by @JesseScott)

audioplayers 0.13.4 #

• fixing missing cleanup on hot restart on Android
• Background notification updates on iOS

audioplayers 0.13.3 #

• audio notification area fixes
• fix when other apps are playing sounds
• fix android race condition
• Support for registering plugin in background enviroment
• fix typos and docs

audioplayers 0.13.2 #

• Handling plugin dealloc and onTimeInterval crashs (thanks @chedechao111)
• Audio position update when the audio is paused (thanks @bjornjacobs)

audioplayers 0.13.1 #

• Added stayAwake feature (thanks, @danielR2001)
• Improved dispose method (thanks, @hugocbpassos)
• Added getCurrentPosition (thanks, @hariom08)
• Some bug fixes and small changes

audioplayers 0.13.0 #

• Call onDurationChanged after setUrl() to be consistent with ios version (thanks @subhash279)
• Adding getDuration feature iOS/Android (thanks @alecorsino)

audioplayers 0.12.1 #

• Fixes bug where the stream handlers were not called due to exception on the handler
• Proper error message when errors in the dart handler occurs

audioplayers 0.12.0 #

• Update to path_provider 1.1.0
• Upgrade to Swift 5 in example project setting (thanks @jerryzhoujw)

audioplayers 0.11.0 #

• Breaking change. Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires any Android apps using this plugin to also migrate if they're using the original support library.

audioplayers 0.10.1 #

• Seek and play now works with milliseconds instead of second (thanks, @catoldcui and @erickzanardo)

audioplayers 0.10.0 #

• Added a low latency api for android (thanks, @feroult)

audioplayers 0.9.0 #

• Improved callbacks using Streams to allow for multiple subscibers (thanks, @LucasCLuk)
• Update uuid version to 2.0.0 (thanks, @BeMacized)

audioplayers 0.8.2 #

• Update path_provider version (thanks, @apiraino)

audioplayers 0.8.1 #

• Fix for duration when playing a stream
• Added respectSilence flag in audioplayers, or isNotification for play methos in audio_cache False by default, to use player for local notification. Silent when device is in silent mode.

audioplayers 0.8.0 #

• Allow setting seek position in play function (thanks @rob-patchett)
• Get duration from the underlaying asset instead of from AVPlayerItem (thanks @andressade)
• Adding player state (thanks @renancaraujo)
• Set the audio session to active (thanks @benwicks)
• Delay seek operations on Android until player is ready (thanks @jeffmikels)

audioplayers 0.7.8 #

• Fix bug regarding name clash with other plugins (thanks @imtaehyun)

audioplayers 0.7.7 #

• Fix bug when using nested files with audio cache (thanks @hotstu for reporting and @eclewlow for fixing)

audioplayers 0.7.6 #

• Fix the nefarious bug of 'sound only playing through headphones' (thanks so much, @tsun424)

audioplayers 0.7.5 #

• Fix SDK constraint for Dart 2.1 (thanks @snoofer and @sroddy)

audioplayers 0.7.4 #

• Some more fixes to work without errors with Dart 2 stronger types

audioplayers 0.7.3 #

• Support Android SDK 16-20 (thanks, @sroddy)
• Avoid restarting a looping player if is stopped (thanks, @sroddy)

audioplayers 0.7.2 #

• Bug fixes for iOS

audioplayers 0.7.1 #

• Formatting

audioplayers 0.7.0 #

• Improved lifecycle handling for android
• Big performance boots
• Allows for finer control of releasing (with setReleaseMode, setUrl, resume, release)
• Allows for setting the volume at any time (with setVolume)
• Added LOOP as a ReleaseMode options, making it significantly faster
• Some other refactorings

audioplayers 0.6.0 #

• Major Refactoring!
• Renaming everything to audioplayers (mind the s)
• Better logging
• Added AudioCache (imported from Flame)
• Adding tests!
• Adding better example
• Greatly improving README
• Lots of other minor tweaks

audioplayers 0.5.2 #

• don't call the onClomplete hook when you manually stop the audio

audioplayers 0.5.1 #

• fix for dart 2 (thanks to @efortuna)

audioplayers 0.5.0 #

• improves Android performance by not calling prepare on the main thread

audioplayers 0.4.1 #

• fix seek for iOS

audioplayers 0.4.0 #

• volume controls

audioplayers 0.3.0 #

• working on iOS (thanks @feroult <3)

audioplayers 0.2.0 #

• adding disable log option

audioplayers 0.1.0 #

• support for multiple audios simultaneously

• support for local files

• update to the current Plugin API
• move to https://github.com/rxlabz/audioplayer

Separated handlers for position, duration, completion and errors

• setDurationHandler(TimeChangeHandler handler)

• setPositionHandler(TimeChangeHandler handler)

• setCompletionHandler(VoidCallback callback)

• setErrorHandler(ErrorHandler handler)

• new typedef

typedef void TimeChangeHandler(Duration duration);
typedef void ErrorHandler(String message);

• first POC :
  • methods : play, pause, stop
  • a globalHandler for position, duration, completion and errors