Struct PreviewPlayer 

pub struct PreviewPlayer { /* private fields */ }

Thin builder for a (PlayerRunner, PlayerHandle) pair.

Usage

let (mut runner, handle) = PreviewPlayer::open("clip.mp4")?.split();

runner.set_sink(Box::new(MySink::new()));

let handle_audio = handle.clone();

std::thread::spawn(move || { let _ = runner.run(); });

handle.seek(Duration::from_secs(30));
handle.play();

// cpal audio callback:
device.build_output_stream(&cfg, move |buf: &mut [f32], _| {
    let s = handle_audio.pop_audio_samples(buf.len());
    buf[..s.len()].copy_from_slice(&s);
}, ...);

Implementations

impl PreviewPlayer

pub fn open(path: impl AsRef<Path>) -> Result<Self, PreviewError>

Open a media file and prepare for playback.

Probes the file to detect audio/video streams, opens a DecodeBuffer for the video stream (when present), and spawns a background audio decode thread (when present). Returns PreviewError if the file is missing or contains neither stream.

Errors

Returns PreviewError if the file cannot be probed or decoded.

pub fn split(self) -> (PlayerRunner, PlayerHandle)

Consume self and return an exclusive PlayerRunner and a shared PlayerHandle.

The runner owns the decode pipeline; move it to a background thread and call PlayerRunner::run. The handle is Clone + Send + Sync and can be shared freely.

Panics

Never panics in practice — the internal clock is always Some when split is first called.

Trait Implementations

impl Drop for PreviewPlayer

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.