Struct VideoAdaptationTuning 

pub struct VideoAdaptationTuning {
    pub(crate) multiparty_scalable_video_threshold: usize,
    pub(crate) thumbnail_budget_divisor: u64,
    pub(crate) downswitch_pressure_observations: u8,
    pub(crate) upswitch_stable_observations: u8,
    pub(crate) receiver_budget_headroom_percent: u8,
    pub(crate) audio_reserve_per_speaker: Bitrate,
}

Room-wide video budget and adaptation hysteresis.

When room membership reaches multiparty_scalable_video_threshold, scalable-video per-route targets use available receiver bandwidth and the resolved layout role. Pinned, featured, readable-detail and active-speaker targets use the full receiver budget. When several visible scalable routes share a receiver, other scalable targets divide that budget by their count and thumbnail_budget_divisor. Observation counts require consecutive policy turns. Headroom is removed before audio_reserve_per_speaker is subtracted for each admitted audio route the receiver consumes.

Fields

multiparty_scalable_video_threshold: usize

thumbnail_budget_divisor: u64

downswitch_pressure_observations: u8

upswitch_stable_observations: u8

receiver_budget_headroom_percent: u8

audio_reserve_per_speaker: Bitrate

Implementations

impl VideoAdaptationTuning

pub const DEFAULT_MULTIPARTY_SCALABLE_VIDEO_THRESHOLD: usize = 3

pub const DEFAULT_THUMBNAIL_BUDGET_DIVISOR: u64 = 2

pub const DEFAULT_DOWNSWITCH_PRESSURE_OBSERVATIONS: u8 = 2

pub const DEFAULT_UPSWITCH_STABLE_OBSERVATIONS: u8 = 3

pub const DEFAULT_RECEIVER_BUDGET_HEADROOM_PERCENT: u8 = 0

pub const DEFAULT_AUDIO_RESERVE_PER_SPEAKER: Bitrate

pub const fn try_new( multiparty_scalable_video_threshold: usize, thumbnail_budget_divisor: u64, downswitch_pressure_observations: u8, upswitch_stable_observations: u8, receiver_budget_headroom_percent: u8, audio_reserve_per_speaker: Bitrate, ) -> Result<Self, VideoAdaptationTuningError>

Builds validated video adaptation tuning.

Errors

Returns VideoAdaptationTuningError when the scalable-video threshold, the thumbnail budget divisor or either observation knob is zero, or when the headroom percent exceeds 100.

Trait Implementations

impl Clone for VideoAdaptationTuning

fn clone(&self) -> VideoAdaptationTuning

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VideoAdaptationTuning

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for VideoAdaptationTuning

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for VideoAdaptationTuning

fn eq(&self, other: &VideoAdaptationTuning) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for VideoAdaptationTuning

impl Eq for VideoAdaptationTuning

impl StructuralPartialEq for VideoAdaptationTuning