Enum TrackSource 

#[non_exhaustive]
pub enum TrackSource<S>
where
    S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,
{
    Uri(String),
    Config(Box<ResourceConfig<S>>),
}

Input to Queue::append / Queue::insert describing how to load a track.

Two shapes:

• TrackSource::Uri — the queue builds a default ResourceConfig from the QueueConfig templates (net, store). Convenient for simple use.
• TrackSource::Config — the caller pre-builds a ResourceConfig (useful for DRM keys, custom headers, format hints). The queue leaves caller-set fields intact.

TrackSource is Clone so the queue can respawn a load when a previously-consumed track is re-selected — re-tapping a track in the playlist must work without the caller reconstructing anything.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Uri(String)

Load from URL / path. Queue fills in defaults from QueueConfig.

Config(Box<ResourceConfig<S>>)

Caller-assembled resource config (DRM, headers, etc.). Boxed because ResourceConfig is ~100 bytes larger than the Uri variant.

Implementations

impl<S> TrackSource<S>

where S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,

pub fn uri(&self) -> Option<&str>

Canonical source location: the string for TrackSource::Uri, the config’s URL or file path for TrackSource::Config. None only for a non-UTF-8 file path.

Trait Implementations

impl<S> Clone for TrackSource<S>

where S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S> From<&str> for TrackSource<S>

where S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,

fn from(s: &str) -> Self

Converts to this type from the input type.

impl<S> From<Box<ResourceConfig<S>>> for TrackSource<S>

where S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,

fn from(value: Box<ResourceConfig<S>>) -> Self

Converts to this type from the input type.

impl<S> From<ResourceConfig<S>> for TrackSource<S>

where S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,

fn from(c: ResourceConfig<S>) -> Self

Converts to this type from the input type.

impl<S> From<String> for TrackSource<S>

where S: HasPool<u8> + HasPool<f32> + Send + Sync + 'static,

fn from(value: String) -> Self

Converts to this type from the input type.