on_audio_query

Update pubspec

Features

• Added support to Dart 3.

Fixes

• Fixed broken pubspec links. - #115

iOS

• Fixed wrong name of podspec in iOS. - #116

Changes

• Updated dart-analyzer to support cache
• Updated README

Features

• Added showDetailedLog.

Changes

• Moved android and ios into separated folders.
• Replaced /details with /src.

⚠ Important Changes

Android

• Updated kotlin version from 1.4.32 to 1.6.10. - #110
• Updated kotlin coroutines version from 1.5.2-native-mt to 1.6.4.

Features

• Added [LogType].
• Added [LogConfig].
• Added [PermissionController] (Native)
• Added [PluginProvider] (Native)
• Added [setLogConfig] method.
• Added [checkAndRequest] method.
• Added [controller] to [QueryArtworkWidget].
• Added [retryRequest] param to [checkAndRequest] and [permissionsRequest].

Fixes

Android

• Fixed crash after request permission. - #68
• Fixed quality always being sent as 200 using [queryArtwork].

Changes

• Updated example.
• Renamed natives files/folders.
• Reduced the default artwork resolution (from 100 to 50).
• Updated [QueryArtworkWidget] params.
• Updated quality assert on [QueryArtworkWidget].

⚠ Important Changes

• Updated application permission check.
  • If application doesn't have permission to access the library, will throw a PlatformException.
• Updated quality param from [QueryArtworkWidget].
  • This param cannot be defined as null anymore and, by default, will be set to 50.
• Updated minimum supported Dart version.
  • Increase minimum version from 2.12 to 2.17.

Features

• Added [LogType].
• Added [LogConfig].
• Added [PermissionController] (Native)
• Added [PluginProvider] (Native)
• Added [setLogConfig] method.
• Added [checkAndRequest] method.
• Added [controller] to [QueryArtworkWidget].
• Added [retryRequest] param to [checkAndRequest] and [permissionsRequest].

Fixes

Android

• Fixed crash after request permission. - #68
• Fixed quality always being sent as 200 using [queryArtwork].

Changes

• Updated example.
• Renamed natives files/folders.
• Reduced the default artwork resolution (from 100 to 50).
• Updated [QueryArtworkWidget] params.
• Updated quality assert on [QueryArtworkWidget].

⚠ Important Changes

• Updated application permission check.
  • If application doesn't have permission to access the library, will throw a PlatformException.
• Updated quality param from [QueryArtworkWidget].
  • This param cannot be defined as null anymore and, by default, will be set to 50.
• Updated minimum supported Dart version.
  • Increase minimum version from 2.12 to 2.17.

[2.6.2] - [03.03.2023]

Fixes

Android

• [Fixed] incompatibility with Android 13. - #91 - Thanks @ruchit-7span

Fixes

Android

• Fixed incompatibility with Android 13. - #91 - Thanks @ruchit-7span

Fixes

Android

• [Fixed] incompatibility with Flutter 3. - #78

Fixes

Android

• Fixed incompatibility with Flutter 3. - #78

Features

• [Added] [scanMedia] method that will scan the given path and update the [Android] MediaStore.

Fixes

• [Fixed] media showing when calling [querySongs] even after deleting with [dart:io]. - #67

Changes

• [Updated] some required packages.

Documentation

• Updated README documentation.
• Updated DEPRECATED documentation.
• Updated PLATFORMS documentation.
• Updated some broken links.

Features

• Added [scanMedia] method that will scan the given path and update the [Android] MediaStore.

Fixes

• Fixed media showing when calling [querySongs] even after deleting with [dart:io]. - #67

Changes

• Updated some required packages.

Documentation

• Updated README documentation.
• Updated DEPRECATED documentation.
• Updated PLATFORMS documentation.
• Updated some broken links.

Fixes

IOS

• Fixed song/artist/album from Apple Music returning when 'querying' - #61
• Fixed wrong artistId returning from [AlbumModel] - #60

Documentation

• Updated README documentation.

Changes

• [Updated] all Github links.

Changes

• Updated all Github links.

Fixes

Android

• Fixed wrong value returning from: - #56
  • [is_music].
  • [is_alarm].
  • [is_notification].
  • [is_ringtone].
  • [is_podcast].
  • [is_audiobook].

Documentation

• Updated README documentation.

Fixes

Dart

• Fixed wrong value returning from [artistId] when using [AlbumModel]. - #54

Android

• Fixed missing songs from [queryAudiosFrom] when using GENRE. - #46

Documentation

• Updated README documentation.

⚠ Important Changes

Dart

• Now [artistId] from [AlbumModel] return a [int].

Release

• [2.5.0] release.

Features

Dart

• Added errorBuilder and frameBuilder to [QueryArtworkWidget].

Fixes

Web

• Fixed empty result when using [querySongs].
• Fixed error when decoding some images.

See all development changes:

• 2.5.0-alpha.0

Features

All platforms

• Added artwork to genres. - #41
• Added sortType, orderType and ignoreCase to [queryAudiosFrom].

Android

• Re-Added path parameter to [querySongs]. - #48

Web

• Added path parameter to [querySongs].

Fixes

Android

• Fixed empty Uint8List when using [queryArtwork] on Android 7. - #47
• Fixed null albumId when using Android 9 or below. - #53

Documentation

• Updated README documentation. New [queryAudiosFrom] section.
• Updated DEPRECATED documentation.

Changes

• Downgraded Kotlin and Gradle version. - #51

⚠ Important Changes

@Deprecated

• [albumId] from [AlbumModel].
  • Use [id] instead.

Fixes

IOS

• Fixed no artwork returning from [queryArtwork] when using ArtworkType.ALBUM. - #45

Documentation

• Updated README documentation.

Fixes

Dart

• Fixed wrong type of numOfSongs from [SongModel]. - #39

IOS

• Fixed wrong filter configuration when using [queryWithFilters].
• Fixed crash when using any 'query' method with a null sortType. - #43
• Fixed error with wrong [MPMediaQuery] filter. - #38

Documentation

• Updated README documentation.

Features

Android

• Added a better 'search' method to [queryWithFilters], now the query uses 'contains' when 'querying'. - #35

Fixes

IOS

• Fixed error with wrong [MPMediaQuery] type and wrong value from [jpegData]. - #37

Documentation

• Updated broken README links. - #36

Documentation

• Updated README documentation.

Features

Android/Web

• Added [ignoreCase] to:
  • [querySongs].
  • [queryAlbums].
  • [queryArtists].
  • [queryPlaylists].
  • [queryGenres].

Fixes

Android

• Fixed error when trying to build using Android. - #32 & #33
• Fixed error related to android song projection. - #31
• Fixed 'bug' when using SongSortType.TITLE. This is now a 'feature' and can be controlled using [ignoreCase]. - #29

Documentation

• Updated README documentation.

Changes

Android

• Updated [Kotlin] and [Dependencies] versions.
• Moved from [JCenter] to [MavenCentral].

Features

Android/IOS/Web

• Added [numOfSongs] to [PlaylistModel] and [GenreModel].
• Added Playlist and Artist to ArtworkType.

Android/IOS

• Added quality to queryArtwork.

Android

• Added [isAudioBook], [Genre] and [GenreId] to [SongModel].
• Re-Added to [SongModel]:
  • [isAlarm].
  • [isMusic].
  • [isNotification].
  • [isPodcast].
  • [isRingtone].

Fixes

Android

• Fixed wrong value returning from [id] when using [ArtistModel].
• Fixed wrong value returning from [id] when using [GenreModel].
• Fixed no value returning from [queryAudiosFrom] when using ARTIST_ID.

Documentation

• Updated README documentation.
• Updated OnAudioQuery and OnAudioQueryExample documentation to support new [Flutter 2.5].

Changes

• [Changed] wrong name DATA_ADDED to DATE_ADDED for both [SongSortType] and [PlaylistSortType]. - #27

⚠ Important Changes

Dart

• The parameter args from [queryWithFilters] is no longer required.

@Deprecated

• [DEFAULT] from [SongSortType].
• [DEFAULT] from [PlaylistSortType].
• [DEFAULT] from [ArtistSortType].
• [DEFAULT] from [AlbumSortType].
• [DEFAULT] from [GenreSortType].
• [ARTIST_KEY] from [ArtistSortType].
• [ARTIST_NAME] from [ArtistSortType].
• [ALBUM_NAME] from [AlbumSortType].
• [GENRE_NAME] from [GenreSortType].
• [DATA_ADDED] from [SongSortType].
• [DATA_ADDED] from [PlaylistSortType].

<!-- Deleted files: [audios_only_type.dart] and [songs_by_type.dart] --> <!-- Changed files: [queryArtworkWidget.dart] to [query_artwork_widget.dart] -->

Features

IOS

• Added a filter to avoid cloud audios/songs.

Fixes

IOS

• Fixed wrong value returning from [permissionsStatus]. - #24

Documentation

• Updated README documentation.

Fixes

Android

• Fixed duplicate media from [queryWithFilters].
• Fixed crash when calling [queryWithFilters]. - #23
• Fixed null artwork returning from [queryArtwork] on Android 11/R. - #21

Documentation

• Updated README documentation.
• Updated pubspec documentation.

Fixes

Android

• Fixed error when using [removeFromPlaylist]. - #22

Documentation

• Updated README documentation.
• Updated [OnAudioQueryExample] to support [Web] platform.

Features

on_audio_query

• The plugin now supports [Web].
• The plugin now utilize [Platform interface] package.

Web

• Added:
  • [querySongs].
  • [queryAlbums].
  • [queryArtists].
  • [queryGenres].
  • [queryAudiosFrom].
  • [queryWithFilters].
  • [queryArtwork].
  • [queryDeviceInfo].

Documentation

• Updated on_audio_query documentation.
• Updated README documentation.
• Updated PLATFORMS documentation.
• Added documentation to Web platform.

Release

• [2.0.0] release.

See all development changes:

• 2.0.0-beta.3
• 2.0.0-beta.2
• 2.0.0-beta.1
• 2.0.0-beta.0
• 2.0.0-alpha.1
• 2.0.0-alpha.0
• 2.0.0-dev.1
• 2.0.0-dev.0

Features

IOS

• Now ALL methods will only "query" if has permission to Library.
• Added [addToPlaylist].

Dart

• Added [author] and [desc] arguments to [createPlaylist]. (IOS only)

Fixes

IOS

• Fixed crash when using [queryArtwork].
• Fixed wrong [id] value returning from [PlaylistModel].

Documentation

• Updated README documentation.

Features

IOS

• Added [queryArtwork].

Fixes

Android

• Fixed error when building to [Android].

IOS

• Fixed wrong [duration], [dateAdded] and [bookmark] values returning from [SongModel].

Documentation

• Updated on_audio_query documentation.
• Updated README documentation.
• Updated DEPRECATED documentation.
• Added documentation to IOS platform.

⚠ Important Changes

@Deprecated

• [artwork] from [QueryArtworkWidget].
• [deviceSDK] from [QueryArtworkWidget].
• [requestPermission] from [QueryArtworkWidget].

Features

on_audio_query

• Added a DART ANALYZER to PULL_REQUEST and PUSH.

Documentation

• Updated on_audio_query documentation.
• Updated README documentation.
• Updated DEPRECATED documentation.
• Created PLATFORMS file.

⚠ Important Changes

Dart

• Now ALL methods has Named Optional arguments.
• Changed [queryArtworks] to [queryArtwork].

@Deprecated

• [requestPermission] argument from ALL methods.
• [queryAudios].
• [artwork] from [SongModel].
• [path] from [querySongs].

Features

• Added [path] parameter to [querySongs] and [queryAudio].
• Added [getMap] to:
  • [SongModel].
  • [AlbumModel].
  • [ArtistModel].
  • [GenreModel].
  • [PlaylistModel].
  • [DeviceModel].

Documentation

• Updated README documentation.

Fixes

Android

• Fixed [cursor] problem when using [AudiosFromType.GENRE_NAME] or [AudiosFromType.GENRE_ID] on [queryAudiosFrom]. - #16 and #12

Documentation

• Updated README documentation.

Changes

Android

• Updated some [Kotlin] dependencies.

Fixes

Android

• Fixed [Kotlin] issue when installing the plugin.

Documentation

• Updated README documentation.

Changes

Android

• Downgraded some [Kotlin] dependencies.

Fixes

Android

• Fixed [cursor] problem when using [AudiosFromType.GENRE_NAME] or [AudiosFromType.GENRE_ID] on [queryAudiosFrom].

Documentation

• Updated README documentation.

Features

Dart/Android

• Added [uri] to [SongModel]. - Added #10

Fixes

Android

• Fixed java.lang.Integer cannot be cast to java.lang.Long from [queryArtworks]. - #11

Documentation

• Updated README documentation.
• Created DEPRECATED file/history.

Changes

Dart

• Changed from [deviceInfo] to [deviceSDK] on [QueryArtworkWidget].

⚠ Important Changes

Dart

• Deprecated [deviceInfo] from [QueryArtworkWidget].

Features

Dart/Android

• Added [queryDeviceInfo].
• Added [dateModified] to [SongModel].
• Added [querySongsBy] and [SongsByType].

Fixes

Android

• Fixed incompatibility with [permission_handler]. - #3 - Thanks @mvanbeusekom

Dart

• Fixed wrong name. From [dataAdded] to [dateAdded].

Documentation

• Updated README documentation.
• Updated [OnAudioQueryExample] to add new [queryDeviceInfo] and [QueryArtworkWidget] methods.

Changes

Android

• Updated some [Kotlin] dependencies.
• Changed some [Kotlin] methods.

⚠ Important Changes

Dart

• Now [getDeviceSDK], [getDeviceRelease] and [getDeviceCode] are part of [queryDeviceInfo].
• Now [QueryArtworkWidget] support Android above and below 29/Q/10.
• Now [size], [albumId], [artistId], [dataAdded], [dataModified], [duration], [track] and [year] from [SongModel] will return [int].

Features

Dart

• Added [artworkClipBehavior], [keepOldArtwork], [repeat] and [scale] to [QueryArtworkWidget].
• Added comments to [QueryArtworkWidget].

Fixes

Android

• Fixed Now [queryArtworks] will return null. - #6

Documentation

• Updated README documentation.

⚠ Important Changes

Dart

• Now [queryArtworks] return [Uint8List?].

Features

Dart/Android

• Added [queryFromFolder].
• Added [queryAllPath].
• Added [_display_name_wo_ext] ([displayName] without extension) to [SongModel]. - Added #5
• Added [file_extension] (Only file extension) to [SongModel].
• Added [file_parent] (All the path before file) to [SongModel].
• Added [Genre] to [queryAudiosFrom].
• Added [ALBUM_ID], [ARTIST_ID] and [PLAYLIST_ID] to [AudiosFromType]. - Added #2

Documentation

• Updated README documentation.

Changes

Dart/Android

• Now [queryAudiosFrom] supports [name] and [id].
• Now [albumId] from [AlbumModel] return a [int].

Android

• Now all [Kotlin] checks will throw a [Exception] if value don't exist.
• Updated some [Kotlin] dependencies.

⚠ Important Changes

Dart/Android

• Changed [ALBUM], [ARTIST] and [PLAYLIST] to [ALBUM_NAME], [ARTIST_NAME] and [PLAYLIST_NAME] in [AudiosFromType].

Fixes

Android

• Fixed [queryArtwork] returning null album image in Android 11. - #1

Documentation

• Updated README documentation.

Changes

Android

• Removed unnecessary code from [WithFiltersType].
• Updated some [Kotlin] dependencies.

Features

Dart/Android

• Added [queryAudiosOnly].
• Added [queryWithFilters].
• Added [AudiosOnlyType] and [WithFiltersType].
• Added [SongsArgs], [AlbumsArgs], [PlaylistsArgs], [ArtistsArgs], [GenresArgs].
• Added [EXTERNAL] and [INTERNAL] parameters for some query methods.

Documentation

• Updated README documentation.

Changes

Dart/Android

• Now [querySongs], [queryAlbums], [queryArtists], [queryPlaylists] and [queryGenres] have [UriType] as parameter.

Android

• Updated some [Kotlin] dependencies.

⚠ Important Changes

Dart

• Migrate to null safety.

Fixes

Dart

• Fixed flutter example.

Android

• Fixed [audiosFromPlaylist] [Now this method is part of queryAudiosFrom]
• Fixed "count(*)" error from [addToPlaylist]. [Permission bug on Android 10 still happening]

Documentation

• Updated README documentation.

Changes

Dart

• Now [Id] in models return [int] instead [String].

⚠ Important Changes

Dart/Android

• Removed [ALBUM_KEY], [ARTIST_KEY] from all query audio methods.

Android

• Moved [audiosFromPlaylist] to [queryAudiosFrom].

Release

• [on_audio_query] release.