Struct Player 

pub struct Player { /* private fields */ }

The player controller. Owns the audio pipeline and processes commands.

Implementations

impl Player

pub fn new() -> Self

pub fn shared_state(&self) -> Arc<SharedPlayerState>

Get a clone of the shared state for UI reads.

pub fn timeline(&self) -> Arc<PlaybackTimeline>

Get the playback timeline for UI reads.

pub fn viz_buffer(&self) -> Arc<VizBuffer>

Get the visualization buffer for the TUI.

pub fn viz_snapshot(&self) -> Arc<VizSnapshot>

Get the shared analysis snapshot for the TUI. The analysis thread writes here; the UI thread reads a clone each frame.

pub fn undo_stack(&self) -> &UndoStack

Access undo stack (for tests and UI state queries).

pub fn set_output_device(&mut self, name: String)

Switch the output device. Persists to config and restarts the engine on the current track if playing.

pub fn clear_output_device(&mut self)

Clear the configured output device, reverting to system default.

pub fn output_device_name(&self) -> Option<&str>

Get the current output device name (if configured).

pub fn command_sender(&self) -> Sender<PlayerCommand>

Get a command sender for the UI layer.

pub fn play(&mut self, id: QueueItemId)

Play a specific item in the playlist by ID. Sets cursor, starts playback if Ready or streaming-ready, otherwise waits for TrackReady.

pub fn seek(&mut self, position_ms: u64)

Seek within the current track. Clamps to just before the end to avoid accidentally skipping. Preserves pause state.

pub fn next_track(&mut self)

Skip to next track in playlist.

pub fn prev_track(&mut self)

Go back to previous track.

pub fn pause(&mut self)

Pause playback.

pub fn resume(&mut self)

Resume playback.

pub fn stop(&mut self)

Stop playback and clear playlist.

pub fn remove_from_playlist(&mut self, id: QueueItemId)

Remove a track from the playlist. If it was the cursor, skip to next.

pub fn track_ready(&mut self, id: QueueItemId)

A download finished — if cursor is waiting on this item, start playback. If already streaming this item, trigger progressive metadata enhancement.

pub fn track_stream_ready(&mut self, id: QueueItemId)

Called when enough data has been buffered for streaming playback. If the cursor is waiting on this track and nothing is playing, start streaming.

pub fn update_playback_state(&self)

Poll the timeline and update shared state with current track/position. Called from the command loop on each tick.

pub fn process_command(&mut self, cmd: PlayerCommand)

Process a single command.

pub fn run(&mut self)

Run the command loop. Blocks until the sender is dropped.

pub fn spawn() -> (Arc<SharedPlayerState>, Arc<PlaybackTimeline>, Arc<VizSnapshot>, Sender<PlayerCommand>)

Spawn the player on a background thread, returning the shared state, timeline, visualization snapshot, and command sender.

Trait Implementations

impl Default for Player

fn default() -> Self

Returns the “default value” for a type.