audio_video_player

Bug Fixes and Improvements

• Fixed a bug where AudioController would not play after a seek operation.
• Added Exception Handling for cases where AudioController is not initialized. AudioController now throws an exception if it is used before initialization.

Bug Fixes

• Fixed Android package directories to match pubspec declarations
• Updated LICENSE copyright year to 2024
• Migrated deprecated just_audio APIs: replaced ConcatenatingAudioSource with AudioPlayer.setAudioSources/addAudioSources
• Updated just_audio dependency to ^0.10.5
• Corrected API documentation examples with proper method names (seek() → seekTo(), setShuffleMode() → setShuffleEnabled())
• Enhanced .gitignore with comprehensive patterns for Flutter plugins
• Fixed SDK constraints and dependency versions for better compatibility

Initial pre-release of audio_video_player.

Audio

• AudioController — full audio playback powered by just_audio.
  • Supports single tracks (URISource, FileSource, AssetSource), playlists (PlaylistSource), and albums (AlbumSource).
  • Background playback and lock-screen / notification controls via just_audio_background.
  • Reactive streams: playerStateStream, positionStream, durationStream, bufferedPositionStream, volumeStream, speedStream, queueStream, currentItemStream, currentIndexStream, repeatModeStream, shuffleEnabledStream.
  • Queue management: add(), addAll(), removeAt(), move(), clear().
  • Shuffle (setShuffleMode), repeat (setRepeatMode — off / one / all), speed (setSpeed), volume (setVolume).
• SleepTimer — countdown timer with per-second remainingStream; automatically pauses AudioController on expiry.
• EqualizerController — Android-only per-band EQ via just_audio's AndroidEqualizer.
  • getBands(), setBandGain(index, db), reset(), setEnabled(bool).
• AudioSessionManager — configures the system audio session via audio_session.

Video

• VideoController — single video item playback using video_player + Chewie UI.
  • Handles https://, file://, and asset:// URI schemes.
  • setFit(VideoFit) — runtime video scaling (contain, cover, fill, fitWidth, fitHeight, scaleDown).
  • setOrientation(VideoOrientation) — lock device orientation (auto, portrait, landscape).
  • Subtitle support: inline SRT/WebVTT via AVMediaItem.subtitleContent, or remote/local file via AVMediaItem.subtitleUri.
  • Exposes chewieController for direct Chewie widget integration.
• VideoPlaylistController — ordered video queue with auto-advance.
  • start(), skipToNext(), skipToPrevious(), skipToIndex().
  • add(item) / remove(itemId) for runtime queue editing.
  • Fit and orientation settings persist across track changes.
  • currentControllerStream for reactive UI updates.
• PipController — native Picture-in-Picture.
  • isPipAvailable(), enterPip(), exitPip().
  • Android: Activity.enterPictureInPictureMode().
  • iOS: AVPictureInPictureController.
• SubtitleController — parses SRT and WebVTT, provides currentCueStream.

Downloads

• DownloadManager — offline downloads via background_downloader.
  • download(item) returns a Stream<DownloadProgress> (progress, status, completion).
  • cancel(itemId), deleteDownload(itemId).
  • isDownloaded(item), getDownloadedItems().
  • Files stored at <appDocuments>/audio_video_player/downloads/.

Cast

• CastController — platform bridge for AirPlay (iOS) and Chromecast (Android stub).
  • showAirPlayRoutePicker() — iOS system route picker.
  • discoverDevices(), connect(device), cast(uri), disconnect() — Chromecast flow (requires Google Cast SDK in host app).

Models

• AVMediaItem — unified media descriptor for audio and video; supports HTTP headers, extras, and subtitle metadata.
• Playlist — immutable ordered list of AVMediaItems with add, remove, reorder helpers.
• Album — Playlist with artist and year fields.
• MediaSource — sealed class hierarchy: URISource, FileSource, AssetSource, PlaylistSource, AlbumSource.
• AVPlayerState — idle | loading | ready | playing | paused | completed | error.
• RepeatMode — off | one | all.
• AVMediaType — audio | video.