Struct StreamSelection 

pub struct StreamSelection {
    pub url: String,
    pub transport: Transport,
    pub playback_kind: PlaybackKind,
    pub rendition: Option<Rendition>,
    pub available: Vec<QualityOption>,
    pub media_source_id: Option<String>,
    pub play_session_id: Option<String>,
    pub needs_transcoding: bool,
}

Everything a player backend needs to open a stream, and everything the UI needs to describe it.

Replaces the bare String URL that get_video_stream_url used to return.

TRACES: UR-079 | DR-225, DR-227, DR-228

Fields

url: String

The URL (or loopback URL) to open.

transport: Transport

How to fetch it. Replaces the .m3u8 substring check.

playback_kind: PlaybackKind

What the server is doing to the source to produce it.

rendition: Option<Rendition>

The negotiated rendition; None when direct-playing the source as-is.

available: Vec<QualityOption>

What this media source can offer, for the quality picker (DR-227).

media_source_id: Option<String>

The media source this selection is for, so a later re-open (quality change, audio-track switch, transcoded seek) targets the same one.

play_session_id: Option<String>

The transcode identity the server keyed this job by, when there is one.

needs_transcoding: bool

Whether the server is spending encoder time on this stream.

Derived from playback_kind rather than left for the frontend to compute: “which kinds count as transcoding” is a domain rule, and a direct stream is a remux that must not be counted. The queue’s long-standing needs_transcoding flag and the seek strategy both read this, so there is one answer rather than three.

TRACES: UR-079 | DR-225, DR-228

Implementations

impl StreamSelection

pub fn local_file(url: impl Into<String>) -> Self

A selection for a file already on disk.

A downloaded file is a direct play by definition — the bytes are the source’s — and offering a quality ladder over it would be a lie, since nothing about a local file can be re-negotiated.

TRACES: UR-071, UR-079 | DR-225

pub fn for_queued_item( url: impl Into<String>, transport: Option<Transport>, needs_transcoding: bool, ) -> Self

A selection for an item already sitting in the queue.

The queue predates StreamSelection: its items carry a URL, an optional transport and the older needs_transcoding flag. This rebuilds a selection from those without re-negotiating with the server, so the controller can hand an engine an OpenRequest for an item it already holds.

The transport falls back rather than being sniffed from the URL — the substring check is exactly what DR-230 removed. needs_transcoding is an exact stand-in because every transcode this app requests is HLS (DR-140).

TRACES: UR-079, UR-081 | DR-225, DR-245

Trait Implementations

impl Clone for StreamSelection

fn clone(&self) -> StreamSelection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamSelection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StreamSelection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl NamedType for StreamSelection

fn sid() -> SpectaID

fn named_data_type( type_map: &mut TypeCollection, generics: &[DataType], ) -> NamedDataType

this is equivalent to [Type::inline] but returns a [NamedDataType] instead.

fn definition_named_data_type(type_map: &mut TypeCollection) -> NamedDataType

this is equivalent to [Type::definition] but returns a [NamedDataType] instead.

impl PartialEq for StreamSelection

fn eq(&self, other: &StreamSelection) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for StreamSelection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Type for StreamSelection

fn inline(type_map: &mut TypeCollection, generics: Generics<'_>) -> DataType

Returns the definition of a type using the provided generics.

fn reference(type_map: &mut TypeCollection, generics: &[DataType]) -> Reference

Generates a datatype corresponding to a reference to this type, as determined by its category. Getting a reference to a type implies that it should belong in the type map (since it has to be referenced from somewhere), so the output of definition will be put into the type map.

impl Eq for StreamSelection

impl Flatten for StreamSelection

impl StructuralPartialEq for StreamSelection