moq-mux 0.10.13

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

use moq_net::bandwidth::{Allocator, Rate, Reservation};
use moq_net::track;

/// A passthrough track's standing claim on an [`Allocator`].
///
/// The ceiling is the peak-hold catalog bitrate: taken on the first estimate,
/// raised when a later window exceeds it, never walked back. Nobody chose this
/// track's bitrate, so a grant is nothing it can act on.
pub(crate) struct Claim {
	allocator: Allocator,
	reservation: Option<Reservation>,
	ceiling: Rate,
}

impl Claim {
	pub fn new(allocator: Allocator) -> Self {
		Self {
			allocator,
			reservation: None,
			ceiling: Rate::ZERO,
		}
	}

	/// Reserve `bitrate` on the first estimate; raise the ceiling only when a later
	/// window exceeds it. A missing bitrate (the window hasn't closed) is a no-op.
	pub fn update(&mut self, track: &track::Demand, bitrate: Option<u64>) {
		let Some(bitrate) = bitrate else {
			return;
		};
		let max = Rate::from_bps(bitrate);
		if let Some(reservation) = &self.reservation {
			if max > self.ceiling {
				reservation.update(max);
				self.ceiling = max;
			}
			return;
		}
		self.reservation = Some(self.allocator.reserve(track, max));
		self.ceiling = max;
	}

	#[cfg(test)]
	pub fn ceiling(&self) -> Option<Rate> {
		self.reservation.as_ref().map(|_| self.ceiling)
	}
}