on_audio_query 3.0.0-beta.0

on_audio_query: ^3.0.0-beta.0 copied to clipboard

Features #

Dart

• [Updated] example.
• [Added/Fixed] documentation.

Android / iOS

• [Added] clearCachedArtworks method to clear all cached images/artworks.
• [Added] a filter to every 'query' method.
• [Added] option to sort songs using track number.
• [Added] method to get information from specifics audios.
• [Added] ArtworkFormatType.
• [Added] AudioType.
• [Added] MediaDirType.
• [Added] MediaFilter.
• [Added] MediaColumns.
• [Added] ArtworkModel.
• [Added] ObserversModel.
• [Added] observersStatus.
• [Added] observers:
  • observeSongs.
  • observeAlbums.
  • observeArtists.
  • observePlaylists.
  • observeGenres.
• [Reduced] the default artwork resolution.

Android

• [Updated] gradle.
• [Removed] Ringtones, Notification, etc.. from default 'query'.
• [Added] option to use multiple path when 'querying'.

Fixes #

Android

• Fix app crash after requestPermission.

Documentation #

• Updated README documentation.
• Updated DEPRECATED documentation.
• Updated PLATFORMS documentation.

Important Changes ⚠ #

• Now all methods will use the filter for more advanced filtering.
• Now the plugin will return a error, instead of empty list, if app doesn't have permission to read.
• Now createPlaylist will return the playlistId instead if bool.
• Now queryArtwork will return a ArtworkModel.

@Deprecated

• [queryAudiosFrom].
• [queryWithFilters].
• [queryFromFolder].
• [queryAllPath].
• [format] from [QueryArtworkWidget].
• [AudiosFromType] and [AudiosFromType]
• [format], [size] and [quality] from [queryArtwork].
• [SongModel]
  • Use [AudioModel] instead.
• [SongSortType]
  • Use [MediaColumns.Audio] instead.
• [AlbumSortType]
  • Use [MediaColumns.Album] instead.
• [ArtistSortType]
  • Use [MediaColumns.Artist] instead.
• [PlaylistSortType]
  • Use [MediaColumns.Playlist] instead.
• [GenreSortType]
  • Use [MediaColumns.Genre] instead.
• [ArtworkFormat]
  • Use [ArtworkFormatType] instead.
• [sortType], [orderType], [uriType] and [ignoreCase] from:
  • [querySongs];
  • [queryAlbums];
  • [queryArtists];
  • [queryPlaylists];
  • [queryGenres].

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.

Changes #

• [Updated] all Github 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.

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].

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 #

Android

• Now ALL methods will only "query" if has permission to READ.

Fixes #

Android

• [Fixed] no value returning when using [permissionsRequest].

Documentation #

• Updated README documentation.
• Added more documentation to Android platform.

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 #

Dart

• Added [artwork] to [PlaylistModel] as [Uint8List]
• Added [numOfTracks] to [PlaylistModel]
• Added [playlistAuthor] and [playlistDesc] parameter to [createPlaylist] (IOS only)
• Added [OnModelFormatter] extension.
  • Added [toSongModel].
  • Added [toAlbumModel].
  • Added [toPlaylistModel].
  • Added [toArtistModel].
  • Added [toGenreModel].

IOS

• Added [queryWithFilters] method.
• Added [createPlaylist] method.
• Added [queryPlaylists] method.
• Added [queryAudiosFrom] method.

Important Changes ⚠ #

Dart

• Now [dateAdded] from [PlaylistModel] return a [int].
• Now [dateModified] from [PlaylistModel] return a [int].

@Deprecated

• [queryAudiosOnly]
• [AudiosOnlyType]
• [queryAudiosBy]
• [AudiosByType]

Dev Changes #

Dart

• Added checker to all [int] from [PlaylistModel].
  • Temporary

Release #

• [2.0.0-alpha.0] release.

Features #

IOS

• Added [queryArtists] and [queryGenres].

Important Changes ⚠ #

@Deprecated

• Removed [artwork] from [ArtistModel].
• Removed [artwork] from [GenreModel].

Dev Changes #

Dart

• Added a checker to all int items from [ArtistModel].
  • Temporary
• Added a checker to all int items from [GenreModel].
  • Temporary

Features #

on_audio_query

• The plugin now supports [IOS]. (Not 100%)

IOS

• Added [querySongs] and [queryAlbums].

Dart

• Added [model] to [DeviceModel].

Changes #

Dart

• Now [sdk] are [version].
• Now [deviceType] are [type].

Important Changes ⚠ #

Dart

• Now [artwork] from [SongModel] return a [Uint8list].
• Now all [int] from [SongModel] can be [null].
• Now [artwork] from [AlbumModel] return a [Uint8list].

@Deprecated

• [numOfSongsArtists] from [AlbumModel].
• [maxyear] from [AlbumModel].
• [minyear] from [AlbumModel].
• [release] from [DeviceModel].
• [code] from [DeviceModel].
• [year] from [SongModel].
• [is_alarm] from [SongModel].
• [is_music] from [SongModel].
• [is_notification] from [SongModel].
• [is_ringtone] from [SongModel].
• [is_podcast] from [SongModel].
• [file_parent] from [SongModel].
• [firstYear] from [AlbumModel].
• [lastYear] from [AlbumModel].

Dev Changes #

Dart

• Now [queryDeviceInfo] will return Map instead of List.
• Added a checker to all int items from [SongModel].
  • Temporary.
• Added a checker to all int items from [AlbumModel].
  • Temporary.

Features #

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

Documentation #

• Updated README documentation.

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]. - #16 and #12

Documentation #

• Updated README documentation.

Changes #

Android

• Updated 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.

Features #

Dart/Android

• Changed some methods structure.
• Added [moveItemTo] method to Playlist.
• Added [Size] and [Format] parameters to [queryArtwork].
• Added [getDeviceSDK], [getDeviceRelease] and [getDeviceCode].
• Added [retryRequest] parameter to [permissionsRequest].

Dart

• Added [QueryArtworkWidget].

Fixes #

• Added parameter [AudioId] to [addToPlaylist] and [removeFromPlaylist].

Documentation #

• Updated README documentation.
• Added more comments to [Kotlin] and [Dart] code.

Changes #

• Now Playlist methods parameters request [id] instead Name.
• Now [renamePlaylist] add more information -> [Date_Modified].
• Now when [requestPermission] parameter is set to true or [permissionsRequest] method is called, both [READ] and [WRITE] is requested.

Features #

Dart/Android

• Changed some methods structure.
• Added [renamePlaylist].
• Added separate option for sortType order [ASC_OR_SMALLER] and [DESC_OR_GREATER].
• Added [permissionsStatus] and [permissionsRequest].

Documentation #

• Updated README documentation.
• Added some comments to [Kotlin] and [Dart] code.

Changes #

• Now [createPlaylist], [removePlaylist], [addToPlaylist] and [removeFromPlaylist] return bool.

Features #

Dart/Android

• Added [createPlaylist], [removePlaylist], [addToPlaylist] and [removeFromPlaylist].

Dart

• Updated the [Example] application.

Documentation #

• Updated README documentation.

Features #

Dart/Android

• Added [queryArtworks] and [queryAudiosFrom].

Fixes #

• Added a better performance for query images.

Documentation #

• Updated README documentation.

Features #

Dart/Android

• Added [queryArtists], [queryPlaylists] and [queryGenres].
• Added [ArtistSortType], [PlaylistsSortType] and [GenreSortType].

Android

• Now all methods use Kotlin Coroutines for query in background, adding a better performance.

Documentation #

• Updated README documentation.
• Updated pubspec.yaml.
• Created README translation section.
• Created README translation for pt-BR [Portuguese].

Features #

Dart/Android

• Added [querySongs], [queryAudio] and [queryAlbums].
• Added [AudioSortType] and [AlbumSortType].

Android

• Added [Optional] and [Built-in] Write and Read Storage Permission.

Documentation #

• Created a README documentation.

Features #

Dart/Android

• Created the base for the plugin.