moq-mux 0.8.1

Media muxers and demuxers for MoQ
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

//! Import media into a moq broadcast.
//!
//! The importers split along two axes. By multiplicity: [`Track`] / [`TrackStream`]
//! publish a single codec onto one MoQ track, while [`Container`] /
//! [`ContainerStream`] decode a container that may publish more than one track. By
//! frame boundaries: [`Track`] / [`Container`] take whole frames or chunks (the
//! typical case for files and reassembled network input), while [`TrackStream`] /
//! [`ContainerStream`] infer boundaries from a raw byte stream (piped Annex-B
//! H.264, an fMP4 reader, …).
//!
//! Each importer's `new` takes a format string (e.g. `"avc3"`, `"fmp4"`) and
//! errors on a format it doesn't handle — `TrackStream` / `ContainerStream`
//! accept only the self-delimiting formats. The concrete importers live with
//! their format under [`crate::container`] or [`crate::codec`] and publish their
//! own catalog rendition (see [`crate::catalog::VideoTrack`] /
//! [`crate::catalog::AudioTrack`]).
//!
//! [`unique_track`] mints a track for the single-codec importers.

mod container;
mod init;
mod track;

pub use container::*;
pub use init::Init;
pub use track::*;

/// Mint a fresh unique track for a legacy single-codec importer.
///
/// Picks a unique name from `suffix` and applies [`hang::container::track_info`], so the
/// relay gets timing without parsing the payload. Hand the result to the importer's `new`.
pub fn unique_track(
	broadcast: &mut moq_net::broadcast::Producer,
	suffix: &str,
) -> crate::Result<moq_net::track::Producer> {
	let info = hang::container::track_info();
	Ok(broadcast.unique_track(suffix, info)?)
}