mt_audio 0.2.0-beta.3

mt_audio: ^0.2.0-beta.3 copied to clipboard

Changed #

• Replaced MtAudioSource sealed class (MtSingleSource, MtPlaylistSource, MtLiveSource) with two explicit methods on MtAudioPlayer: setAudioItem(MtAudioItem) and setPlaylist(List<MtAudioItem>, {int initialIndex}).
• Simplified internal playback state stream and added .distinct() to prevent redundant emissions.

Fixed #

• ffRewindInterval from MtAudioPlayerConfig is now correctly forwarded to system media controls (lock screen, notification, Android Auto, CarPlay). Previously, system-level fast-forward/rewind buttons used default intervals instead of the configured value.

Breaking changes #

• Removed MtAudioSource, MtSingleSource, MtPlaylistSource, and MtLiveSource classes.
• Removed MtAudioPlayer.setSource(MtAudioSource).
• Added MtAudioPlayer.setAudioItem(MtAudioItem) -- replaces setSource(MtSingleSource(...)) and setSource(MtLiveSource(...)).
• Added MtAudioPlayer.setPlaylist(List<MtAudioItem>, {int initialIndex}) -- replaces setSource(MtPlaylistSource(...)).

Migration

// Before
await player.setSource(MtSingleSource(item: track));
await player.setSource(MtLiveSource(item: stream));
await player.setSource(MtPlaylistSource(items: tracks, initialIndex: 2));

// After
await player.setAudioItem(track);
await player.setAudioItem(stream);
await player.setPlaylist(tracks, initialIndex: 2);

Reclassified mt_audio as a beta release while testing is ongoing.

Changed #

• Updated package version to 0.2.0-beta.2.
• Updated README wording from production-ready to beta.
• Updated GitHub workflow branch references from master to main.

Breaking changes #

• None.

Initial public release of mt_audio.

Added #

• Streams-based audio player facade (MtAudioPlayer) with synchronous getters.
• Background playback support with system media controls via audio_service.
• Queue management (set source, add/insert/remove/reorder, skip, clear).
• Playback controls (play/pause/stop/seek, fast-forward/rewind).
• Playback modes (repeat, shuffle), speed control, and volume control.
• Audio session handling for interruptions and becoming-noisy events.
• Optional Android Auto integration via delegate pattern.
• Optional Apple CarPlay integration via delegate pattern and handler.
• Reusable UI widgets for controls, seek bar, queue, speed, artwork, and now-playing info.
• Example application demonstrating package setup and usage.

Breaking changes #

• None.