webrtc_media (webrtc v0.1.0)

View Source

Media session of one BUNDLE transport, as a sans-IO engine: SRTP/SRTCP protection, RTP demultiplexing to transceivers, RTCP reports, NACK-based retransmission (RFC 4585, RFC 4588) and keyframe requests (RFC 4585 PLI, RFC 5104 FIR).

Media payloads are never decoded: the application sends and receives RTP payloads (or whole packets when forwarding).

This module is the API of the media session and its sans-IO entry points (new/1, configure/2, handle_packet/3, handle_timeout/2, next_timeout/1). The work is split by direction and by feature: webrtc_media_in receives, webrtc_media_out sends, and webrtc_media_fb (SLI, RPSI), webrtc_media_limit (TMMBR), webrtc_media_sync (RFC 6051), webrtc_media_rid (simulcast receive), webrtc_media_pause (RFC 7728) and webrtc_media_report (statistics reported by the application) each hold one feature. They share the #media{} record of webrtc_media.hrl. The two paths are drawn in docs/ARCHITECTURE.md, "Inside the media session".

Incoming RTP is matched to a transceiver (mid) in this order (RFC 9143 §9.2): known SSRC, the MID header extension, then a payload type used by a single m= section. In a section with negotiated simulcast layers, the layer (rid) comes from the RtpStreamId and RepairedRtpStreamId header extensions (RFC 8852, see webrtc_media_rid).

Senders are keyed by mid, or by {Mid, Rid} for each simulcast layer we send (RFC 8853); every layer has its own SSRC and RTX SSRC and carries the RtpStreamId extension (RFC 8851 §4).

Congestion control (webrtc_cc): when the peer accepts the transport-wide-cc header extension every outgoing RTP packet carries a transport-wide sequence number, and the peer's feedback (or REMB) drives the bandwidth estimate and the pacer on the send path. When we offered the extension, feedback is generated for incoming packets. new/1 takes the webrtc_cc options under cc.

Actions: {send, Datagram}, {send_ect, Datagram} (RTP to send with ECT(0), RFC 6679, once RFC 8888 feedback validated ECN) and {event, Event} with Event one of {rtp, Mid, #rtp{}}, {rtp, Mid, Rid, #rtp{}} (a simulcast layer), {keyframe_request, Mid}, {keyframe_request, Mid, Rid}, {rtcp, Mid, Packet} (feedback the application may act on, such as REMB or TWCC), {bye, Mid, Ssrc}, {bandwidth_estimate, Bps} (the target bitrate for everything sent on the transport changed), {max_bitrate, Mid, Bps} and {max_bitrate, Mid, Rid, Bps} (the payload bit rate a TMMBR limit allows on the stream, or infinity, see webrtc_media_limit) and {circuit_breaker, Mid, Reason} (RFC 8083, see webrtc_circuit_breaker).

Summary

Types

A transceiver (mid) or one simulcast layer of it.

Functions

Forget the SRTP contexts: the DTLS association they came from is gone. Sending fails with not_ready until set_srtp/5.

Apply the negotiated media sections (media of webrtc_jsep:negotiated/1). Existing sequence numbers and statistics are kept for transceivers that remain.

Dscp does not get through (RFC 8835 §4.2): the flows using it go unmarked.

The DSCPs the media flows use (RFC 8837), none at the default priority.

The same with the ECN codepoint the datagram arrived with (0 not-ECT, 1 ECT(1), 2 ECT(0), 3 CE), for RFC 8888 feedback.

Run a plugin callback: a raise becomes an error.

decoderImplementation or encoderImplementation and the power efficiency member from the plugin's info/1.

What the statistics show of a receive stream.

W3C members reported for a transceiver's streams (inbound, outbound), its media source or its audio playout (see webrtc_media_report). Returns the members dropped.

Merge reported members into one stream's.

Ask the remote sender of a transceiver for a keyframe, on every stream of the mid or on one simulcast layer with {Mid, Rid}: PLI when negotiated, otherwise FIR.

Ask the senders of a transceiver to keep their streams under Bps (RTP headers and payload) with TMMBR (RFC 5104 §4.2.1), or to lift our limit with infinity. Repeated with the regular reports until each sender answers with a TMMBN.

Ask the remote sender of a transceiver, or of one simulcast layer with {Mid, Rid}, to pause or resume its stream (RFC 7728).

Restart the streams of a transceiver halted by a circuit breaker (RFC 8083 §4.5), once its hold time has passed.

Send a payload on a transceiver. Opts: timestamp (RTP clock), marker, pt or codec (name), defaulting to the first negotiated codec, rid to send on one simulcast layer, and keyframe when the payload belongs to one (it then carries the RFC 6051 NTP time when negotiated).

Send an encoded frame: split into payloads by the codec's payload format (VP8, VP9 with picture IDs, H.264 in Annex B, AV1 temporal units; one payload for audio), the marker bit on the last. Opts: timestamp, keyframe, codec, rid.

Send a slice loss or reference picture selection indication to the senders of a transceiver, or of one simulcast layer with {Mid, Rid} (RFC 4585 §6.3.2, §6.3.3), when it was negotiated.

Encode raw media with the transceiver's codec plugin and send the frames it returns.

Send an RTP packet on a transceiver, or on one of its simulcast layers with {Mid, Rid}. The SSRC and sequence number are ours; payload type, timestamp, marker and payload come from the packet (forwarding rewrites only what identifies the stream). The packet goes through the pacer: the returned datagrams are those that may leave now, the others are returned by handle_timeout/2.

Change the congestion control options at run time (see webrtc_cc:set_options/3): pacing, pacing_factor, min_bitrate, max_bitrate.

Install the SRTP contexts from the DTLS-SRTP handshake.

Types

sender_key/0

-type sender_key() :: binary() | {binary(), binary()}.

state/0

-opaque state()

A transceiver (mid) or one simulcast layer of it.

Functions

clear_srtp(M)

-spec clear_srtp(state()) -> state().

Forget the SRTP contexts: the DTLS association they came from is gone. Sending fails with not_ready until set_srtp/5.

configure(Sections, Media)

-spec configure([map()], state()) -> state().

Apply the negotiated media sections (media of webrtc_jsep:negotiated/1). Existing sequence numbers and statistics are kept for transceivers that remain.

dscp_blocked(Dscp, M)

-spec dscp_blocked(1..63, state()) -> state().

Dscp does not get through (RFC 8835 §4.2): the flows using it go unmarked.

dscps(M)

-spec dscps(state()) -> [1..63].

The DSCPs the media flows use (RFC 8837), none at the default priority.

handle_packet(Bin, Now, Media)

-spec handle_packet(binary(), integer(), state()) -> {state(), list()}.

handle_packet(Bin, Now, Media, Ecn)

-spec handle_packet(binary(), integer(), state(), 0..3) -> {state(), list()}.

The same with the ECN codepoint the datagram arrived with (0 not-ECT, 1 ECT(1), 2 ECT(0), 3 CE), for RFC 8888 feedback.

handle_timeout(Now, Media)

-spec handle_timeout(integer(), state()) -> {state(), list()}.

new(Opts)

-spec new(map()) -> state().

next_timeout(Media)

-spec next_timeout(state()) -> integer() | infinity.

plugin_call(F)

-spec plugin_call(fun(() -> term())) -> term().

Run a plugin callback: a raise becomes an error.

plugin_info(Role, Mod, St)

-spec plugin_info(encoder | decoder, module(), term()) -> map().

decoderImplementation or encoderImplementation and the power efficiency member from the plugin's info/1.

ready(Media)

-spec ready(state()) -> boolean().

receiver_info(Ssrc, Rcv, Media)

-spec receiver_info(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()},
                    #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()}}) ->
                       map().

What the statistics show of a receive stream.

report_stats(Mid, _, Report, M)

-spec report_stats(binary(), webrtc_media_report:dir(), map(), state()) -> {[{term(), term()}], state()}.

W3C members reported for a transceiver's streams (inbound, outbound), its media source or its audio playout (see webrtc_media_report). Returns the members dropped.

report_stream(Dir, Ssrc, Kind, Report, Media)

-spec report_stream(in | out,
                    non_neg_integer(),
                    webrtc_media_report:dir(),
                    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()}}) ->
                       #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()}}.

Merge reported members into one stream's.

request_keyframe(Mid, Now, M)

-spec request_keyframe(sender_key(), integer(), state()) -> {[{send, binary()}], state()}.

Ask the remote sender of a transceiver for a keyframe, on every stream of the mid or on one simulcast layer with {Mid, Rid}: PLI when negotiated, otherwise FIR.

request_max_bitrate(Mid, Bps, Now, M)

-spec request_max_bitrate(binary(), pos_integer() | infinity, integer(), state()) ->
                             {ok, [{send, binary()}], state()} | {error, not_negotiated}.

Ask the senders of a transceiver to keep their streams under Bps (RTP headers and payload) with TMMBR (RFC 5104 §4.2.1), or to lift our limit with infinity. Repeated with the regular reports until each sender answers with a TMMBN.

request_pause(Key, Type, Now, M)

-spec request_pause(sender_key(), pause | resume, integer(), state()) ->
                       {ok, [{send, binary()}], state()} | {error, term()}.

Ask the remote sender of a transceiver, or of one simulcast layer with {Mid, Rid}, to pause or resume its stream (RFC 7728).

resume(Mid, Now, M)

-spec resume(binary(), integer(), state()) -> {ok, state()} | {error, term()}.

Restart the streams of a transceiver halted by a circuit breaker (RFC 8083 §4.5), once its hold time has passed.

send(Mid0, Payload, Opts, Now, M)

-spec send(binary(), binary(), map(), integer(), state()) ->
              {ok, [{send, binary()}], state()} | {error, term()}.

Send a payload on a transceiver. Opts: timestamp (RTP clock), marker, pt or codec (name), defaulting to the first negotiated codec, rid to send on one simulcast layer, and keyframe when the payload belongs to one (it then carries the RFC 6051 NTP time when negotiated).

send_frame(Mid0, Frame, Opts, Now, M)

-spec send_frame(binary(), binary(), map(), integer(), state()) ->
                    {ok, [{send, binary()}], state()} | {error, term()}.

Send an encoded frame: split into payloads by the codec's payload format (VP8, VP9 with picture IDs, H.264 in Annex B, AV1 temporal units; one payload for audio), the marker bit on the last. Opts: timestamp, keyframe, codec, rid.

send_loss_indication(Key, Fb, Now, M)

-spec send_loss_indication(sender_key(), webrtc_media_fb:indication(), integer(), state()) ->
                              {ok, [{send, binary()}], state()} | {error, not_negotiated}.

Send a slice loss or reference picture selection indication to the senders of a transceiver, or of one simulcast layer with {Mid, Rid} (RFC 4585 §6.3.2, §6.3.3), when it was negotiated.

send_media(Mid0, Raw, Opts, Now, M)

-spec send_media(binary(), term(), map(), integer(), state()) ->
                    {ok, [{send, binary()} | {event, term()}], state()} | {error, term()}.

Encode raw media with the transceiver's codec plugin and send the frames it returns.

send_packet(Mid, Rtp, Now, Media)

-spec send_packet(sender_key(),
                  #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(),
                  state()) ->
                     {ok, [{send, binary()}], state()} | {error, term()}.

Send an RTP packet on a transceiver, or on one of its simulcast layers with {Mid, Rid}. The SSRC and sequence number are ours; payload type, timestamp, marker and payload come from the packet (forwarding rewrites only what identifies the stream). The packet goes through the pacer: the returned datagrams are those that may leave now, the others are returned by handle_timeout/2.

set_congestion_control(Opts, Now, M)

-spec set_congestion_control(map(), integer(), state()) -> {list(), state()}.

Change the congestion control options at run time (see webrtc_cc:set_options/3): pacing, pacing_factor, min_bitrate, max_bitrate.

set_srtp(Profile, Material, Role, Now, M)

-spec set_srtp(webrtc_srtp:profile(), binary(), client | server, integer(), state()) -> state().

Install the SRTP contexts from the DTLS-SRTP handshake.

stats(Media)

-spec stats(state()) -> map().