v0.7.0

What's Changed

• Fix ICECandidate types by @roznawsk in #174
• Update deps. Bump version to 0.7.0

Full Changelog: v0.6.3...v0.7.0

v0.6.3

Add G711 payloader and depayloader (support for audio/PCMA and audio/PCMU)

v0.6.2

Move peer connection initialization to handle_continue

v0.5.1

Move peer connection initialization to handle_continue

v0.6.1

What's Changed

• Fix handling RTCP when there is no track by @roznawsk in #170

New Contributors

• @roznawsk made their first contribution in #170

Full Changelog: v0.6.0...v0.6.1

v0.6.0

Breaking Changes

This release doesn't include any breaking changes! 🎉

What's Changed

• Add jitter buffer by @sgfn in #158
• Add support for Fly.io deployments by @mickel8 in #167
• Update deps and examples by @mickel8 in #168
• Update Fly.io instructions by @mickel8 in #169

Full Changelog: v0.5.0...v0.6.0

v0.5.0

Breaking Changes

This release doesn't include any breaking changes! 🎉

What's Changed

• Add DataChannels by @LVala in #157
• DataChannels: allow for closing, apply negotiated stream parameters by @LVala in #161
• Include DataChannel stats in PeerConnection.get_stats by @LVala in #162
• Make DataChannel support optional by @LVala in #163
• Add guide on offering to receive media tracks by @mickel8 in #165
• Fix typo in docs by @Arp-G in #166

New Contributors

• @Arp-G made their first contribution in #166

Full Changelog: v0.4.1...v0.5.0

v0.4.1

What's Changed

• Make docs smaller by @sgfn in #156
• Buffer RT(C)P packets that arrive pre-DTLS handshake completion by @sgfn in #160
• Add deploying tutorial by @mickel8 in #159

Full Changelog: v0.4.0...v0.4.1

v0.4.0

Breaking changes

• Packets sent in the {:rtcp, ...} message now come wrapped in a 2-element tuple. A new field denotes the ID of the corresponding track (the one to which the feedback is related), i.e.

  {:ex_webrtc, input_pc, {:rtcp, packets}} = msg

  for packet <- packets do
    case packet do
-     %ExRTCP.Packet.PayloadFeedback.PLI{} ->
+     {track_id, %ExRTCP.Packet.PayloadFeedback.PLI{}} ->
         # do something
  ...

In the case of PLI and NACK, this is the ID of an outgoing (sender's) track; in the case of Sender and Receiver Reports, it's the ID of an incoming (receiver's) track.

If matching to a track was not possible (like in the case of TWCC packets), track_id is set to nil, i.e.

  ...
-     %ExRTCP.Packet.TransportFeedback.CC{} ->
+     {nil, %ExRTCP.Packet.TransportFeedback.CC{}} ->
         # do something else
    end
  end

• Supported payloaders (VP8, Opus) are now created and accessed using the same module: ExWebRTC.RTP.Payloader. The same applies to depayloaders (ExWebRTC.RTP.Depayloader):

  video_codec = %ExWebRTC.RTPCodecParameters{
    payload_type: 96,
    mime_type: "video/VP8",
    clock_rate: 90_000
  }

  audio_codec = %ExWebRTC.RTPCodecParameters{
    payload_type: 111,
    mime_type: "audio/opus",
    clock_rate: 48_000,
    channels: 2
  }

  # Creating (de)payloaders
- video_payloader = ExWebRTC.RTP.VP8.Payloader.new()
+ {:ok, video_payloader} = ExWebRTC.RTP.Payloader.new(video_codec)

+ {:ok, audio_depayloader} = ExWebRTC.RTP.Depayloader.new(audio_codec)

  # Using (de)payloaders
- {packets, video_payloader} = ExWebRTC.RTP.VP8.Payloader.payload(video_payloader, frame)
+ {packets, video_payloader} = ExWebRTC.RTP.Payloader.payload(video_payloader, frame)

- frame = ExWebRTC.RTP.Opus.Depayloader.depayload(packet)
+ {frame, audio_depayloader} = ExWebRTC.RTP.Depayloader.depayload(audio_depayloader, packet)

Refer to Payloader and Depayloader docs for more info.

What's Changed

• Remove redundant FMTP specification from default codecs by @mickel8 in #125
• Add RTP.Munger and H264 codec utilities by @LVala in #126
• Update examples. Update ex_webrtc deps. by @mickel8 in #131
• Fix examples sometimes not loading in Chromium by @mickel8 in #133
• Improve inbound/outbound RTP stats by @LVala in #134
• Fix: always include remote fingerprint in stats by @LVala in #135
• Expose ICE port range by @mickel8 in #139
• Add Introduction to Elixir WebRTC tutorial by @LVala in #136
• Add track_id to packets sent in {:rtcp, ...} message by @LVala in #140
• Further improvements to Introduction to Elixir WebRTC tutorial by @LVala in #141
• Fix set_remote_description failing on description with rejected m-lines by @LVala in #145
• Handle other retransmit case in DTLSTransport by @sgfn in #148
• Add tutorial about debugging by @LVala in #146
• Ignore lack of rtcp_mux in rejected m-lines by @LVala in #150
• Add format parameters to default video codecs by @LVala in #153
• Add simulcast tutorial by @mickel8 in #151
• Add behaviour and dynamic dispatch for (de)payloaders by @sgfn in #147
• Bump deps, release 0.4.0 by @sgfn in #155

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Breaking changes

• RTP packets are now returned in 4 element tuple (comparing to 3 element tuple before). A new field denotes RID i.e.

  - {:ex_webrtc, input_pc, {:rtp, id, packet}}
  + {:ex_webrtc, input_pc, {:rtp, id, rid, packet}}

  RID identifies simulcast layer. If client side offers simulcast, ExWebRTC will by default accept it. If simulcast is disabled, RID is equal to nil.

• all features like RTX, TWCC, Simulcast, etc. are now by default enabled. You can disable them using feature option of PeerConnection configuration options. This means you can remove RTX codec from your list of codecs:

  @video_codecs [
    %RTPCodecParameters{
      payload_type: 96,
      mime_type: "video/H264",
      clock_rate: 90_000,
  -    rtcp_fbs: [%ExSDP.Attribute.RTCPFeedback{pt: 96, feedback_type: :nack}]
    },
  -  %RTPCodecParameters{
  -    payload_type: 97,
  -    mime_type: "video/rtx",
  -    clock_rate: 90_000,
  -    sdp_fmtp_line: %ExSDP.Attribute.FMTP{pt: 97, apt: 96}
  - }
  ]

• ExWebRTC now supports MediaStreams. If you offer to send media tracks, they, by default, won't be assigned to any media stream. As a result, on the other side, in particular in a web browser, streams field of the RTCTrackEvent will be an empty array. You have to either create a stream in Elixir WebRTC or in a web browser i.e.

  To keep this working:

  pc.ontrack = event => videoPlayer.srcObject = event.streams[0];

  assign tracks to media stream in Elixir WebRTC:

  - {:ok, _sender} = PeerConnection.add_track(pc, MediaStreamTrack.new(:audio))
  - {:ok, _sender} = PeerConnection.add_track(pc, MediaStreamTrack.new(:video))
  + media_stream_id = MediaStreamTrack.generate_stream_id()
  + {:ok, _sender} = PeerConnection.add_track(pc, MediaStreamTrack.new(:audio, [media_stream_id]))
  + {:ok, _sender} = PeerConnection.add_track(pc, MediaStreamTrack.new(:video, [media_stream_id]))

What's Changed

• Add whip_whep example by @LVala in #109
• Fix typos by @kianmeng in #115
• Fix send_rtp for non-existing track id by @ndrean in #114
• Inbound Simulcast by @LVala in #111
• Add support for MediaStreams by @LVala in #117
• Fix simulcast issues by @LVala in #121
• Improve UX of Configuration by @LVala in #120
• Create a module for every codec in ExWebRTC.RTP by @LVala in #122
• Handle VP8.Payload.parse errors by @mickel8 in #123

New Contributors

• @kianmeng made their first contribution in #115
• @ndrean made their first contribution in #114

Full Changelog: v0.2.0...v0.3.0