Skip to main content

AsyncAudioDecoderBuilder

Struct AsyncAudioDecoderBuilder 

Source
pub struct AsyncAudioDecoderBuilder { /* private fields */ }
Expand description

Async builder for AsyncAudioDecoder that mirrors the options available on the synchronous AudioDecoderBuilder.

Obtain one with AsyncAudioDecoder::builder. Call build to open the file asynchronously on a spawn_blocking thread.

§Examples

use ff_decode::AsyncAudioDecoder;
use ff_format::SampleFormat;

let decoder = AsyncAudioDecoder::builder("audio.mp3")
    .output_format(SampleFormat::F32)
    .output_sample_rate(48_000)
    .build()
    .await?;

Implementations§

Source§

impl AsyncAudioDecoderBuilder

Source

pub fn output_format(self, format: SampleFormat) -> Self

Sets the output sample format for decoded frames.

Equivalent to AudioDecoderBuilder::output_format.

Source

pub fn output_sample_rate(self, sample_rate: u32) -> Self

Sets the output sample rate in Hz.

Equivalent to AudioDecoderBuilder::output_sample_rate.

Source

pub fn output_channels(self, channels: u32) -> Self

Sets the output channel count.

Equivalent to AudioDecoderBuilder::output_channels.

Source

pub async fn build(self) -> Result<AsyncAudioDecoder, DecodeError>

Opens the file and builds the async decoder.

File I/O and codec initialisation run on a spawn_blocking thread so the async executor is not blocked. All errors from AudioDecoderBuilder::build are propagated transparently.

§Errors

Returns DecodeError if the file is missing, contains no audio stream, or uses an unsupported codec.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.