Struct AsyncPreviewPlayer 

pub struct AsyncPreviewPlayer { /* private fields */ }

Async wrapper around PlayerHandle.

On creation, a spawn_blocking thread opens the file, splits the player, and starts the runner. All control methods delegate directly to the underlying PlayerHandle — no inner Mutex.

Usage

use ff_preview::AsyncPreviewPlayer;
use std::time::Duration;

let player = AsyncPreviewPlayer::open("clip.mp4").await?;
player.play();
player.seek(Duration::from_secs(30));
while let Some(event) = player.next_event().await { ... }

Implementations

impl AsyncPreviewPlayer

pub async fn open( path: impl AsRef<Path> + Send + 'static, ) -> Result<Self, PreviewError>

Open a media file asynchronously.

File I/O and codec initialisation run on a spawn_blocking thread. The runner is also started on a dedicated blocking thread and runs until stop is called or EOF is reached.

Errors

Returns PreviewError if the file is missing, unreadable, or contains neither a video nor an audio stream.

pub fn play(&self)

Resume playback.

pub fn pause(&self)

Pause playback.

pub fn stop(&self)

Stop the presentation loop.

pub fn seek(&self, pts: Duration)

Seek to pts.

pub fn set_rate(&self, rate: f64)

Set the playback rate.

pub fn current_pts(&self) -> Duration

PTS of the most recently presented frame.

pub fn duration(&self) -> Option<Duration>

Container-reported duration, or None for live / streaming sources.

pub fn pop_audio_samples(&self, n: usize) -> Vec<f32>

Pull up to n interleaved stereo f32 PCM samples at 48 kHz.

pub fn poll_event(&self) -> Option<PlayerEvent>

Poll for the next PlayerEvent without blocking.

Returns None when no events are pending.

pub async fn next_event(&self) -> Option<PlayerEvent>

Await the next PlayerEvent.

Blocks in a spawn_blocking thread until an event arrives or the channel is closed. Returns None when the runner has exited.

Trait Implementations

impl Clone for AsyncPreviewPlayer

fn clone(&self) -> AsyncPreviewPlayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for AsyncPreviewPlayer

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.