Struct LiveAbrLadder 

pub struct LiveAbrLadder { /* private fields */ }

Live ABR ladder: fans frames to multiple encoders at different resolutions.

Build with LiveAbrLadder::new, add renditions, configure encoding parameters, then call build. After that:

• push_video and push_audio forward frames to all renditions (each scales internally via its own SwsContext).
• StreamOutput::finish flushes all encoders and writes the master playlist.

All rendition subdirectories are created by build() if they do not exist.

Implementations

impl LiveAbrLadder

pub fn new(output_dir: impl AsRef<Path>) -> Self

Create a new builder that writes the ABR ladder to output_dir.

Accepts any path-like value: "/var/www/live", Path::new(…), etc.

Example

use ff_stream::LiveAbrLadder;

let ladder = LiveAbrLadder::new("/var/www/live");

pub fn add_rendition(self, rendition: AbrRendition) -> Self

Add a rendition to the ladder.

At least one rendition is required; build returns StreamError::InvalidConfig when the list is empty.

pub fn format(self, format: LiveAbrFormat) -> Self

Set the output container format.

Default: LiveAbrFormat::Hls.

pub fn fps(self, fps: f64) -> Self

Set the frame rate used for all renditions.

This method must be called before build.

pub fn audio(self, sample_rate: u32, channels: u32) -> Self

Enable audio output with the given sample rate and channel count.

If not called, audio is disabled for all renditions.

pub fn segment_duration(self, duration: Duration) -> Self

Set the target segment duration for all renditions.

Default: 6 seconds.

pub fn playlist_size(self, size: u32) -> Self

Set the sliding-window playlist size (HLS only).

Default: 5.

pub fn video_codec(self, codec: VideoCodec) -> Self

Set the video codec for all renditions.

Default: VideoCodec::H264.

pub fn build(self) -> Result<Self, StreamError>

Open all per-rendition FFmpeg contexts.

Errors

Returns StreamError::InvalidConfig when:

• output_dir is empty.
• No renditions have been added.
• fps was not called.

Returns StreamError::Io when a rendition subdirectory cannot be created. Returns StreamError::Ffmpeg when any FFmpeg operation fails.

Trait Implementations

impl StreamOutput for LiveAbrLadder

fn push_video(&mut self, frame: &VideoFrame) -> Result<(), StreamError>

Push one video frame into the stream.

fn push_audio(&mut self, frame: &AudioFrame) -> Result<(), StreamError>

Push one audio frame into the stream.

fn finish(self: Box<Self>) -> Result<(), StreamError>

Flush all buffered data and close the output.