oximedia-net 0.1.0

Network streaming for OxiMedia
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! Network streaming for `OxiMedia`.
//!
//! This crate provides network streaming protocols for the `OxiMedia` multimedia
//! framework. It supports various streaming protocols including:
//!
//! - **HLS** (HTTP Live Streaming) - Apple's adaptive streaming protocol
//! - **DASH** (Dynamic Adaptive Streaming over HTTP) - MPEG-DASH streaming
//! - **RTMP** (Real-Time Messaging Protocol) - Flash streaming protocol
//! - **SRT** (Secure Reliable Transport) - Low-latency streaming
//! - **WebRTC** - Real-time browser communication
//! - **SMPTE ST 2110** - Professional media over IP (uncompressed video/audio/ANC)
//! - **CDN** - Multi-CDN failover and load balancing
//!
//! # Overview
//!
//! Each streaming protocol module provides:
//! - Protocol-specific packet/message types
//! - Parsing and serialization
//! - Session management
//! - Adaptive bitrate support where applicable
//!
//! The CDN module provides:
//! - Multi-CDN provider support (Cloudflare, Fastly, Akamai, CloudFront, Custom)
//! - Real-time health monitoring
//! - Automatic failover with circuit breaker pattern
//! - Intelligent routing strategies
//! - Performance metrics and SLA monitoring
//!
//! The SMPTE ST 2110 module provides:
//! - Uncompressed video transport (ST 2110-20)
//! - PCM audio transport (ST 2110-30)
//! - Ancillary data transport (ST 2110-40)
//! - PTP synchronization (IEEE 1588)
//! - SDP session description
//! - Broadcast-quality professional media over IP
//!
//! # Example
//!
//! ```ignore
//! use oximedia_net::hls::{MasterPlaylist, MediaPlaylist};
//! use oximedia_net::error::NetResult;
//!
//! async fn fetch_playlist(url: &str) -> NetResult<MasterPlaylist> {
//!     // Fetch and parse HLS master playlist
//!     todo!()
//! }
//! ```

#![warn(missing_docs)]
#![allow(
    clippy::cast_possible_truncation,
    clippy::cast_precision_loss,
    clippy::cast_sign_loss,
    dead_code,
    clippy::pedantic,
    clippy::must_use_candidate,
    clippy::missing_errors_doc,
    clippy::missing_panics_doc,
    clippy::similar_names,
    clippy::items_after_statements,
    clippy::option_map_unit_fn
)]

pub mod abr;
pub mod bandwidth_estimator;
pub mod bandwidth_throttle;
pub mod cdn;
pub mod connection_pool;
pub mod dash;
pub mod error;
pub mod flow_control;
pub mod hls;
pub mod live;
pub mod multicast;
pub mod network_path;
pub mod packet_buffer;
pub mod protocol_detect;
pub mod qos_monitor;
pub mod retry_policy;
pub mod rtmp;
pub mod rtp_session;
pub mod session_tracker;
pub mod smpte2110;
pub mod srt;
pub mod stream_mux;
pub mod webrtc;

// Re-export commonly used items
pub use error::{NetError, NetResult};

// Re-export SRT stats and key exchange types
pub use srt::{DirectionStats, RttStats, SrtStreamStats, StreamQuality};
pub use srt::{EncryptionSession, EncryptionState, KmxKeyMaterial, KwAlgorithm};

// Re-export streaming ABR types
pub use abr::streaming::{
    AbrBandwidthEstimator as BandwidthEstimator, AbrController, AbrSwitchReason, AbrVariant,
    BandwidthSample, BufferedSegment, SegmentFetcher, SelectionResult,
};