Struct LiveHlsOutput 

pub struct LiveHlsOutput { /* private fields */ }

Live HLS output: receives frames and writes a sliding-window .m3u8 playlist.

Build with LiveHlsOutput::new, chain setter methods, then call build to open the FFmpeg contexts. After build():

• push_video and push_audio encode and mux frames in real time.
• crate::StreamOutput::finish flushes all encoders and writes the HLS trailer.

The output directory is created automatically by build() if it does not exist.

Implementations

impl LiveHlsOutput

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

Create a new builder that writes HLS output to output_dir.

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

Example

use ff_stream::LiveHlsOutput;

let out = LiveHlsOutput::new("/var/www/live");

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

Set the target HLS segment duration.

Default: 6 seconds.

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

Set the maximum number of segments kept in the sliding-window playlist.

Default: 5.

pub fn segment_format(self, fmt: HlsSegmentFormat) -> Self

Set the HLS segment container format (default: HlsSegmentFormat::Ts).

Use HlsSegmentFormat::Fmp4 to produce CMAF-compatible fMP4 segments (.m4s) with an init.mp4 initialization segment.

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

Open all FFmpeg contexts and write the HLS header.

Errors

Returns StreamError::InvalidConfig when:

• output_dir is empty.
• video was not called before build.

Returns StreamError::Io when the output directory cannot be created. Returns StreamError::Ffmpeg when any FFmpeg operation fails.

impl LiveHlsOutput

pub fn video(self, width: u32, height: u32, fps: f64) -> Self

Set the video encoding parameters (width, height, fps).

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 this method is not called, audio is disabled.

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

Set the video codec.

Default: VideoCodec::H264.

pub fn audio_codec(self, codec: AudioCodec) -> Self

Set the audio codec.

Default: AudioCodec::Aac.

pub fn video_bitrate(self, bitrate: u64) -> Self

Set the video encoder target bit rate in bits/s.

pub fn audio_bitrate(self, bitrate: u64) -> Self

Set the audio encoder target bit rate in bits/s.

Default: 128 000 (128 kbit/s).

Trait Implementations

impl StreamOutput for LiveHlsOutput

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.