smooth-runtime 0.1.0

Sans-IO Smooth Streaming (MS-SSTR) engine: a pull client (manifest fetch/refresh, stream/quality selection, chunk enumeration, fragment URLs, init/tfxd handling, retry/backoff, live join) and a live origin that renders the client Manifest and serves fragments from a media-plane Trunk. No I/O, no clock reads.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! The engine's fatal outcome: [`SmoothError`].

use thiserror::Error;

use crate::client::ManifestFault;

/// Why a [`crate::SmoothClient`] stopped for good.
#[derive(Debug, Clone, PartialEq, Eq, Error)]
#[non_exhaustive]
pub enum SmoothError {
    /// The manifest declares a `Protection` element (PlayReady/PIFF sample
    /// encryption); decrypting it is out of scope (MS-SSTR ยง2.2.2.2).
    #[error("manifest declares a Protection element; protected content is not supported")]
    ManifestProtected,
    /// A fragment carries PIFF/CENC sample-encryption boxes.
    #[error("fragment carries sample-encryption boxes; protected content is not supported")]
    FragmentEncrypted,
    /// The manifest could not be used and the retry budget is spent.
    #[error("manifest unusable after retries: {0}")]
    Manifest(ManifestFault),
    /// The manifest has no Video or Audio `StreamIndex` with a `QualityLevel`.
    #[error("manifest resolves no usable video or audio stream")]
    NoUsableStream,
    /// A stream's chunk timeline could not be enumerated.
    #[error("chunk timeline of stream {stream} is unusable: {reason}")]
    Timeline {
        /// Index of the stream in the manifest's stream order.
        stream: usize,
        /// The manifest parser's error, rendered.
        reason: String,
    },
    /// A fragment kept failing on a static presentation.
    #[error("fragment fetch failed (status {status:?})")]
    Fragment {
        /// The final HTTP status, when the failure was an HTTP one.
        status: Option<u16>,
    },
    /// A track could not be described or its init segment could not be built.
    #[error("track setup failed: {reason}")]
    TrackSetup {
        /// The codec-glue error, rendered.
        reason: String,
    },
}