blob: 536e5d43a8968699db239ac9f2ec50623636cdfb [file] [log] [blame]
Tommi3a5742c2020-05-20 09:32:51 +02001/*
2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
11#include "modules/rtp_rtcp/source/rtp_rtcp_impl2.h"
12
13#include <string.h>
14
15#include <algorithm>
16#include <cstdint>
17#include <memory>
18#include <set>
19#include <string>
20#include <utility>
21
Markus Handellc6b9ac72021-06-18 13:44:51 +020022#include "absl/types/optional.h"
Markus Handell885d5382021-06-21 18:57:36 +020023#include "api/sequence_checker.h"
Tommi3a5742c2020-05-20 09:32:51 +020024#include "api/transport/field_trial_based_config.h"
Markus Handell885d5382021-06-21 18:57:36 +020025#include "api/units/time_delta.h"
Markus Handellc6b9ac72021-06-18 13:44:51 +020026#include "api/units/timestamp.h"
Tommi3a5742c2020-05-20 09:32:51 +020027#include "modules/rtp_rtcp/source/rtcp_packet/dlrr.h"
28#include "modules/rtp_rtcp/source/rtp_rtcp_config.h"
29#include "rtc_base/checks.h"
30#include "rtc_base/logging.h"
Markus Handell885d5382021-06-21 18:57:36 +020031#include "rtc_base/task_utils/to_queued_task.h"
32#include "rtc_base/time_utils.h"
Alessio Bazzicabc1c93d2021-03-12 17:45:26 +010033#include "system_wrappers/include/ntp_time.h"
Tommi3a5742c2020-05-20 09:32:51 +020034
35#ifdef _WIN32
36// Disable warning C4355: 'this' : used in base member initializer list.
37#pragma warning(disable : 4355)
38#endif
39
40namespace webrtc {
41namespace {
Tommi3a5742c2020-05-20 09:32:51 +020042const int64_t kDefaultExpectedRetransmissionTimeMs = 125;
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +020043
44constexpr TimeDelta kRttUpdateInterval = TimeDelta::Millis(1000);
Markus Handell885d5382021-06-21 18:57:36 +020045
46RTCPSender::Configuration AddRtcpSendEvaluationCallback(
47 RTCPSender::Configuration config,
48 std::function<void(TimeDelta)> send_evaluation_callback) {
49 config.schedule_next_rtcp_send_evaluation_function =
50 std::move(send_evaluation_callback);
51 return config;
52}
53
54int DelayMillisForDuration(TimeDelta duration) {
55 // TimeDelta::ms() rounds downwards sometimes which leads to too little time
56 // slept. Account for this, unless |duration| is exactly representable in
57 // millisecs.
58 return (duration.us() + rtc::kNumMillisecsPerSec - 1) /
59 rtc::kNumMicrosecsPerMillisec;
60}
Tommi3a5742c2020-05-20 09:32:51 +020061} // namespace
62
63ModuleRtpRtcpImpl2::RtpSenderContext::RtpSenderContext(
Tomas Gunnarssonf25761d2020-06-03 22:55:33 +020064 const RtpRtcpInterface::Configuration& config)
Tommi3a5742c2020-05-20 09:32:51 +020065 : packet_history(config.clock, config.enable_rtx_padding_prioritization),
Erik Språngbb904972021-08-06 13:10:11 +020066 deferred_sequencing_(config.use_deferred_sequencing),
Erik Språngbfcfe032021-08-04 14:45:32 +020067 sequencer_(config.local_media_ssrc,
68 config.rtx_send_ssrc,
69 /*require_marker_before_media_padding=*/!config.audio,
70 config.clock),
Tommi3a5742c2020-05-20 09:32:51 +020071 packet_sender(config, &packet_history),
Erik Språngbb904972021-08-06 13:10:11 +020072 non_paced_sender(&packet_sender, this, config.use_deferred_sequencing),
Tommi3a5742c2020-05-20 09:32:51 +020073 packet_generator(
74 config,
75 &packet_history,
Erik Språngbfcfe032021-08-04 14:45:32 +020076 config.paced_sender ? config.paced_sender : &non_paced_sender,
Erik Språngbb904972021-08-06 13:10:11 +020077 config.use_deferred_sequencing ? nullptr : &sequencer_) {}
Erik Språng1d50cb62020-07-02 17:41:32 +020078void ModuleRtpRtcpImpl2::RtpSenderContext::AssignSequenceNumber(
79 RtpPacketToSend* packet) {
Erik Språngbb904972021-08-06 13:10:11 +020080 if (deferred_sequencing_) {
81 sequencer_.Sequence(*packet);
82 } else {
83 packet_generator.AssignSequenceNumber(packet);
84 }
Erik Språng1d50cb62020-07-02 17:41:32 +020085}
Tommi3a5742c2020-05-20 09:32:51 +020086
Tommi3a5742c2020-05-20 09:32:51 +020087ModuleRtpRtcpImpl2::ModuleRtpRtcpImpl2(const Configuration& configuration)
Niels Moller2accc7d2021-01-12 15:54:16 +000088 : worker_queue_(TaskQueueBase::Current()),
Markus Handell885d5382021-06-21 18:57:36 +020089 rtcp_sender_(AddRtcpSendEvaluationCallback(
90 RTCPSender::Configuration::FromRtpRtcpConfiguration(configuration),
91 [this](TimeDelta duration) {
92 ScheduleRtcpSendEvaluation(duration);
93 })),
Tommi3a5742c2020-05-20 09:32:51 +020094 rtcp_receiver_(configuration, this),
95 clock_(configuration.clock),
Tommi3a5742c2020-05-20 09:32:51 +020096 packet_overhead_(28), // IPV4 UDP.
97 nack_last_time_sent_full_ms_(0),
98 nack_last_seq_number_sent_(0),
99 remote_bitrate_(configuration.remote_bitrate_estimator),
100 rtt_stats_(configuration.rtt_stats),
101 rtt_ms_(0) {
Niels Moller2accc7d2021-01-12 15:54:16 +0000102 RTC_DCHECK(worker_queue_);
Tommi08be9ba2021-06-15 23:01:57 +0200103 packet_sequence_checker_.Detach();
Erik Språngbb904972021-08-06 13:10:11 +0200104 pacer_thread_checker_.Detach();
Tommi3a5742c2020-05-20 09:32:51 +0200105 if (!configuration.receiver_only) {
106 rtp_sender_ = std::make_unique<RtpSenderContext>(configuration);
107 // Make sure rtcp sender use same timestamp offset as rtp sender.
108 rtcp_sender_.SetTimestampOffset(
109 rtp_sender_->packet_generator.TimestampOffset());
110 }
111
112 // Set default packet size limit.
113 // TODO(nisse): Kind-of duplicates
114 // webrtc::VideoSendStream::Config::Rtp::kDefaultMaxPacketSize.
115 const size_t kTcpOverIpv4HeaderSize = 40;
116 SetMaxRtpPacketSize(IP_PACKET_SIZE - kTcpOverIpv4HeaderSize);
Ivo Creusen8c40d512021-07-13 12:53:22 +0000117 rtt_update_task_ = RepeatingTaskHandle::DelayedStart(
118 worker_queue_, kRttUpdateInterval, [this]() {
119 PeriodicUpdate();
120 return kRttUpdateInterval;
121 });
Tommi3a5742c2020-05-20 09:32:51 +0200122}
123
124ModuleRtpRtcpImpl2::~ModuleRtpRtcpImpl2() {
Niels Moller2accc7d2021-01-12 15:54:16 +0000125 RTC_DCHECK_RUN_ON(worker_queue_);
126 rtt_update_task_.Stop();
127}
128
129// static
130std::unique_ptr<ModuleRtpRtcpImpl2> ModuleRtpRtcpImpl2::Create(
131 const Configuration& configuration) {
132 RTC_DCHECK(configuration.clock);
133 RTC_DCHECK(TaskQueueBase::Current());
134 return std::make_unique<ModuleRtpRtcpImpl2>(configuration);
Tomas Gunnarssonfae05622020-06-03 08:54:39 +0200135}
136
Tommi3a5742c2020-05-20 09:32:51 +0200137void ModuleRtpRtcpImpl2::SetRtxSendStatus(int mode) {
138 rtp_sender_->packet_generator.SetRtxStatus(mode);
139}
140
141int ModuleRtpRtcpImpl2::RtxSendStatus() const {
142 return rtp_sender_ ? rtp_sender_->packet_generator.RtxStatus() : kRtxOff;
143}
144
145void ModuleRtpRtcpImpl2::SetRtxSendPayloadType(int payload_type,
146 int associated_payload_type) {
147 rtp_sender_->packet_generator.SetRtxPayloadType(payload_type,
148 associated_payload_type);
149}
150
151absl::optional<uint32_t> ModuleRtpRtcpImpl2::RtxSsrc() const {
152 return rtp_sender_ ? rtp_sender_->packet_generator.RtxSsrc() : absl::nullopt;
153}
154
155absl::optional<uint32_t> ModuleRtpRtcpImpl2::FlexfecSsrc() const {
156 if (rtp_sender_) {
157 return rtp_sender_->packet_generator.FlexfecSsrc();
158 }
159 return absl::nullopt;
160}
161
162void ModuleRtpRtcpImpl2::IncomingRtcpPacket(const uint8_t* rtcp_packet,
163 const size_t length) {
Tommi08be9ba2021-06-15 23:01:57 +0200164 RTC_DCHECK_RUN_ON(&packet_sequence_checker_);
Tommi3a5742c2020-05-20 09:32:51 +0200165 rtcp_receiver_.IncomingPacket(rtcp_packet, length);
166}
167
168void ModuleRtpRtcpImpl2::RegisterSendPayloadFrequency(int payload_type,
169 int payload_frequency) {
170 rtcp_sender_.SetRtpClockRate(payload_type, payload_frequency);
171}
172
173int32_t ModuleRtpRtcpImpl2::DeRegisterSendPayload(const int8_t payload_type) {
174 return 0;
175}
176
177uint32_t ModuleRtpRtcpImpl2::StartTimestamp() const {
178 return rtp_sender_->packet_generator.TimestampOffset();
179}
180
181// Configure start timestamp, default is a random number.
182void ModuleRtpRtcpImpl2::SetStartTimestamp(const uint32_t timestamp) {
183 rtcp_sender_.SetTimestampOffset(timestamp);
184 rtp_sender_->packet_generator.SetTimestampOffset(timestamp);
185 rtp_sender_->packet_sender.SetTimestampOffset(timestamp);
186}
187
188uint16_t ModuleRtpRtcpImpl2::SequenceNumber() const {
Erik Språngbb904972021-08-06 13:10:11 +0200189 if (rtp_sender_->deferred_sequencing_) {
190 return rtp_sender_->sequencer_.media_sequence_number();
191 }
Tommi3a5742c2020-05-20 09:32:51 +0200192 return rtp_sender_->packet_generator.SequenceNumber();
193}
194
195// Set SequenceNumber, default is a random number.
196void ModuleRtpRtcpImpl2::SetSequenceNumber(const uint16_t seq_num) {
Erik Språngbb904972021-08-06 13:10:11 +0200197 if (rtp_sender_->deferred_sequencing_) {
198 RTC_DCHECK_RUN_ON(&pacer_thread_checker_);
199 if (rtp_sender_->sequencer_.media_sequence_number() != seq_num) {
200 rtp_sender_->sequencer_.set_media_sequence_number(seq_num);
201 rtp_sender_->packet_history.Clear();
202 }
203 } else {
204 rtp_sender_->packet_generator.SetSequenceNumber(seq_num);
205 }
Tommi3a5742c2020-05-20 09:32:51 +0200206}
207
208void ModuleRtpRtcpImpl2::SetRtpState(const RtpState& rtp_state) {
209 rtp_sender_->packet_generator.SetRtpState(rtp_state);
Erik Språngbb904972021-08-06 13:10:11 +0200210 if (rtp_sender_->deferred_sequencing_) {
211 rtp_sender_->sequencer_.SetRtpState(rtp_state);
212 }
Tommi3a5742c2020-05-20 09:32:51 +0200213 rtcp_sender_.SetTimestampOffset(rtp_state.start_timestamp);
214}
215
216void ModuleRtpRtcpImpl2::SetRtxState(const RtpState& rtp_state) {
217 rtp_sender_->packet_generator.SetRtxRtpState(rtp_state);
Erik Språngbb904972021-08-06 13:10:11 +0200218 if (rtp_sender_->deferred_sequencing_) {
219 rtp_sender_->sequencer_.set_rtx_sequence_number(rtp_state.sequence_number);
220 }
Tommi3a5742c2020-05-20 09:32:51 +0200221}
222
223RtpState ModuleRtpRtcpImpl2::GetRtpState() const {
224 RtpState state = rtp_sender_->packet_generator.GetRtpState();
Erik Språngbb904972021-08-06 13:10:11 +0200225 if (rtp_sender_->deferred_sequencing_) {
226 rtp_sender_->sequencer_.PopulateRtpState(state);
227 }
Tommi3a5742c2020-05-20 09:32:51 +0200228 return state;
229}
230
231RtpState ModuleRtpRtcpImpl2::GetRtxState() const {
Erik Språngbb904972021-08-06 13:10:11 +0200232 RtpState state = rtp_sender_->packet_generator.GetRtxRtpState();
233 if (rtp_sender_->deferred_sequencing_) {
234 state.sequence_number = rtp_sender_->sequencer_.rtx_sequence_number();
235 }
236 return state;
Tommi3a5742c2020-05-20 09:32:51 +0200237}
238
Ivo Creusen8c40d512021-07-13 12:53:22 +0000239void ModuleRtpRtcpImpl2::SetNonSenderRttMeasurement(bool enabled) {
240 rtcp_sender_.SetNonSenderRttMeasurement(enabled);
241 rtcp_receiver_.SetNonSenderRttMeasurement(enabled);
242}
243
Tommi08be9ba2021-06-15 23:01:57 +0200244uint32_t ModuleRtpRtcpImpl2::local_media_ssrc() const {
245 RTC_DCHECK_RUN_ON(&packet_sequence_checker_);
246 RTC_DCHECK_EQ(rtcp_receiver_.local_media_ssrc(), rtcp_sender_.SSRC());
247 return rtcp_receiver_.local_media_ssrc();
248}
249
Tommi3a5742c2020-05-20 09:32:51 +0200250void ModuleRtpRtcpImpl2::SetRid(const std::string& rid) {
251 if (rtp_sender_) {
252 rtp_sender_->packet_generator.SetRid(rid);
253 }
254}
255
256void ModuleRtpRtcpImpl2::SetMid(const std::string& mid) {
257 if (rtp_sender_) {
258 rtp_sender_->packet_generator.SetMid(mid);
259 }
260 // TODO(bugs.webrtc.org/4050): If we end up supporting the MID SDES item for
261 // RTCP, this will need to be passed down to the RTCPSender also.
262}
263
264void ModuleRtpRtcpImpl2::SetCsrcs(const std::vector<uint32_t>& csrcs) {
265 rtcp_sender_.SetCsrcs(csrcs);
266 rtp_sender_->packet_generator.SetCsrcs(csrcs);
267}
268
269// TODO(pbos): Handle media and RTX streams separately (separate RTCP
270// feedbacks).
271RTCPSender::FeedbackState ModuleRtpRtcpImpl2::GetFeedbackState() {
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200272 // TODO(bugs.webrtc.org/11581): Called by potentially multiple threads.
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200273 // Mostly "Send*" methods. Make sure it's only called on the
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200274 // construction thread.
275
Tommi3a5742c2020-05-20 09:32:51 +0200276 RTCPSender::FeedbackState state;
277 // This is called also when receiver_only is true. Hence below
278 // checks that rtp_sender_ exists.
279 if (rtp_sender_) {
280 StreamDataCounters rtp_stats;
281 StreamDataCounters rtx_stats;
282 rtp_sender_->packet_sender.GetDataCounters(&rtp_stats, &rtx_stats);
283 state.packets_sent =
284 rtp_stats.transmitted.packets + rtx_stats.transmitted.packets;
285 state.media_bytes_sent = rtp_stats.transmitted.payload_bytes +
286 rtx_stats.transmitted.payload_bytes;
287 state.send_bitrate =
288 rtp_sender_->packet_sender.GetSendRates().Sum().bps<uint32_t>();
289 }
290 state.receiver = &rtcp_receiver_;
291
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100292 uint32_t received_ntp_secs = 0;
293 uint32_t received_ntp_frac = 0;
294 state.remote_sr = 0;
295 if (rtcp_receiver_.NTP(&received_ntp_secs, &received_ntp_frac,
296 /*rtcp_arrival_time_secs=*/&state.last_rr_ntp_secs,
297 /*rtcp_arrival_time_frac=*/&state.last_rr_ntp_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100298 /*rtcp_timestamp=*/nullptr,
299 /*remote_sender_packet_count=*/nullptr,
300 /*remote_sender_octet_count=*/nullptr,
301 /*remote_sender_reports_count=*/nullptr)) {
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100302 state.remote_sr = ((received_ntp_secs & 0x0000ffff) << 16) +
303 ((received_ntp_frac & 0xffff0000) >> 16);
304 }
Tommi3a5742c2020-05-20 09:32:51 +0200305
306 state.last_xr_rtis = rtcp_receiver_.ConsumeReceivedXrReferenceTimeInfo();
307
308 return state;
309}
310
311// TODO(nisse): This method shouldn't be called for a receive-only
312// stream. Delete rtp_sender_ check as soon as all applications are
313// updated.
314int32_t ModuleRtpRtcpImpl2::SetSendingStatus(const bool sending) {
315 if (rtcp_sender_.Sending() != sending) {
316 // Sends RTCP BYE when going from true to false
Tomas Gunnarssondbcf5d32021-04-23 20:31:08 +0200317 rtcp_sender_.SetSendingStatus(GetFeedbackState(), sending);
Tommi3a5742c2020-05-20 09:32:51 +0200318 }
319 return 0;
320}
321
322bool ModuleRtpRtcpImpl2::Sending() const {
323 return rtcp_sender_.Sending();
324}
325
326// TODO(nisse): This method shouldn't be called for a receive-only
327// stream. Delete rtp_sender_ check as soon as all applications are
328// updated.
329void ModuleRtpRtcpImpl2::SetSendingMediaStatus(const bool sending) {
330 if (rtp_sender_) {
Erik Språngbb904972021-08-06 13:10:11 +0200331 // Turning on or off sending status indicates module being set
332 // up or torn down, detach thread checker since subsequent calls
333 // may be from a different thread.
334 if (rtp_sender_->packet_generator.SendingMedia() != sending) {
335 pacer_thread_checker_.Detach();
336 }
Tommi3a5742c2020-05-20 09:32:51 +0200337 rtp_sender_->packet_generator.SetSendingMediaStatus(sending);
338 } else {
339 RTC_DCHECK(!sending);
340 }
341}
342
343bool ModuleRtpRtcpImpl2::SendingMedia() const {
344 return rtp_sender_ ? rtp_sender_->packet_generator.SendingMedia() : false;
345}
346
347bool ModuleRtpRtcpImpl2::IsAudioConfigured() const {
348 return rtp_sender_ ? rtp_sender_->packet_generator.IsAudioConfigured()
349 : false;
350}
351
352void ModuleRtpRtcpImpl2::SetAsPartOfAllocation(bool part_of_allocation) {
353 RTC_CHECK(rtp_sender_);
354 rtp_sender_->packet_sender.ForceIncludeSendPacketsInAllocation(
355 part_of_allocation);
356}
357
358bool ModuleRtpRtcpImpl2::OnSendingRtpFrame(uint32_t timestamp,
359 int64_t capture_time_ms,
360 int payload_type,
361 bool force_sender_report) {
362 if (!Sending())
363 return false;
364
Markus Handellc6b9ac72021-06-18 13:44:51 +0200365 // TODO(bugs.webrtc.org/12873): Migrate this method and it's users to use
366 // optional Timestamps.
367 absl::optional<Timestamp> capture_time;
368 if (capture_time_ms > 0) {
369 capture_time = Timestamp::Millis(capture_time_ms);
370 }
371 absl::optional<int> payload_type_optional;
372 if (payload_type >= 0)
373 payload_type_optional = payload_type;
374 rtcp_sender_.SetLastRtpTime(timestamp, capture_time, payload_type_optional);
Tommi3a5742c2020-05-20 09:32:51 +0200375 // Make sure an RTCP report isn't queued behind a key frame.
376 if (rtcp_sender_.TimeToSendRTCPReport(force_sender_report))
377 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
378
379 return true;
380}
381
382bool ModuleRtpRtcpImpl2::TrySendPacket(RtpPacketToSend* packet,
383 const PacedPacketInfo& pacing_info) {
384 RTC_DCHECK(rtp_sender_);
Erik Språngbb904972021-08-06 13:10:11 +0200385 RTC_DCHECK_RUN_ON(&pacer_thread_checker_);
386 if (rtp_sender_->deferred_sequencing_) {
387 RTC_DCHECK(rtp_sender_->packet_generator.SendingMedia());
388 if (packet->packet_type() == RtpPacketMediaType::kPadding &&
389 packet->Ssrc() == rtp_sender_->packet_generator.SSRC() &&
390 !rtp_sender_->sequencer_.CanSendPaddingOnMediaSsrc()) {
391 // New media packet preempted this generated padding packet, discard it.
392 return false;
393 }
394 bool is_flexfec =
395 packet->packet_type() == RtpPacketMediaType::kForwardErrorCorrection &&
396 packet->Ssrc() == rtp_sender_->packet_generator.FlexfecSsrc();
397 if (!is_flexfec) {
398 rtp_sender_->sequencer_.Sequence(*packet);
399 }
400 } else if (!rtp_sender_->packet_generator.SendingMedia()) {
Tommi3a5742c2020-05-20 09:32:51 +0200401 return false;
402 }
403 rtp_sender_->packet_sender.SendPacket(packet, pacing_info);
404 return true;
405}
406
Erik Språng1d50cb62020-07-02 17:41:32 +0200407void ModuleRtpRtcpImpl2::SetFecProtectionParams(
408 const FecProtectionParams& delta_params,
409 const FecProtectionParams& key_params) {
410 RTC_DCHECK(rtp_sender_);
411 rtp_sender_->packet_sender.SetFecProtectionParameters(delta_params,
412 key_params);
413}
414
415std::vector<std::unique_ptr<RtpPacketToSend>>
416ModuleRtpRtcpImpl2::FetchFecPackets() {
417 RTC_DCHECK(rtp_sender_);
Erik Språngbb904972021-08-06 13:10:11 +0200418 RTC_DCHECK_RUN_ON(&pacer_thread_checker_);
Erik Språng1d50cb62020-07-02 17:41:32 +0200419 auto fec_packets = rtp_sender_->packet_sender.FetchFecPackets();
Erik Språngbb904972021-08-06 13:10:11 +0200420 if (!fec_packets.empty() && !rtp_sender_->deferred_sequencing_) {
421 // Only assign sequence numbers for FEC packets in non-deferred mode, and
422 // never for FlexFEC which has as separate sequence number series.
Erik Språng1d50cb62020-07-02 17:41:32 +0200423 const bool generate_sequence_numbers =
424 !rtp_sender_->packet_sender.FlexFecSsrc().has_value();
425 if (generate_sequence_numbers) {
426 for (auto& fec_packet : fec_packets) {
427 rtp_sender_->packet_generator.AssignSequenceNumber(fec_packet.get());
428 }
429 }
430 }
431 return fec_packets;
432}
433
Tommi3a5742c2020-05-20 09:32:51 +0200434void ModuleRtpRtcpImpl2::OnPacketsAcknowledged(
435 rtc::ArrayView<const uint16_t> sequence_numbers) {
436 RTC_DCHECK(rtp_sender_);
437 rtp_sender_->packet_history.CullAcknowledgedPackets(sequence_numbers);
438}
439
440bool ModuleRtpRtcpImpl2::SupportsPadding() const {
441 RTC_DCHECK(rtp_sender_);
442 return rtp_sender_->packet_generator.SupportsPadding();
443}
444
445bool ModuleRtpRtcpImpl2::SupportsRtxPayloadPadding() const {
446 RTC_DCHECK(rtp_sender_);
447 return rtp_sender_->packet_generator.SupportsRtxPayloadPadding();
448}
449
450std::vector<std::unique_ptr<RtpPacketToSend>>
451ModuleRtpRtcpImpl2::GeneratePadding(size_t target_size_bytes) {
452 RTC_DCHECK(rtp_sender_);
Erik Språngbb904972021-08-06 13:10:11 +0200453
Erik Språng51e30832021-08-05 16:15:14 +0200454 // `can_send_padding_on_media_ssrc` set to false but is ignored at this
455 // point, RTPSender will internally query `sequencer_` while holding the
456 // send lock.
Erik Språngbb904972021-08-06 13:10:11 +0200457 RTC_DCHECK_RUN_ON(&pacer_thread_checker_);
458
459 // `can_send_padding_on_media_ssrc` set to false when deferred sequencing
460 // is off. It will be ignored in that case, RTPSender will internally query
461 // `sequencer_` while holding the send lock instead.
Tommi3a5742c2020-05-20 09:32:51 +0200462 return rtp_sender_->packet_generator.GeneratePadding(
Erik Språngbfcfe032021-08-04 14:45:32 +0200463 target_size_bytes, rtp_sender_->packet_sender.MediaHasBeenSent(),
Erik Språngbb904972021-08-06 13:10:11 +0200464
465 rtp_sender_->deferred_sequencing_
466 ? rtp_sender_->sequencer_.CanSendPaddingOnMediaSsrc()
467 : false);
Tommi3a5742c2020-05-20 09:32:51 +0200468}
469
470std::vector<RtpSequenceNumberMap::Info>
471ModuleRtpRtcpImpl2::GetSentRtpPacketInfos(
472 rtc::ArrayView<const uint16_t> sequence_numbers) const {
473 RTC_DCHECK(rtp_sender_);
474 return rtp_sender_->packet_sender.GetSentRtpPacketInfos(sequence_numbers);
475}
476
477size_t ModuleRtpRtcpImpl2::ExpectedPerPacketOverhead() const {
478 if (!rtp_sender_) {
479 return 0;
480 }
481 return rtp_sender_->packet_generator.ExpectedPerPacketOverhead();
482}
483
484size_t ModuleRtpRtcpImpl2::MaxRtpPacketSize() const {
485 RTC_DCHECK(rtp_sender_);
486 return rtp_sender_->packet_generator.MaxRtpPacketSize();
487}
488
489void ModuleRtpRtcpImpl2::SetMaxRtpPacketSize(size_t rtp_packet_size) {
490 RTC_DCHECK_LE(rtp_packet_size, IP_PACKET_SIZE)
491 << "rtp packet size too large: " << rtp_packet_size;
492 RTC_DCHECK_GT(rtp_packet_size, packet_overhead_)
493 << "rtp packet size too small: " << rtp_packet_size;
494
495 rtcp_sender_.SetMaxRtpPacketSize(rtp_packet_size);
496 if (rtp_sender_) {
497 rtp_sender_->packet_generator.SetMaxRtpPacketSize(rtp_packet_size);
498 }
499}
500
501RtcpMode ModuleRtpRtcpImpl2::RTCP() const {
502 return rtcp_sender_.Status();
503}
504
505// Configure RTCP status i.e on/off.
506void ModuleRtpRtcpImpl2::SetRTCPStatus(const RtcpMode method) {
507 rtcp_sender_.SetRTCPStatus(method);
508}
509
510int32_t ModuleRtpRtcpImpl2::SetCNAME(const char* c_name) {
511 return rtcp_sender_.SetCNAME(c_name);
512}
513
Tommi3a5742c2020-05-20 09:32:51 +0200514int32_t ModuleRtpRtcpImpl2::RemoteNTP(uint32_t* received_ntpsecs,
515 uint32_t* received_ntpfrac,
516 uint32_t* rtcp_arrival_time_secs,
517 uint32_t* rtcp_arrival_time_frac,
518 uint32_t* rtcp_timestamp) const {
519 return rtcp_receiver_.NTP(received_ntpsecs, received_ntpfrac,
520 rtcp_arrival_time_secs, rtcp_arrival_time_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100521 rtcp_timestamp,
522 /*remote_sender_packet_count=*/nullptr,
523 /*remote_sender_octet_count=*/nullptr,
524 /*remote_sender_reports_count=*/nullptr)
Tommi3a5742c2020-05-20 09:32:51 +0200525 ? 0
526 : -1;
527}
528
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200529// TODO(tommi): Check if |avg_rtt_ms|, |min_rtt_ms|, |max_rtt_ms| params are
530// actually used in practice (some callers ask for it but don't use it). It
531// could be that only |rtt| is needed and if so, then the fast path could be to
532// just call rtt_ms() and rely on the calculation being done periodically.
Tommi3a5742c2020-05-20 09:32:51 +0200533int32_t ModuleRtpRtcpImpl2::RTT(const uint32_t remote_ssrc,
534 int64_t* rtt,
535 int64_t* avg_rtt,
536 int64_t* min_rtt,
537 int64_t* max_rtt) const {
538 int32_t ret = rtcp_receiver_.RTT(remote_ssrc, rtt, avg_rtt, min_rtt, max_rtt);
539 if (rtt && *rtt == 0) {
540 // Try to get RTT from RtcpRttStats class.
541 *rtt = rtt_ms();
542 }
543 return ret;
544}
545
546int64_t ModuleRtpRtcpImpl2::ExpectedRetransmissionTimeMs() const {
547 int64_t expected_retransmission_time_ms = rtt_ms();
548 if (expected_retransmission_time_ms > 0) {
549 return expected_retransmission_time_ms;
550 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200551 // No rtt available (|kRttUpdateInterval| not yet passed?), so try to
Tommi3a5742c2020-05-20 09:32:51 +0200552 // poll avg_rtt_ms directly from rtcp receiver.
553 if (rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), nullptr,
554 &expected_retransmission_time_ms, nullptr,
555 nullptr) == 0) {
556 return expected_retransmission_time_ms;
557 }
558 return kDefaultExpectedRetransmissionTimeMs;
559}
560
561// Force a send of an RTCP packet.
562// Normal SR and RR are triggered via the process function.
563int32_t ModuleRtpRtcpImpl2::SendRTCP(RTCPPacketType packet_type) {
564 return rtcp_sender_.SendRTCP(GetFeedbackState(), packet_type);
565}
566
Tommi3a5742c2020-05-20 09:32:51 +0200567void ModuleRtpRtcpImpl2::GetSendStreamDataCounters(
568 StreamDataCounters* rtp_counters,
569 StreamDataCounters* rtx_counters) const {
570 rtp_sender_->packet_sender.GetDataCounters(rtp_counters, rtx_counters);
571}
572
573// Received RTCP report.
Tommi3a5742c2020-05-20 09:32:51 +0200574std::vector<ReportBlockData> ModuleRtpRtcpImpl2::GetLatestReportBlockData()
575 const {
576 return rtcp_receiver_.GetLatestReportBlockData();
577}
578
Alessio Bazzicabc1c93d2021-03-12 17:45:26 +0100579absl::optional<RtpRtcpInterface::SenderReportStats>
580ModuleRtpRtcpImpl2::GetSenderReportStats() const {
581 SenderReportStats stats;
582 uint32_t remote_timestamp_secs;
583 uint32_t remote_timestamp_frac;
584 uint32_t arrival_timestamp_secs;
585 uint32_t arrival_timestamp_frac;
586 if (rtcp_receiver_.NTP(&remote_timestamp_secs, &remote_timestamp_frac,
587 &arrival_timestamp_secs, &arrival_timestamp_frac,
588 /*rtcp_timestamp=*/nullptr, &stats.packets_sent,
589 &stats.bytes_sent, &stats.reports_count)) {
590 stats.last_remote_timestamp.Set(remote_timestamp_secs,
591 remote_timestamp_frac);
592 stats.last_arrival_timestamp.Set(arrival_timestamp_secs,
593 arrival_timestamp_frac);
594 return stats;
595 }
596 return absl::nullopt;
597}
598
Tommi3a5742c2020-05-20 09:32:51 +0200599// (REMB) Receiver Estimated Max Bitrate.
600void ModuleRtpRtcpImpl2::SetRemb(int64_t bitrate_bps,
601 std::vector<uint32_t> ssrcs) {
602 rtcp_sender_.SetRemb(bitrate_bps, std::move(ssrcs));
603}
604
605void ModuleRtpRtcpImpl2::UnsetRemb() {
606 rtcp_sender_.UnsetRemb();
607}
608
609void ModuleRtpRtcpImpl2::SetExtmapAllowMixed(bool extmap_allow_mixed) {
610 rtp_sender_->packet_generator.SetExtmapAllowMixed(extmap_allow_mixed);
611}
612
Tommi3a5742c2020-05-20 09:32:51 +0200613void ModuleRtpRtcpImpl2::RegisterRtpHeaderExtension(absl::string_view uri,
614 int id) {
615 bool registered =
616 rtp_sender_->packet_generator.RegisterRtpHeaderExtension(uri, id);
617 RTC_CHECK(registered);
618}
619
620int32_t ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
621 const RTPExtensionType type) {
622 return rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(type);
623}
624void ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
625 absl::string_view uri) {
626 rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(uri);
627}
628
Tommi3a5742c2020-05-20 09:32:51 +0200629void ModuleRtpRtcpImpl2::SetTmmbn(std::vector<rtcp::TmmbItem> bounding_set) {
630 rtcp_sender_.SetTmmbn(std::move(bounding_set));
631}
632
633// Send a Negative acknowledgment packet.
634int32_t ModuleRtpRtcpImpl2::SendNACK(const uint16_t* nack_list,
635 const uint16_t size) {
636 uint16_t nack_length = size;
637 uint16_t start_id = 0;
638 int64_t now_ms = clock_->TimeInMilliseconds();
639 if (TimeToSendFullNackList(now_ms)) {
640 nack_last_time_sent_full_ms_ = now_ms;
641 } else {
642 // Only send extended list.
643 if (nack_last_seq_number_sent_ == nack_list[size - 1]) {
644 // Last sequence number is the same, do not send list.
645 return 0;
646 }
647 // Send new sequence numbers.
648 for (int i = 0; i < size; ++i) {
649 if (nack_last_seq_number_sent_ == nack_list[i]) {
650 start_id = i + 1;
651 break;
652 }
653 }
654 nack_length = size - start_id;
655 }
656
657 // Our RTCP NACK implementation is limited to kRtcpMaxNackFields sequence
658 // numbers per RTCP packet.
659 if (nack_length > kRtcpMaxNackFields) {
660 nack_length = kRtcpMaxNackFields;
661 }
662 nack_last_seq_number_sent_ = nack_list[start_id + nack_length - 1];
663
664 return rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, nack_length,
665 &nack_list[start_id]);
666}
667
668void ModuleRtpRtcpImpl2::SendNack(
669 const std::vector<uint16_t>& sequence_numbers) {
670 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, sequence_numbers.size(),
671 sequence_numbers.data());
672}
673
674bool ModuleRtpRtcpImpl2::TimeToSendFullNackList(int64_t now) const {
675 // Use RTT from RtcpRttStats class if provided.
676 int64_t rtt = rtt_ms();
677 if (rtt == 0) {
678 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
679 }
680
681 const int64_t kStartUpRttMs = 100;
682 int64_t wait_time = 5 + ((rtt * 3) >> 1); // 5 + RTT * 1.5.
683 if (rtt == 0) {
684 wait_time = kStartUpRttMs;
685 }
686
687 // Send a full NACK list once within every |wait_time|.
688 return now - nack_last_time_sent_full_ms_ > wait_time;
689}
690
691// Store the sent packets, needed to answer to Negative acknowledgment requests.
692void ModuleRtpRtcpImpl2::SetStorePacketsStatus(const bool enable,
693 const uint16_t number_to_store) {
694 rtp_sender_->packet_history.SetStorePacketsStatus(
695 enable ? RtpPacketHistory::StorageMode::kStoreAndCull
696 : RtpPacketHistory::StorageMode::kDisabled,
697 number_to_store);
698}
699
700bool ModuleRtpRtcpImpl2::StorePackets() const {
701 return rtp_sender_->packet_history.GetStorageMode() !=
702 RtpPacketHistory::StorageMode::kDisabled;
703}
704
705void ModuleRtpRtcpImpl2::SendCombinedRtcpPacket(
706 std::vector<std::unique_ptr<rtcp::RtcpPacket>> rtcp_packets) {
707 rtcp_sender_.SendCombinedRtcpPacket(std::move(rtcp_packets));
708}
709
710int32_t ModuleRtpRtcpImpl2::SendLossNotification(uint16_t last_decoded_seq_num,
711 uint16_t last_received_seq_num,
712 bool decodability_flag,
713 bool buffering_allowed) {
714 return rtcp_sender_.SendLossNotification(
715 GetFeedbackState(), last_decoded_seq_num, last_received_seq_num,
716 decodability_flag, buffering_allowed);
717}
718
719void ModuleRtpRtcpImpl2::SetRemoteSSRC(const uint32_t ssrc) {
720 // Inform about the incoming SSRC.
721 rtcp_sender_.SetRemoteSSRC(ssrc);
722 rtcp_receiver_.SetRemoteSSRC(ssrc);
723}
724
Tommi08be9ba2021-06-15 23:01:57 +0200725void ModuleRtpRtcpImpl2::SetLocalSsrc(uint32_t local_ssrc) {
726 RTC_DCHECK_RUN_ON(&packet_sequence_checker_);
727 rtcp_receiver_.set_local_media_ssrc(local_ssrc);
728 rtcp_sender_.SetSsrc(local_ssrc);
729}
730
Tommi3a5742c2020-05-20 09:32:51 +0200731RtpSendRates ModuleRtpRtcpImpl2::GetSendRates() const {
Tommi1050fbc2021-06-03 17:58:28 +0200732 // Typically called on the `rtp_transport_queue_` owned by an
733 // RtpTransportControllerSendInterface instance.
Tommi3a5742c2020-05-20 09:32:51 +0200734 return rtp_sender_->packet_sender.GetSendRates();
735}
736
737void ModuleRtpRtcpImpl2::OnRequestSendReport() {
738 SendRTCP(kRtcpSr);
739}
740
741void ModuleRtpRtcpImpl2::OnReceivedNack(
742 const std::vector<uint16_t>& nack_sequence_numbers) {
743 if (!rtp_sender_)
744 return;
745
746 if (!StorePackets() || nack_sequence_numbers.empty()) {
747 return;
748 }
749 // Use RTT from RtcpRttStats class if provided.
750 int64_t rtt = rtt_ms();
751 if (rtt == 0) {
752 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
753 }
754 rtp_sender_->packet_generator.OnReceivedNack(nack_sequence_numbers, rtt);
755}
756
757void ModuleRtpRtcpImpl2::OnReceivedRtcpReportBlocks(
758 const ReportBlockList& report_blocks) {
759 if (rtp_sender_) {
760 uint32_t ssrc = SSRC();
761 absl::optional<uint32_t> rtx_ssrc;
762 if (rtp_sender_->packet_generator.RtxStatus() != kRtxOff) {
763 rtx_ssrc = rtp_sender_->packet_generator.RtxSsrc();
764 }
765
766 for (const RTCPReportBlock& report_block : report_blocks) {
767 if (ssrc == report_block.source_ssrc) {
768 rtp_sender_->packet_generator.OnReceivedAckOnSsrc(
769 report_block.extended_highest_sequence_number);
770 } else if (rtx_ssrc && *rtx_ssrc == report_block.source_ssrc) {
771 rtp_sender_->packet_generator.OnReceivedAckOnRtxSsrc(
772 report_block.extended_highest_sequence_number);
773 }
774 }
775 }
776}
777
Tommi3a5742c2020-05-20 09:32:51 +0200778void ModuleRtpRtcpImpl2::set_rtt_ms(int64_t rtt_ms) {
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200779 RTC_DCHECK_RUN_ON(worker_queue_);
Tommi3a5742c2020-05-20 09:32:51 +0200780 {
Markus Handellf7303e62020-07-09 01:34:42 +0200781 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200782 rtt_ms_ = rtt_ms;
783 }
784 if (rtp_sender_) {
785 rtp_sender_->packet_history.SetRtt(rtt_ms);
786 }
787}
788
789int64_t ModuleRtpRtcpImpl2::rtt_ms() const {
Markus Handellf7303e62020-07-09 01:34:42 +0200790 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200791 return rtt_ms_;
792}
793
794void ModuleRtpRtcpImpl2::SetVideoBitrateAllocation(
795 const VideoBitrateAllocation& bitrate) {
796 rtcp_sender_.SetVideoBitrateAllocation(bitrate);
797}
798
799RTPSender* ModuleRtpRtcpImpl2::RtpSender() {
800 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
801}
802
803const RTPSender* ModuleRtpRtcpImpl2::RtpSender() const {
804 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
805}
806
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200807void ModuleRtpRtcpImpl2::PeriodicUpdate() {
808 RTC_DCHECK_RUN_ON(worker_queue_);
809
810 Timestamp check_since = clock_->CurrentTime() - kRttUpdateInterval;
811 absl::optional<TimeDelta> rtt =
812 rtcp_receiver_.OnPeriodicRttUpdate(check_since, rtcp_sender_.Sending());
813 if (rtt) {
Ivo Creusen8c40d512021-07-13 12:53:22 +0000814 if (rtt_stats_) {
815 rtt_stats_->OnRttUpdate(rtt->ms());
816 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200817 set_rtt_ms(rtt->ms());
818 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200819}
820
Markus Handell885d5382021-06-21 18:57:36 +0200821// RTC_RUN_ON(worker_queue_);
822void ModuleRtpRtcpImpl2::MaybeSendRtcp() {
823 if (rtcp_sender_.TimeToSendRTCPReport())
824 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
825}
826
827// TODO(bugs.webrtc.org/12889): Consider removing this function when the issue
828// is resolved.
829// RTC_RUN_ON(worker_queue_);
830void ModuleRtpRtcpImpl2::MaybeSendRtcpAtOrAfterTimestamp(
831 Timestamp execution_time) {
832 Timestamp now = clock_->CurrentTime();
833 if (now >= execution_time) {
834 MaybeSendRtcp();
835 return;
836 }
837
838 RTC_DLOG(LS_WARNING)
839 << "BUGBUG: Task queue scheduled delayed call too early.";
840
841 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, execution_time - now);
842}
843
844void ModuleRtpRtcpImpl2::ScheduleRtcpSendEvaluation(TimeDelta duration) {
845 // We end up here under various sequences including the worker queue, and
846 // the RTCPSender lock is held.
847 // We're assuming that the fact that RTCPSender executes under other sequences
848 // than the worker queue on which it's created on implies that external
849 // synchronization is present and removes this activity before destruction.
850 if (duration.IsZero()) {
851 worker_queue_->PostTask(ToQueuedTask(task_safety_, [this] {
852 RTC_DCHECK_RUN_ON(worker_queue_);
853 MaybeSendRtcp();
854 }));
855 } else {
856 Timestamp execution_time = clock_->CurrentTime() + duration;
857 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, duration);
858 }
859}
860
861void ModuleRtpRtcpImpl2::ScheduleMaybeSendRtcpAtOrAfterTimestamp(
862 Timestamp execution_time,
863 TimeDelta duration) {
864 // We end up here under various sequences including the worker queue, and
865 // the RTCPSender lock is held.
866 // See note in ScheduleRtcpSendEvaluation about why |worker_queue_| can be
867 // accessed.
868 worker_queue_->PostDelayedTask(
869 ToQueuedTask(task_safety_,
870 [this, execution_time] {
871 RTC_DCHECK_RUN_ON(worker_queue_);
872 MaybeSendRtcpAtOrAfterTimestamp(execution_time);
873 }),
874 DelayMillisForDuration(duration));
875}
876
Tommi3a5742c2020-05-20 09:32:51 +0200877} // namespace webrtc