audio_service 0.18.15

Flutter plugin to play audio in the background while the screen is off.

0.18.15

• Add deep link support for FlutterFragmentActivity (@jan-milovanovic).
• Fix JDK 21 compile error.

0.18.14

• Support rxdart 0.28.x.

0.18.13

• Fix Android NPE in sendNotificationClicked and onConnected.
• Catch and broadcast async platform exceptions.
• Support js '>=0.6.3 <0.8.0'
• Fix setAndroidPlaybackInfo call blocking (@julianscheel).
• Pass through missing extras to playFrom.../prepareFrom... (@Ruchit2759).

0.18.12

• Fix crash with Oppo/OnePlus devices running Android 13.

0.18.11

• Support custom media controls (@defsub)
• Support fast forward, rewind and stop when targeting Android 13 (@defsub)

0.18.10

• Add support for AGP 8 (@theskyblockman).
• Update AGP to 7.3.0.
• Update minimum flutter version to 3.0.

0.18.9

• Fix cache bug in AudioServiceFragmentActivity (@Mordtimer).
• Add Android Auto manifest entry for example app (@ColinSchmale).

0.18.8

• Improve efficiency of mediaItem updates (@nt4f04uNd).

0.18.7

• Fix stopForeground bug on Android SDK < 24.
• Migrate to androidx.media 1.6.0 (@snipd-mikel)
• Propagate MediaItem extras to Android Auto (@snipd-mikel)
• Update progress bar in Android Auto (@snipd-mikel)

0.18.6

• Fix build when targeting Android 13.
• Add MediaItem.artHeaders.

0.18.5

• Add AudioServiceFragmentActivity (@deimantasa).
• Support content:// art URIs in notification on Android (@nt4f04uNd).
• Document Android foregroundServiceType.

0.18.4

• Fix Android FlutterJNI error after quick relaunch.
• Fix Android NPE when destroying additional FlutterEngines.

0.18.3

• Fix build when targeting Android 12.

0.18.2

• Guard against NPE when Android service is destroyed quickly.
• Migrate to flutter_lints.
• Queue messages from platform if init() called late.
• Fix deep linking on Android (@vishna/@ryanheise).

0.18.1

• Remove iOS notification on stop.
• Fix setSpeed action on iOS.
• Eliminate redundant notification updates on Android.
• Handle null album and artist on web (@nt4f04uNd).
• Fix multithreaded crash in notification tap (@nt4f04uNd).
• Fix regression to show album art on lock screen (@nt4f04uNd).
• Add playlist/shuffle/loop example.

0.18.0

• Use a single isolate for easier communication.
• Replace BackgroundAudioTask by AudioHandler.
• Replace AudioService.start by AudioService.init.
• Android Auto support.
• Android 11 media session resumption support.
• Federated plugin model.
• Composable audio handlers (@yringler).
• More callbacks:
  • prepareFromSearch
  • prepareFromUri
  • playFromSearch
  • playFromUri
  • addQueueItems
  • removeQueueItemAt
  • setCaptioningEnabled
  • getMediaItem
  • search
  • androidSetRemoteVolume
  • androidAdjustRemoteVolume
• More state:
  • queueTitle
  • ratingStyle
  • androidPlaybackInfo
  • customState
• Default platform implementation for Windows/Linux (@keaganhilliard)
• iOS/macOS control center bug fixes (@nt4f04uNd)
• Fix queue index out of bounds bug (@kcrebound)
• Fix bug when starting foreground service from background (@chengyuhui)
• Make MediaItem.album nullable (@letiagoalves)
• Code quality:
  • Unit tests (@suragch, @nt4f04uNd)
  • Strong-mode and pedantic lints, code consistency (@nt4f04uNd)
• Improve artUri performance on Android (@nt4f04uNd)
• Better detection of browser support (@nt4f04uNd)

0.17.1

• Support rxdart 0.27.0.

0.17.0

• Null safety.
• Change artUri type from String to Uri.

0.16.2+1

• Mention upcoming 0.18.0 release in README.

0.16.2

• Fix positionStream bug when seek is interrupted by onStop.
• Fix JS name clash for MediaMetadata.
• Update NowPlayingInfo speed correctly on iOS (@ryotayama).

0.16.1

• Fix bug in start() when using HttpOverrides.

0.16.0

• setState parameters default to previous state.
• Change updateTime from Duration to DateTime.
• Rename newStartRating to newStarRating.
• Declare type of MediaItem.extras (@hacker1024).
• Unit tests.
• Fix compile error on macOS.
• Update dependencies.

0.15.3

• Add positionStream and runningStream.
• Add androidShowNotificationBadge option (@aleexbt).

0.15.2

• Process connect/disconnect/start requests in a queue.
• Guard against null setState arguments.
• Range check in onSkipToPrevious (@snaeji).

0.15.1

• Fix loading of file:// artUri values.
• Allow booleans/doubles in MediaItems.
• Silently ignore duplicate onStop requests.

0.15.0

• Web support (@keaganhilliard)
• macOS support (@hacker1024)
• Route next/previous buttons to onClick on Android (@stonega)
• Correctly scale skip intervals for control center (@subhash279)
• Handle repeated stop/start calls more robustly.
• Fix Android 11 bugs.

0.14.1

• audio_session dependency now supports minSdkVersion 16 on Android.

0.14.0

• audio session management now handled by audio_session (see Migration Guide).
• Exceptions in background audio task are logged and forwarded to client.

0.13.0

• All BackgroundAudioTask callbacks are now async.
• Add default implementation of onSkipToNext/onSkipToPrevious.
• Bug fixes.

0.12.0

• Add setRepeatMode/setShuffleMode.
• Enable iOS Control Center buttons based on setState.
• Support seek forward/backward in iOS Control Center.
• Add default behaviour to BackgroundAudioTask.
• Bug fixes.
• Simplify example.

0.11.2

• Fix bug with album metadata on Android.

0.11.1

• Allow setting the iOS audio session category and options.
• Allow AudioServiceWidget to recognise swipe gesture on iOS.
• Check for null title and album on Android.

0.11.0

• Breaking change: onStop must await super.onStop to shutdown task.
• Fix Android memory leak.

0.10.0

• Replace androidStopOnRemoveTask with onTaskRemoved callback.
• Add onClose callback.
• Breaking change: new MediaButtonReceiver in AndroidManifest.xml.

0.9.0

• New state model: split into playing + processingState.
• androidStopForegroundOnPause ties foreground state to playing state.
• Add MediaItem.toJson/fromJson.
• Add AudioService.notificationClickEventStream (Android).
• Add AudioService.updateMediaItem.
• Add AudioService.setSpeed.
• Add PlaybackState.bufferedPosition.
• Add custom AudioService.start parameters.
• Rename replaceQueue -> updateQueue.
• Rename Android-specific start parameters with android- prefix.
• Use Duration type for all time values.
• Pass fastForward/rewind intervals through to background task.
• Allow connections from background contexts (e.g. android_alarm_manager).
• Unify iOS/Android focus APIs.
• Bug fixes and dependency updates.

0.8.0

• Allow UI to await the result of custom actions.
• Allow background to broadcast custom events to UI.
• Improve memory management for art bitmaps on Android.
• Convenience methods: replaceQueue, playMediaItem, addQueueItems.
• Bug fixes and dependency updates.

0.7.2

• Shutdown background task if task killed by IO (Android).
• Bug fixes and dependency updates.

0.7.1

• Add AudioServiceWidget to auto-manage connections.
• Allow file URIs for artUri.

0.7.0

• Support skip forward/backward in command center (iOS).
• Add 'extras' field to MediaItem.
• Artwork caching and preloading supported on Android+iOS.
• Bug fixes.

0.6.2

• Bug fixes.

0.6.1

• Option to stop service on closing task (Android).

0.6.0

• Migrated to V2 embedding API (Flutter 1.12).

0.5.7

• Destroy isolates after use.

0.5.6

• Support Flutter 1.12.

0.5.5

• Bump sdk version to 2.6.0.

0.5.4

• Fix Android memory leak.

0.5.3

• Support Queue, album art and other missing features on iOS.

0.5.2

• Update documentation and example.

0.5.1

• Playback state broadcast on connect (iOS).

0.5.0

• Partial iOS support.

0.4.2

• Option to call stopForeground on pause.

0.4.1

• Fix queue support bug

0.4.0

• Breaking change: AudioServiceBackground.run takes a single parameter.

0.3.1

• Update example to disconnect when pressing back button.

0.3.0

• Breaking change: updateTime now measured since epoch instead of boot time.

0.2.1

• Streams use RxDart BehaviorSubject.

0.2.0

• Migrate to AndroidX.

0.1.1

• Bump targetSdkVersion to 28
• Clear client-side metadata and state on stop.

0.1.0

• onClick is now always called for media button clicks.
• Option to set notifications as ongoing.

0.0.15

• Option to set subText in notification.
• Support media item ratings

0.0.14

• Can update existing media items.
• Can specify order of Android notification compact actions.
• Bug fix with connect.

0.0.13

• Option to preload artwork.
• Allow client to browse media items.

0.0.12

• More options to customise the notification content.

0.0.11

• Breaking API changes.
• Connection callbacks replaced by a streams API.
• AudioService properties for playbackState, currentMediaItem, queue.
• Option to set Android notification channel description.
• AudioService.customAction awaits completion of the action.

0.0.10

• Bug fixes with queue management.
• AudioService.start completes when the background task is ready.

0.0.9

• Support queue management.

0.0.8

• Bug fix.

0.0.7

• onMediaChanged takes MediaItem parameter.
• Support playFromMediaId, fastForward, rewind.

0.0.6

• All APIs address media items by String mediaId.

0.0.5

• Show media art in notification and lock screen.

0.0.4

• Support and example for playing TextToSpeech.
• Click notification to launch UI.
• More properties added to MediaItem.
• Minor API changes.

0.0.3

• Pause now keeps background isolate running
• Notification channel id is generated from package name
• Updated example to use audioplayer plugin
• Fixed media button handling

0.0.2

• Better connection handling.

0.0.1

• Initial release.