moq-mux 0.7.0

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
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

//! Matroska / WebM.
//!
//! An EBML-based file format. moq-mux uses it as an external interchange
//! format only, not as a wire format: [`Import`] parses MKV byte streams
//! into a broadcast and [`Export`] does the reverse.

mod export;
mod import;

pub use export::*;
pub use import::*;

#[cfg(test)]
mod export_test;
#[cfg(test)]
mod import_test;

/// MKV parsing and emission errors.
#[derive(Debug, Clone, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
	#[error("unsupported EBML DocType: {0}")]
	UnsupportedDocType(String),

	#[error("EBML header missing DocType")]
	MissingDocType,

	#[error("invalid SimpleBlock")]
	InvalidSimpleBlock,

	#[error("invalid Block payload")]
	InvalidBlock,

	#[error("negative block timestamp")]
	NegativeBlockTimestamp,

	#[error("timestamp overflow")]
	TimestampOverflow,

	#[error("TrackEntry missing TrackNumber")]
	MissingTrackNumber,

	#[error("TrackEntry missing TrackType")]
	MissingTrackType,

	#[error("TrackEntry missing CodecID")]
	MissingCodecId,

	#[error("unsupported video CodecID: {0}")]
	UnsupportedVideoCodec(String),

	#[error("unsupported audio CodecID: {0}")]
	UnsupportedAudioCodec(String),

	#[error("{codec_id} missing CodecPrivate ({purpose})")]
	MissingCodecPrivate {
		codec_id: &'static str,
		purpose: &'static str,
	},

	#[error("invalid HEVCDecoderConfigurationRecord")]
	InvalidHvcc,

	#[error("invalid AV1CodecConfigurationRecord")]
	InvalidAv1c,

	#[error("MKV track layout changed after header was emitted: track '{0}' added")]
	HeaderAddedTrack(String),

	#[error("MKV track layout changed after header was emitted: track '{0}' removed")]
	HeaderRemovedTrack(String),

	#[error("MKV export does not support CMAF {kind} track '{name}'")]
	UnsupportedCmafTrack { kind: String, name: String },

	#[error("MKV export does not support video codec {0}")]
	UnsupportedVideoExport(String),

	#[error("MKV export does not support audio codec {0}")]
	UnsupportedAudioExport(String),

	#[error("AAC track missing AudioSpecificConfig (description)")]
	MissingAacDescription,

	#[error("H.264 track missing AVCDecoderConfigurationRecord")]
	MissingH264Avcc,

	#[error("H.265 track missing HEVCDecoderConfigurationRecord")]
	MissingH265Hvcc,

	#[error("cluster underflow")]
	ClusterUnderflow,

	#[error("block timestamp doesn't fit in i16")]
	BlockTimestampOverflow,

	#[error("missing track")]
	MissingTrack,

	#[error("timestamp doesn't fit in u64 ms")]
	TimestampU64,

	#[error("video track {0} missing in tracks map")]
	MissingVideoTrack(String),

	#[error("audio track {0} missing in tracks map")]
	MissingAudioTrack(String),

	#[error("no catalog snapshot")]
	NoCatalogSnapshot,

	#[error("matroska parse error")]
	MatroskaParse,

	#[error("matroska write error: {0}")]
	MatroskaWrite(std::sync::Arc<webm_iterable::errors::TagWriterError>),

	/// Building the Opus codec-private OpusHead for an audio track failed.
	#[error(transparent)]
	Opus(#[from] crate::codec::opus::Error),
}

impl From<webm_iterable::errors::TagWriterError> for Error {
	fn from(err: webm_iterable::errors::TagWriterError) -> Self {
		Error::MatroskaWrite(std::sync::Arc::new(err))
	}
}

pub type Result<T> = std::result::Result<T, Error>;