Struct Player 

pub struct Player {
    pub info: Info,
    pub finished_tracks: Arc<Mutex<Vec<i32>>>,
    pub ts: Arc<Mutex<f64>>,
    /* private fields */
}

Primary playback controller.

Player owns the playback threads, buffering state, and runtime settings such as volume and reverb configuration.

Fields

info: Info

finished_tracks: Arc<Mutex<Vec<i32>>>

ts: Arc<Mutex<f64>>

Implementations

impl Player

pub fn new(file_path: &String) -> Self

Create a new player for a single container path.

pub fn new_from_file_paths(file_paths: &Vec<Vec<String>>) -> Self

Create a new player for a set of standalone file paths.

pub fn new_from_path_or_paths( path: Option<&String>, paths: Option<&Vec<Vec<String>>>, ) -> Self

Create a player from either a container path or standalone file paths.

pub fn set_impulse_response_spec(&mut self, spec: ImpulseResponseSpec)

Override the impulse response used for convolution reverb.

pub fn set_impulse_response_from_string(&mut self, value: &str)

Parse and apply an impulse response spec string.

pub fn set_impulse_response_tail_db(&mut self, tail_db: f32)

Override the impulse response tail trim (dB).

pub fn set_reverb_enabled(&self, enabled: bool)

Enable or disable convolution reverb.

pub fn set_reverb_mix(&self, dry_wet: f32)

Set the reverb wet/dry mix (clamped to [0.0, 1.0]).

pub fn get_reverb_settings(&self) -> ReverbSettings

Retrieve the current reverb settings snapshot.

pub fn get_reverb_metrics(&self) -> ReverbMetrics

Retrieve the latest reverb performance metrics.

pub fn debug_playback_state(&self) -> (bool, PlayerState, bool)

Debug helper returning thread alive, state, and audio heard flags.

pub fn debug_buffering_done(&self) -> bool

Debug helper indicating whether buffering has completed.

pub fn debug_timing_ms(&self) -> (u64, u64)

Debug helper returning internal timing markers in milliseconds.

pub fn debug_sink_state(&self) -> (bool, bool, usize)

Debug helper returning sink paused/empty flags and queued length.

pub fn set_start_buffer_ms(&self, start_buffer_ms: f32)

Configure the minimum buffered audio (ms) before playback starts.

pub fn set_track_eos_ms(&self, track_eos_ms: f32)

Configure heuristic end-of-track threshold for containers (ms).

pub fn play_at(&mut self, ts: f64)

Start playback from a specific timestamp (seconds).

pub fn play(&mut self)

Start playback from the current timestamp.

pub fn pause(&self)

Pause playback.

pub fn resume(&self)

Resume playback if paused.

pub fn kill_current(&self)

Stop the current playback thread without changing state.

pub fn stop(&self)

Stop playback and reset timing state.

pub fn is_playing(&self) -> bool

Return true if playback is currently active.

pub fn is_paused(&self) -> bool

Return true if playback is currently paused.

pub fn get_time(&self) -> f64

Get the current playback time in seconds.

pub fn is_finished(&self) -> bool

Return true if playback has reached the end.

pub fn sleep_until_end(&self)

Block the current thread until playback finishes.

pub fn get_duration(&self) -> f64

Get the total duration (seconds) of the active selection.

pub fn seek(&mut self, ts: f64)

Seek to the given timestamp (seconds).

pub fn refresh_tracks(&mut self)

Refresh active track selections from the underlying container.

pub fn shuffle(&mut self)

Shuffle track selections and restart playback.

pub fn set_volume(&mut self, new_volume: f32)

Set the playback volume (0.0-1.0).

pub fn get_volume(&self) -> f32

Get the current playback volume.

pub fn get_ids(&self) -> Vec<String>

Get the track identifiers used for display.

pub fn set_reporting( &mut self, reporting: Arc<Mutex<dyn Fn(Report) + Send>>, reporting_interval: Duration, )

Enable periodic reporting of playback status for UI consumers.

Trait Implementations

impl Clone for Player

fn clone(&self) -> Player

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.