Struct ReconnectPolicy 

#[non_exhaustive]
pub struct ReconnectPolicy {
    pub enabled: bool,
    pub reconnect_streamed: bool,
    pub reconnect_at_eof: bool,
    pub max_retries: u32,
    pub max_delay: Duration,
    pub max_total_delay: Duration,
    pub respect_retry_after: bool,
    pub retry_http_statuses: Vec<u16>,
    pub require_validator: bool,
}

Application-level reconnect. Default matches FFmpeg reconnect=0.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

enabled: bool

When false, no application-level retry after a response has started.

reconnect_streamed: bool

Allow reconnect on unknown-length non-seekable / live streams. Seekable resources never use this path (Range resume or TruncatedBody). A declared Content-Length without Accept-Ranges is treated as VOD and also refuses a restart from byte 0 — that would duplicate prefix bytes already given to FFmpeg.

reconnect_at_eof: bool

Reconnect after a clean EOF. For unknown-length live streams this re-GETs the resource; for known-length VOD it is a no-op (the body already ended).

max_retries: u32

Maximum application retries.

max_delay: Duration

Cap on a single backoff delay.

max_total_delay: Duration

Cap on summed backoff. Zero means no total cap.

respect_retry_after: bool

Honor a valid Retry-After when retrying.

retry_http_statuses: Vec<u16>

HTTP statuses eligible for retry after enabled.

require_validator: bool

Seekable reconnect / Range continuation requires ETag or Last-Modified. Default is true; set false only when the caller accepts an unverified splice.

Implementations

impl ReconnectPolicy

pub fn seekable_default() -> Self

Conservative seekable-resource retry (still opt-in via enabled).

pub fn streamed_default() -> Self

Live / unknown-length streamed retry (restart from the live edge).

Sets reconnect_streamed together with enabled and a non-zero max_retries (5, matching seekable_default). Setting reconnect_streamed = true on a hand-built policy without also raising max_retries above the default 0 used to be a silent no-op: every retry check consults the retry budget first. reconnect_at_eof is on because live unknown-length streams typically want to re-GET after a clean EOF.

Trait Implementations

impl Clone for ReconnectPolicy

fn clone(&self) -> ReconnectPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReconnectPolicy

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

Formats the value using the given formatter.

impl Default for ReconnectPolicy

fn default() -> Self

Returns the “default value” for a type.