Struct Player 

pub struct Player { /* private fields */ }

Audio playback engine with queue and controls

Implementations

impl Player

pub async fn new(client: Arc<MonoClient>) -> Arc<Self>

Create a new Player. Spawns a dedicated audio thread and background watchers.

pub async fn play_track(&self, id: u64, quality: &str) -> Result<(), String>

Play a track immediately, stopping whatever is currently playing.

pub async fn pause(&self)

Pause playback

pub async fn resume(&self)

Resume playback

pub async fn stop(&self)

Stop playback and clear current track

pub async fn next(&self) -> Result<(), String>

Skip to next track in queue

pub async fn previous(&self) -> Result<(), String>

Go to previous track (from history), or restart current if >5s in

pub async fn set_volume(&self, level: f32)

Set volume (0.0–1.0)

pub async fn set_preamp(&self, level: f32)

Set pre-amp gain (0.0–4.0, where >1.0 boosts)

pub async fn queue_add(&self, id: u64, quality: &str) -> Result<(), String>

Add a track to the end of the queue. Auto-starts if idle.

pub async fn queue_album( &self, album_id: u64, quality: &str, ) -> Result<Vec<QueuedTrack>, String>

Add all tracks from an album to the queue. Auto-starts if idle.

pub async fn queue_batch( &self, ids: &[u64], quality: &str, ) -> Result<Vec<QueuedTrack>, String>

Add multiple tracks to the queue at once. Auto-starts if idle.

pub async fn queue_clear(&self)

Clear the queue (does not stop current track)

pub async fn queue_get(&self) -> (Option<QueuedTrack>, Vec<QueuedTrack>)

Get current track and queue contents

pub async fn queue_reorder(&self, from: usize, to: usize) -> Result<(), String>

Reorder a track in the queue

pub fn subscribe_now_playing(&self) -> Receiver<NowPlaying>

Subscribe to now-playing updates

pub async fn get_state(&self) -> PlayerState

Snapshot current state for persistence

pub async fn save_state(&self)

Save current state to disk

pub async fn restore_state(&self)

Restore state from disk — resumes playback at the saved position