Struct AudioFile 

pub struct AudioFile { /* private fields */ }

Represents an audio file stream that can be either encrypted or unencrypted.

AudioFile provides a unified interface for handling audio streams, wrapping all downloads in a 32 KiB buffer. For encrypted content, additional 2 KiB block processing is applied through the Decrypt implementation.

Implementations

impl AudioFile

pub fn try_from_download<P>( track: &Track, download: StreamDownload<P>, ) -> Result<Self>

where P: StorageProvider + Sync + 'static, P::Reader: Sync,

Creates a new AudioFile from a track and its download stream.

This method wraps the download in a 32 KiB buffer and then:

• For encrypted tracks: adds Decrypt handler for 2 KiB block processing
• For unencrypted tracks: uses the buffered download directly

Arguments

• track - The track metadata containing encryption information
• download - The underlying download stream

Type Parameters

• P - The storage provider type implementing StorageProvider

Returns

A new AudioFile configured for the track

Errors

• Error::Unimplemented - Track uses unsupported encryption
• Error::PermissionDenied - Decryption key not available
• Error::InvalidData - Failed to create decryptor
• Standard I/O errors from stream setup

Trait Implementations

impl MediaSource for AudioFile

Implements the MediaSource trait required by Symphonia for media playback.

This implementation provides metadata about the stream’s capabilities and properties:

• Seekability: determined by whether the track is a livestream
• Byte length: provided if known from the track metadata

fn is_seekable(&self) -> bool

Returns whether seeking is supported in this audio stream.

Returns

• true for normal audio files
• false for livestreams

fn byte_len(&self) -> Option<u64>

Returns the total size of the audio stream in bytes, if known.

Returns

• Some(u64) - The size in bytes if known
• None - If the size is unknown (e.g., for livestreams)

impl Read for AudioFile

Implements reading from the audio stream.

This implementation delegates all read operations directly to the underlying stream, whether it’s a decrypted stream or raw download stream, providing transparent handling of encrypted and unencrypted content.

Arguments

• buf - Buffer to read data into

Returns

Number of bytes read, or 0 at end of stream

Errors

Propagates errors from the underlying stream:

• InvalidInput - Buffer position invalid
• InvalidData - Decryption failed
• Standard I/O errors

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

fn is_read_vectored(&self) -> bool

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

Determines if this Reader has an efficient read_vectored implementation.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>

Reads all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Reads all bytes until EOF in this source, appending them to buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Reads the exact number of bytes required to fill buf.

fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>

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

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>

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

Reads the exact number of bytes required to fill cursor.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Read.

fn bytes(self) -> Bytes<Self>

where Self: Sized,

Transforms this Read instance to an Iterator over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R>

where R: Read, Self: Sized,

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

where Self: Sized,

Creates an adapter which will read at most limit bytes from it.

fn read_array<const N: usize>(&mut self) -> Result<[u8; N], Error>

where Self: Sized,

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

Read and return a fixed array of bytes from this source.

impl Seek for AudioFile

Implements seeking within the audio stream.

This implementation delegates all seek operations directly to the underlying stream. Note that seeking may not be available for livestreams, which can be checked via the is_seekable() method.

Arguments

• pos - Seek position (Start/Current/End)

Returns

New position in the stream

Errors

Propagates errors from the underlying stream:

• InvalidInput - Invalid seek position
• UnexpectedEof - Seek beyond end of file
• Unsupported - Seeking from end with unknown size

fn seek(&mut self, pos: SeekFrom) -> Result<u64>

Seek to an offset, in bytes, in a stream.

fn rewind(&mut self) -> Result<(), Error>

Rewind to the beginning of a stream.

fn stream_len(&mut self) -> Result<u64, Error>

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

Returns the length of this stream (in bytes).

fn stream_position(&mut self) -> Result<u64, Error>

Returns the current seek position from the start of the stream.

fn seek_relative(&mut self, offset: i64) -> Result<(), Error>

Seeks relative to the current position.