JustAudioPlayer class
JustAudio implementation of the AudioPlayerInterface. Note: This is a basic implementation. For production use, consider using AudioPlayersPlayer instead as it has better platform support.
- Implemented types
Properties
-
audioInterruptionStream
→ Stream<
AudioInterruptionType> -
Stream of audio session interruptions.
no setteroverride
-
bufferedPositionStream
→ Stream<
Duration> -
Stream of buffered position updates.
no setteroverride
-
cacheStateStream
→ Stream<
AudioCacheState> -
Stream of cache state changes.
no setteroverride
- config → AudioPlayerConfig
-
Audio player configuration.
final
- currentBufferedPosition → Duration
-
Current buffered position.
no setteroverride
- currentCacheState → AudioCacheState
-
Current cache state.
no setteroverride
- currentDuration → Duration
-
Total duration of the current audio track.
no setteroverride
- currentLoadingState → AudioLoadingState
-
Current loading state.
no setteroverride
- currentPlaybackState → PlaybackState
-
Current playback state.
no setteroverride
- currentPlaylist → Playlist?
-
Current playlist.
no setteroverride
- currentPosition → Duration
-
Current position in the audio track.
no setteroverride
- currentRepeatMode → RepeatMode
-
Current repeat mode.
no setteroverride
- currentShuffleMode → ShuffleMode
-
Current shuffle mode.
no setteroverride
- currentSpeed → double
-
Current playback speed (0.5 to 2.0 typically).
no setteroverride
- currentTrack → AudioTrack?
-
Current audio track being played.
no setteroverride
-
currentTrackStream
→ Stream<
AudioTrack?> -
Stream of current track changes.
no setteroverride
- currentVolume → double
-
Current volume level (0.0 to 1.0).
no setteroverride
-
durationStream
→ Stream<
Duration> -
Stream of duration updates.
no setteroverride
- hashCode → int
-
The hash code for this object.
no setterinherited
- isInitialized → bool
-
Whether the player is initialized.
no setteroverride
-
loadingStateStream
→ Stream<
AudioLoadingState> -
Stream of loading state changes.
no setteroverride
-
playbackStateStream
→ Stream<
PlaybackState> -
Stream of playback state changes.
no setteroverride
- playerId → String?
-
Optional player ID for multi-player scenarios.
final
- playerType → AudioPlayerType
-
Audio player type identifier.
no setteroverride
-
playlistStream
→ Stream<
Playlist?> -
Stream of playlist changes.
no setteroverride
-
positionStream
→ Stream<
Duration> -
Stream of current position updates.
no setteroverride
-
repeatModeStream
→ Stream<
RepeatMode> -
Stream of repeat mode changes.
no setteroverride
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
shuffleModeStream
→ Stream<
ShuffleMode> -
Stream of shuffle mode changes.
no setteroverride
-
speedStream
→ Stream<
double> -
Stream of playback speed changes.
no setteroverride
- supportsAudioEffects → bool
-
Whether the player supports audio effects/equalizer.
no setteroverride
- supportsBackgroundPlayback → bool
-
Whether the player supports background playback.
no setteroverride
- supportsCrossfade → bool
-
Whether the player supports crossfade.
no setteroverride
- supportsGaplessPlayback → bool
-
Whether the player supports gapless playback.
no setteroverride
- supportsPitchAdjustment → bool
-
Whether the player supports pitch adjustment.
no setteroverride
- supportsSpeedAdjustment → bool
-
Whether the player supports playback speed adjustment.
no setteroverride
- supportsVisualization → bool
-
Whether the player supports audio visualization data.
no setteroverride
-
volumeStream
→ Stream<
double> -
Stream of volume changes.
no setteroverride
Methods
-
activateAudioSession(
) → Future< void> -
Activates the audio session for playback.
override
-
addTracksToPlaylist(
List< AudioTrack> tracks, {int? index}) → Future<void> -
Adds multiple tracks to the current playlist.
override
-
addTrackToPlaylist(
AudioTrack track, {int? index}) → Future< void> -
Adds a track to the current playlist.
override
-
cacheTrack(
AudioTrack track) → Future< void> -
Caches an audio track for offline playback.
override
-
cacheTracks(
List< AudioTrack> tracks) → Future<void> -
Caches multiple audio tracks for offline playback.
override
-
clearCache(
) → Future< void> -
Clears all cached audio tracks.
override
-
clearPlaylist(
) → Future< void> -
Clears the current playlist.
override
-
deactivateAudioSession(
) → Future< void> -
Deactivates the audio session.
override
-
dispose(
) → Future< void> -
Disposes of the audio player and releases all resources.
override
-
initialize(
AudioPlayerConfig config) → Future< void> -
Initializes the audio player with the given configuration.
override
-
initializeServices(
{PlaylistService? playlistService, BaseCacheManagerInterface? cacheManager}) → Future< void> - Initialize with services (separate method for factory use).
-
loadPlaylist(
Playlist playlist, {int startIndex = 0}) → Future< void> -
Loads a playlist and optionally starts playing from a specific index.
override
-
loadTrack(
AudioTrack track) → Future< void> -
Loads and plays a single audio track.
override
-
moveTrackInPlaylist(
int fromIndex, int toIndex) → Future< void> -
Moves a track within the playlist from one index to another.
override
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
pause(
) → Future< void> -
Pauses the current audio track.
override
-
play(
) → Future< void> -
Plays the current audio track.
override
-
preloadTrack(
AudioTrack track) → Future< void> -
Preloads a track for faster playback later.
override
-
preloadTracks(
List< AudioTrack> tracks) → Future<void> -
Preloads multiple tracks for faster playback later.
override
-
removeTrackFromPlaylist(
int index) → Future< void> -
Removes a track from the current playlist by index.
override
-
seek(
Duration position) → Future< void> -
Seeks to the specified position in the current audio track.
override
-
setPitch(
double pitch) → Future< void> -
Sets the pitch adjustment (if supported).
override
-
setRepeatMode(
RepeatMode mode) → Future< void> -
Sets the repeat mode.
override
-
setShuffleMode(
ShuffleMode mode) → Future< void> -
Sets the shuffle mode.
override
-
setSpeed(
double speed) → Future< void> -
Sets the playback speed (typically 0.5 to 2.0).
override
-
setVolume(
double volume) → Future< void> -
Sets the volume level (0.0 to 1.0).
override
-
skipToIndex(
int index) → Future< void> -
Skips to a specific track index in the playlist.
override
-
skipToNext(
) → Future< void> -
Moves to the next track in the playlist.
override
-
skipToPrevious(
) → Future< void> -
Moves to the previous track in the playlist.
override
-
stop(
) → Future< void> -
Stops the current audio track and resets position to beginning.
override
-
toString(
) → String -
A string representation of this object.
inherited
-
updateConfiguration(
AudioPlayerConfig config) → Future< void> -
Updates the player configuration.
override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
create(
{required AudioPlayerConfig config, String? playerId, PlaylistService? playlistService, BaseCacheManagerInterface? cacheManager}) → Future< JustAudioPlayer> - Factory constructor that creates and initializes a JustAudio player instance.