oximedia-transcode 0.1.3

High-level transcoding pipeline 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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148

//! Streaming presets for HLS, DASH, and adaptive bitrate.

use crate::{AbrLadder, AbrLadderBuilder, AbrStrategy, PresetConfig, QualityMode};

/// HLS (HTTP Live Streaming) ABR ladder.
#[must_use]
pub fn hls_ladder() -> AbrLadder {
    AbrLadder::hls_standard()
}

/// DASH (MPEG-DASH) ABR ladder.
#[must_use]
pub fn dash_ladder() -> AbrLadder {
    AbrLadder::hls_standard() // Similar to HLS
}

/// Low-latency streaming preset (720p).
#[must_use]
pub fn low_latency_720p() -> PresetConfig {
    PresetConfig {
        video_codec: Some("h264".to_string()),
        audio_codec: Some("aac".to_string()),
        video_bitrate: Some(3_000_000), // 3 Mbps
        audio_bitrate: Some(128_000),
        width: Some(1280),
        height: Some(720),
        frame_rate: Some((30, 1)),
        quality_mode: Some(QualityMode::Medium),
        container: Some("mp4".to_string()),
        audio_channel_layout: None,
    }
}

/// Low-latency streaming preset (1080p).
#[must_use]
pub fn low_latency_1080p() -> PresetConfig {
    PresetConfig {
        video_codec: Some("h264".to_string()),
        audio_codec: Some("aac".to_string()),
        video_bitrate: Some(6_000_000), // 6 Mbps
        audio_bitrate: Some(192_000),
        width: Some(1920),
        height: Some(1080),
        frame_rate: Some((30, 1)),
        quality_mode: Some(QualityMode::Medium),
        container: Some("mp4".to_string()),
        audio_channel_layout: None,
    }
}

/// CMAF (Common Media Application Format) preset.
#[must_use]
pub fn cmaf() -> PresetConfig {
    PresetConfig {
        video_codec: Some("h264".to_string()),
        audio_codec: Some("aac".to_string()),
        video_bitrate: Some(5_000_000),
        audio_bitrate: Some(192_000),
        width: Some(1920),
        height: Some(1080),
        frame_rate: Some((30, 1)),
        quality_mode: Some(QualityMode::High),
        container: Some("mp4".to_string()),
        audio_channel_layout: None,
    }
}

/// Creates a custom ABR ladder for streaming.
#[must_use]
pub fn custom_ladder(
    min_resolution: (u32, u32),
    max_resolution: (u32, u32),
    strategy: AbrStrategy,
) -> AbrLadder {
    AbrLadderBuilder::new(strategy)
        .min_resolution(min_resolution.0, min_resolution.1)
        .max_resolution(max_resolution.0, max_resolution.1)
        .build()
}

/// Twitch streaming preset (1080p60).
#[must_use]
pub fn twitch_1080p60() -> PresetConfig {
    PresetConfig {
        video_codec: Some("h264".to_string()),
        audio_codec: Some("aac".to_string()),
        video_bitrate: Some(6_000_000), // 6 Mbps (Twitch recommendation)
        audio_bitrate: Some(160_000),
        width: Some(1920),
        height: Some(1080),
        frame_rate: Some((60, 1)),
        quality_mode: Some(QualityMode::High),
        container: Some("mp4".to_string()),
        audio_channel_layout: None,
    }
}

/// Twitch streaming preset (720p60).
#[must_use]
pub fn twitch_720p60() -> PresetConfig {
    PresetConfig {
        video_codec: Some("h264".to_string()),
        audio_codec: Some("aac".to_string()),
        video_bitrate: Some(4_500_000), // 4.5 Mbps
        audio_bitrate: Some(160_000),
        width: Some(1280),
        height: Some(720),
        frame_rate: Some((60, 1)),
        quality_mode: Some(QualityMode::High),
        container: Some("mp4".to_string()),
        audio_channel_layout: None,
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_hls_ladder() {
        let ladder = hls_ladder();
        assert!(ladder.rung_count() > 0);
        assert_eq!(ladder.strategy, AbrStrategy::AppleHls);
    }

    #[test]
    fn test_low_latency_720p() {
        let preset = low_latency_720p();
        assert_eq!(preset.width, Some(1280));
        assert_eq!(preset.height, Some(720));
        assert_eq!(preset.quality_mode, Some(QualityMode::Medium));
    }

    #[test]
    fn test_twitch_1080p60() {
        let preset = twitch_1080p60();
        assert_eq!(preset.width, Some(1920));
        assert_eq!(preset.height, Some(1080));
        assert_eq!(preset.frame_rate, Some((60, 1)));
        assert_eq!(preset.video_bitrate, Some(6_000_000));
    }

    #[test]
    fn test_custom_ladder() {
        let ladder = custom_ladder((640, 360), (1920, 1080), AbrStrategy::Conservative);
        assert_eq!(ladder.strategy, AbrStrategy::Conservative);
    }
}