Struct PlaybackEngine 

pub(crate) struct PlaybackEngine {
    clock: Option<PlaybackClock>,
    player: Option<AudioPlayer>,
}

Available on crate feature preview only.

Playback engine for the preview: owns the persistent audio player (so the output device survives pause cycles) and the active clock while playing.

Fields

clock: Option<PlaybackClock>

player: Option<AudioPlayer>

Available on non-target_family=wasm only.

Implementations

impl PlaybackEngine

pub fn new(evaluator: &SceneEvaluator) -> Self

Build an engine for a scene, preparing its mixed audio for playback.

fn build_player(evaluator: &SceneEvaluator) -> Option<AudioPlayer>

Available on non-target_family=wasm only.

pub fn is_playing(&self) -> bool

Whether playback is running.

pub fn play(&mut self, from: f64, total: f64, speed: f64) -> f64

Start playing from from at speed, wrapping to 0.0 at total. Returns the effective start position.

pub fn pause(&mut self) -> f64

Stop playback and return the frozen position.

pub fn pos_secs(&self) -> Option<f64>

The live position while playing; None when paused.

pub fn scrub_to(&mut self, sec: f64)

Rebase the active clock at sec (scrubbing). While paused, drive a scrub voice instead so the drag stays audible.

pub fn tick_scrub(&mut self) -> bool

Silence the scrub voice once the playhead stopped moving while paused. Returns whether a scrub voice is still audible (the caller should keep repainting so the staleness check can run).

pub fn set_speed(&mut self, speed: f64)

Change the playback speed, rebasing the active clock.

pub fn reload_scene(&mut self, evaluator: &SceneEvaluator)

Swap in a freshly built scene: stop playback and rebuild the audio player from the new scene’s audio plane.