webrtc_media_limit (webrtc v0.1.0)
View SourceTMMBR and TMMBN in the media engine (RFC 5104 §4.2, required by RFC 8834 §5.1.6), when ccm tmmbr is negotiated.
As media sender: each TMMBR entry for one of our streams updates its bounding set (webrtc_tmmbr) and is answered with a TMMBN. The stream then follows the limit: its packets go through a token bucket (webrtc_rate_limit) at the net media rate the set allows at the stream's packet rate, and the owner gets {max_bitrate, Mid, Bps} ({max_bitrate, Mid, Rid, Bps} for a simulcast layer) to adapt the encoder. An owner that sends BYE or is silent for 25 s (five regular intervals of at least 5 s, RFC 3550 §6.3.5) is removed and a new TMMBN sent.
As media receiver: request/4 sends TMMBR to the senders of a transceiver, repeated with the regular reports until a TMMBN arrives that lists us, or that is already more limiting than our tuple. Bit rates and overheads are at the RTP layer: headers and payload.
Summary
Functions
Pass paced items [{Class, {Key, Pkt, Rtx}}] through the limiters of their streams; returns the items that may go on.
Owners that left (RTCP BYE): a new TMMBN for every stream whose bounding set they were in.
FEC sent for a stream counts against its limit.
True while a stream follows a limit: no probes on it.
True when the codecs we send with negotiated ccm tmmbr.
The TMMBR to repeat with a regular report (RFC 5104 §4.2.1.2).
Ask the senders of Mid to keep under Bps (bits per second, RTP headers and payload) or, with infinity, lift our limit.
Hold-offs that ended, silent owners, and the packets the limiters release, which go on to the pacer.
A TMMBN from a sender we asked: done when it lists us, or when its set already limits more than our tuple would (RFC 5104 §4.2.1.2).
A TMMBR from From. Entries for streams that did not negotiate TMMBR are ignored and counted (RFC 5104 §7).
A packet from Ssrc: it is still in the session.
Types
Functions
-spec admit([{atom(), tuple()}], integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> {[{atom(), tuple()}], #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}}.
Pass paced items [{Class, {Key, Pkt, Rtx}}] through the limiters of their streams; returns the items that may go on.
-spec bye([non_neg_integer()], integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> {#media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}, list()}.
Owners that left (RTCP BYE): a new TMMBN for every stream whose bounding set they were in.
-spec charge(term(), [#rtp{version :: 2, padding :: 0..255, marker :: boolean(), pt :: 0..127, seq :: 0..65535, ts :: 0..4294967295, ssrc :: 0..4294967295, csrcs :: [0..4294967295], ext :: undefined | {Profile :: 0..65535, Data :: binary()} | [webrtc_rtp_ext:element()], payload :: binary()}], integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}.
FEC sent for a stream counts against its limit.
-spec limited(#snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}) -> boolean().
True while a stream follows a limit: no probes on it.
True when the codecs we send with negotiated ccm tmmbr.
-spec next_timeout(#media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> integer() | infinity.
-spec repeats(#media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> [#rtcp_tmmbr{sender_ssrc :: rtcp_u32(), media_ssrc :: rtcp_u32(), entries :: [{rtcp_u32(), non_neg_integer(), 0..511}]}].
The TMMBR to repeat with a regular report (RFC 5104 §4.2.1.2).
-spec request(binary(), pos_integer() | infinity, integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> {ok, [{send, binary()}], #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}} | {error, not_negotiated}.
Ask the senders of Mid to keep under Bps (bits per second, RTP headers and payload) or, with infinity, lift our limit.
-spec timeouts(integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> {[{atom(), tuple()}], list(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}}.
Hold-offs that ended, silent owners, and the packets the limiters release, which go on to the pacer.
-spec tmmbn(#rtcp_tmmbn{sender_ssrc :: rtcp_u32(), media_ssrc :: rtcp_u32(), entries :: [{rtcp_u32(), non_neg_integer(), 0..511}]}, #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}.
A TMMBN from a sender we asked: done when it lists us, or when its set already limits more than our tuple would (RFC 5104 §4.2.1.2).
-spec tmmbr(non_neg_integer(), [webrtc_tmmbr:tuple_()], integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> {#media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}, list()}.
A TMMBR from From. Entries for streams that did not negotiate TMMBR are ignored and counted (RFC 5104 §7).
-spec touch(non_neg_integer(), integer(), #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}) -> #media{cname :: binary(), ecn :: boolean(), rtcp_ssrc :: non_neg_integer(), out :: undefined | term(), in :: undefined | term(), senders :: #{sender_key() => #snd{mid :: binary(), kind :: audio | video, ssrc :: non_neg_integer(), rtx_ssrc :: non_neg_integer(), codecs :: [map()], rtx :: #{0..127 => 0..127}, mid_ext :: undefined | pos_integer(), twcc_ext :: undefined | pos_integer(), seq :: 0..65535, rtx_seq :: 0..65535, last_ts :: non_neg_integer(), last_ts_at :: undefined | integer(), tx :: term(), buffer :: term(), rid :: undefined | binary(), rid_ext :: undefined | pos_integer(), rrid_ext :: undefined | pos_integer(), audio_level_ext :: undefined | pos_integer(), pause :: undefined | webrtc_rtp_pause:sender(), hold_off :: non_neg_integer(), cycles :: non_neg_integer(), red_prev :: undefined | {0..127, non_neg_integer(), binary()}, picture_id :: 0..32767, fec_group :: [{0..65535, binary()}], fec_ssrc :: undefined | non_neg_integer(), fec_seq :: 0..65535, plugin :: undefined | {module(), term()} | {off, term()}, ext_form :: webrtc_rtp_ext:form(), tmmbr :: undefined | webrtc_tmmbr:state(), limiter :: undefined | webrtc_rate_limit:state(), limit :: non_neg_integer() | infinity, ntp_ext :: undefined | pos_integer(), sync_acked :: boolean(), sync_key_ts :: undefined | non_neg_integer(), sync_next :: boolean(), sync_req :: boolean(), priority :: webrtc_dscp:priority(), interactive :: boolean(), key_ts :: undefined | non_neg_integer()}}, receivers :: #{non_neg_integer() => #rcv{mid :: binary(), clock_rate :: pos_integer(), rx :: term(), nack :: undefined | term(), recent :: webrtc_red:history(), frames :: undefined | webrtc_frame_buffer:state(), keyframe :: [pli | fir], loss_fb :: [sli | rpsi], sync :: undefined | {integer(), non_neg_integer()}, sr_ntp :: undefined | non_neg_integer(), sync_from :: undefined | integer(), fir_seq :: 0..255, plugin :: undefined | {module(), term(), binary()} | {off, term()}, fec :: undefined | webrtc_ulpfec:receiver()}}, ssrc_mid :: #{non_neg_integer() => binary()}, signaled :: #{non_neg_integer() => binary()}, last_seen :: #{non_neg_integer() => integer()}, rtx_ssrc :: #{non_neg_integer() => non_neg_integer()}, pt_mid :: #{0..127 => binary()}, mid_ext :: #{binary() => pos_integer()}, recv :: #{binary() => map()}, rids :: webrtc_media_rid:state(), twcc_ids :: [pos_integer()], cc :: webrtc_cc:state(), rtcp :: undefined | webrtc_rtcp_sched:state(), rtcp_opts :: map(), pending_fb :: list(), dscp_off :: [0..63], ended :: [{non_neg_integer(), map(), map()}], limit_req :: #{binary() => {pos_integer() | infinity, [non_neg_integer()]}}, reduced_size :: boolean(), cryptex :: boolean(), send_encrypted :: [pos_integer()], recv_encrypted :: [pos_integer()], rtp_sent_mark :: non_neg_integer(), rtcp_rot :: non_neg_integer(), pause_req :: #{non_neg_integer() => webrtc_rtp_pause:requester()}, counters :: map(), xr_rrtr :: #{non_neg_integer() => {0..4294967295, integer()}}, sources :: #{binary() => map()}, raw :: undefined | binary(), video_fec :: auto | float(), playouts :: #{binary() => map()}, streams :: #{{in | out, non_neg_integer()} => map()}}.
A packet from Ssrc: it is still in the session.