Enum Action 

#[non_exhaustive]
pub enum Action {
    FetchPlaylist {
        url: String,
        blocking: Option<BlockingReload>,
        skip: bool,
    },
    FetchResource {
        id: ResourceId,
        url: String,
        byte_range: Option<(u64, u64)>,
    },
    WaitMs(u64),
}

One unit of IO the caller must perform, in response to a crate::client::HlsClient::poll call. The client core never touches a socket or a clock itself — every Action names exactly what to fetch and, for a playlist reload, how to shape the request.

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.

FetchPlaylist

Fetch (or long-poll) the Media Playlist.

Fields

url: String

The playlist URL.

blocking: Option<BlockingReload>

Some to add _HLS_msn/_HLS_part query parameters requesting a Blocking Playlist Reload (RFC 8216bis §6.2.5.2); None for a plain (non-blocking) GET — used when the last-seen playlist did not advertise CAN-BLOCK-RELOAD support.

skip: bool

Add _HLS_skip=YES (RFC 8216bis §6.2.5.1) requesting a Playlist Delta Update — only set once the client has already seen a full playlist to reconstruct a delta response against, and the last playlist advertised CAN-SKIP-UNTIL.

FetchResource

Fetch one resource (init/part/segment).

Fields

id: ResourceId

Correlates the eventual crate::client::HlsClient::on_resource call.

url: String

The resource URL (already resolved against the playlist URL).

byte_range: Option<(u64, u64)>

Some((offset, length)) to fetch only that byte sub-range (RFC 8216bis §4.4.4.2/§4.4.4.9’s EXT-X-BYTERANGE/BYTERANGE); None fetches the entire resource.

WaitMs(u64)

A non-blocking-reload timing hint: wait about this many milliseconds before issuing the next FetchPlaylist, derived from #EXT-X-TARGETDURATION (RFC 8216 §4.3.3.1’s “SHOULD NOT … more frequently than once every Target Duration” reload guidance, halved for headroom) when the origin does not support blocking reload.

Implementations

impl Action

pub fn playlist_request_url(&self) -> Option<String>

For Action::FetchPlaylist, the fully query-augmented URL to fetch: _HLS_msn/_HLS_part (RFC 8216bis §6.2.5.2) appended per Self::FetchPlaylist’s blocking field, then _HLS_skip=YES (RFC 8216bis §6.2.5.1) if skip is set. None for Action::FetchResource/Action::WaitMs (nothing to augment — use their url/byte-range fields directly).

This is a convenience for building the real HTTP request; the typed blocking/skip fields remain the source of truth (e.g. for a caller using a query-parameter API rather than string concatenation).

Trait Implementations

impl Clone for Action

fn clone(&self) -> Action

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Action

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Action

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Action

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Action

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Action