Struct NetOptions 

#[non_exhaustive]
pub struct NetOptions {
    pub compression: Compression,
    pub inactivity_timeout: Duration,
    pub total_timeout: Option<Duration>,
    pub retry_policy: RetryPolicy,
    pub is_insecure: bool,
    pub pool_max_idle_per_host: usize,
    pub body_queue_capacity: usize,
    pub body_queue_resume_at: usize,
    pub byte_pool: Option<SharedPool<32, Vec<u8>>>,
    pub impersonate: ImpersonatePreset,
}

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.

compression: Compression

Accept-Encoding algorithms the client offers and auto-decodes. Defaults to all four (gzip | deflate | brotli | zstd); narrow it when an upstream rejects the full set (anti-bot WAFs that fingerprint on the exact Accept-Encoding string are a common reason).

inactivity_timeout: Duration

Maximum allowed inactivity between consecutive read operations. Maps to reqwest::ClientBuilder::read_timeout (documented as “The timeout applies to each read operation, and resets after a successful read”) and also drives the Downloader-layer BodyStream chunk-inactivity guard for the same semantics one layer down.

Protects against zombie connections that send headers but then stop streaming bytes. Does not cap the total request lifetime; a legitimately slow stream that keeps delivering chunks (even one byte every few seconds) is not aborted. Default 30s is sized to absorb realistic mobile-network stalls (TCP retransmits, captive-portal warm-up, server-side TTFB spikes) without aborting valid slow streams — the player’s contract is “wait for the segment, regardless of connection speed”, and a 10s cap raced real fixtures.

total_timeout: Option<Duration>

Hard cap on total request lifetime. Maps to reqwest::RequestBuilder::timeout. None lets streaming downloads run indefinitely as long as inactivity_timeout is satisfied — required for the player to honour “wait for the segment, regardless of connection speed”. Default Some(2 min) keeps a safety net against pathological cases (server stuck in mid-body without ever closing) while not racing realistic slow-network seeks.

retry_policy: RetryPolicy

is_insecure: bool

Accept invalid TLS certificates (self-signed, expired, wrong hostname). Security risk — use only for local development and test servers.

pool_max_idle_per_host: usize

Max idle connections per host. Enables HTTP keep-alive connection reuse, reducing TIME_WAIT accumulation under high request volume. Set to 0 to disable pooling.

body_queue_capacity: usize

Apple NSURLSession streaming body queue capacity, measured in delivered data chunks waiting for Rust consumption. Set to 0 to disable URLSession task suspension for queued body chunks.

body_queue_resume_at: usize

Queue length at or below which a suspended Apple streaming task resumes. Values greater than or equal to Self::body_queue_capacity are valid: they resume as soon as the consumer drains one chunk.

byte_pool: Option<SharedPool<32, Vec<u8>>>

Shared byte buffer pool used by backends that must copy platform-owned response buffers before handing bytes to Rust consumers.

impersonate: ImpersonatePreset

Browser TLS+HTTP2 fingerprint the native client-wreq backend impersonates. Defaults to Safari. Ignored by the client-reqwest backend and on wasm32 (no emulation there).

Implementations

impl NetOptions

pub fn builder() -> NetOptionsBuilder

Create an instance of NetOptions using the builder syntax

Trait Implementations

impl Clone for NetOptions

fn clone(&self) -> NetOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NetOptions

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

Formats the value using the given formatter.

impl Default for NetOptions

fn default() -> NetOptions

Returns the “default value” for a type.

impl FromWithParams<NetOptions, Option<SharedPool<32, Vec<u8>>>> for NetOptions

fn build( options: NetOptions, byte_pool: Option<SharedPool<32, Vec<u8>>>, ) -> NetOptions

Build Self from value and the construction parameters params.