AudioPlayerWidget class

The main widget for the audio player. It accepts various parameters to configure the player's appearance and behavior.

Inheritance

Constructors

AudioPlayerWidget({Key? key, VoiceNotePlayerController? controller, bool autoLoad = true, bool autoPlay = false, TextDirection textDirection = TextDirection.ltr, required String? audioPath, AudioType audioType = AudioType.directFile, List<double>? audioSpeeds, double size = 56, double width = 400, Color backgroundColor = Colors.blueAccent, Color iconColor = Colors.white, TextStyle? timerTextStyle, PlayIconShapeType shapeType = PlayIconShapeType.circular, PlayerStyle playerStyle = PlayerStyle.style1, double progressBarHeight = 3.0, Color progressBarColor = Colors.blueAccent, Color progressBarBackgroundColor = Colors.grey, bool showProgressBar = true, bool showTimer = true, bool showSpeedControl = true, dynamic onError(String message)?, dynamic onPause()?, dynamic onPlay(bool isPlaying)?, dynamic onSeek(double value)?, dynamic onSpeedChange(double value)?})
Creates a new instance of the AudioPlayerWidget widget.
const

Properties

audioPath → String?
The path to the audio file (can be a URL, local path, or asset).
final
audioSpeeds → List<double>?
A list of selectable playback speeds (e.g., 0.5, 1.0, 1.5, 2.0).
final
audioType → AudioType
The source type of the audio (URL, asset, or file).
final
autoLoad → bool
Whether to automatically load the audio when the widget is initialized.
final
autoPlay → bool
Whether to automatically start playing the audio when loaded.
final
backgroundColor → Color
The background color of the play/pause button.
final
controller → VoiceNotePlayerController?
The controller for the audio player.
final
hashCode → int
The hash code for this object.
no setterinherited
iconColor → Color
The color of the play/pause icon.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
onError → dynamic Function(String message)?
Callback function triggered when an error occurs.
final
onPause → dynamic Function()?
Callback function triggered when the audio is paused.
final
onPlay → dynamic Function(bool isPlaying)?
Callback function triggered when playback starts or stops.
final
onSeek → dynamic Function(double value)?
Callback function triggered when the user seeks through the audio.
final
onSpeedChange → dynamic Function(double value)?
Callback function triggered when the playback speed changes.
final
playerStyle → PlayerStyle
The visual style to use for the player (determines layout and controls).
final
progressBarBackgroundColor → Color
The background color of the progress bar.
final
progressBarColor → Color
The color of the active progress bar.
final
progressBarHeight → double
The height of the progress bar (if shown).
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
shapeType → PlayIconShapeType
The shape of the play/pause button (e.g., circular or square).
final
showProgressBar → bool
Whether to show the progress bar.
final
showSpeedControl → bool
Whether to show the playback speed control.
final
showTimer → bool
Whether to show the current time/duration timer.
final
size → double
The size of the play/pause icon button.
final
textDirection → TextDirection
The text direction for layout (e.g., left-to-right or right-to-left).
final
timerTextStyle → TextStyle?
The text style for the timer display (if shown).
final
width → double
The overall width of the player widget.
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<AudioPlayerWidget>
Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() → List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String
Returns a one-line detailed description of the object.
inherited
toStringShort() → String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited