flutter_mpmediaplayer 1.0.0

A plugin to interface with MPMediaPlayer on iOS/iPadOS.

1.0.0

Rewrite of the plugin on modern Flutter tooling. The method names and model classes are unchanged, but the requirements and some signatures are not.

BREAKING

• Minimum iOS version is now 15.0, up from 9.0.
• Minimum Flutter version is now 3.44.0, up from 3.10.0. That is where Swift Package Manager became the default for iOS.
• searchArtists, searchPlaylists, and getPlaylistSongs now take named parameters, matching searchSongs and searchAlbums. getPlaylistSongs also renames its first parameter to playlistId.
• List results are now unmodifiable.

Fixed

• Requesting a page past the end of the results crashed the app. It now returns an empty list.
• getAlbum and getArtist crashed on an unknown id. They now throw a PlatformException with code NOT_FOUND, or BAD_ID for a malformed id.
• getPlaylistSongs sent the playlist id under the wrong argument key.
• searchArtists and searchPlaylists passed a null value into the media query predicate.

Changed

• Platform communication now uses Pigeon. Results no longer travel as JSON strings, and artwork no longer travels as base64. This cuts the encoding work on both sides.
• Media library queries now run off the platform thread, so a large library no longer blocks the UI.
• query is now optional on searchArtists and searchPlaylists, matching searchSongs and searchAlbums. Omitting it returns every artist or playlist in the library.
• The iOS side ships as a Swift Package, and still supports CocoaPods.
• Added a privacy manifest (PrivacyInfo.xcprivacy).

0.3.0

• Added albumArtist field to Song and PlayedSong.
• Updated to Flutter 3.10
• BREAKING: Removed unnamed constructors from model classes. These were never used in internal code and should never have been used in external code.

0.2.0

BREAKING: getRecentTracks() is now a paged request.

0.1.2

Fixed PlayedSong missing playbackDuration and artwork.

0.1.1

Updated image sizes.

0.1.0

Added methods for searching and getting detailed entities.

0.0.2

• Added authorizationStatus getter.

0.0.1

• Initial release with support for fetching recent tracks.