blob: af64ddb269ab5feec6ca42308d95f2f409d5aa4a [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ångbfcfe032021-08-04 14:45:32 +020066 sequencer_(config.local_media_ssrc,
67 config.rtx_send_ssrc,
68 /*require_marker_before_media_padding=*/!config.audio,
69 config.clock),
Tommi3a5742c2020-05-20 09:32:51 +020070 packet_sender(config, &packet_history),
Erik Språng1d50cb62020-07-02 17:41:32 +020071 non_paced_sender(&packet_sender, this),
Tommi3a5742c2020-05-20 09:32:51 +020072 packet_generator(
73 config,
74 &packet_history,
Erik Språngbfcfe032021-08-04 14:45:32 +020075 config.paced_sender ? config.paced_sender : &non_paced_sender,
76 &sequencer_) {}
Erik Språng1d50cb62020-07-02 17:41:32 +020077void ModuleRtpRtcpImpl2::RtpSenderContext::AssignSequenceNumber(
78 RtpPacketToSend* packet) {
79 packet_generator.AssignSequenceNumber(packet);
80}
Tommi3a5742c2020-05-20 09:32:51 +020081
Tommi3a5742c2020-05-20 09:32:51 +020082ModuleRtpRtcpImpl2::ModuleRtpRtcpImpl2(const Configuration& configuration)
Niels Moller2accc7d2021-01-12 15:54:16 +000083 : worker_queue_(TaskQueueBase::Current()),
Markus Handell885d5382021-06-21 18:57:36 +020084 rtcp_sender_(AddRtcpSendEvaluationCallback(
85 RTCPSender::Configuration::FromRtpRtcpConfiguration(configuration),
86 [this](TimeDelta duration) {
87 ScheduleRtcpSendEvaluation(duration);
88 })),
Tommi3a5742c2020-05-20 09:32:51 +020089 rtcp_receiver_(configuration, this),
90 clock_(configuration.clock),
Tommi3a5742c2020-05-20 09:32:51 +020091 packet_overhead_(28), // IPV4 UDP.
92 nack_last_time_sent_full_ms_(0),
93 nack_last_seq_number_sent_(0),
94 remote_bitrate_(configuration.remote_bitrate_estimator),
95 rtt_stats_(configuration.rtt_stats),
96 rtt_ms_(0) {
Niels Moller2accc7d2021-01-12 15:54:16 +000097 RTC_DCHECK(worker_queue_);
Tommi08be9ba2021-06-15 23:01:57 +020098 packet_sequence_checker_.Detach();
Tommi3a5742c2020-05-20 09:32:51 +020099 if (!configuration.receiver_only) {
100 rtp_sender_ = std::make_unique<RtpSenderContext>(configuration);
101 // Make sure rtcp sender use same timestamp offset as rtp sender.
102 rtcp_sender_.SetTimestampOffset(
103 rtp_sender_->packet_generator.TimestampOffset());
104 }
105
106 // Set default packet size limit.
107 // TODO(nisse): Kind-of duplicates
108 // webrtc::VideoSendStream::Config::Rtp::kDefaultMaxPacketSize.
109 const size_t kTcpOverIpv4HeaderSize = 40;
110 SetMaxRtpPacketSize(IP_PACKET_SIZE - kTcpOverIpv4HeaderSize);
Ivo Creusen8c40d512021-07-13 12:53:22 +0000111 rtt_update_task_ = RepeatingTaskHandle::DelayedStart(
112 worker_queue_, kRttUpdateInterval, [this]() {
113 PeriodicUpdate();
114 return kRttUpdateInterval;
115 });
Tommi3a5742c2020-05-20 09:32:51 +0200116}
117
118ModuleRtpRtcpImpl2::~ModuleRtpRtcpImpl2() {
Niels Moller2accc7d2021-01-12 15:54:16 +0000119 RTC_DCHECK_RUN_ON(worker_queue_);
120 rtt_update_task_.Stop();
121}
122
123// static
124std::unique_ptr<ModuleRtpRtcpImpl2> ModuleRtpRtcpImpl2::Create(
125 const Configuration& configuration) {
126 RTC_DCHECK(configuration.clock);
127 RTC_DCHECK(TaskQueueBase::Current());
128 return std::make_unique<ModuleRtpRtcpImpl2>(configuration);
Tomas Gunnarssonfae05622020-06-03 08:54:39 +0200129}
130
Tommi3a5742c2020-05-20 09:32:51 +0200131void ModuleRtpRtcpImpl2::SetRtxSendStatus(int mode) {
132 rtp_sender_->packet_generator.SetRtxStatus(mode);
133}
134
135int ModuleRtpRtcpImpl2::RtxSendStatus() const {
136 return rtp_sender_ ? rtp_sender_->packet_generator.RtxStatus() : kRtxOff;
137}
138
139void ModuleRtpRtcpImpl2::SetRtxSendPayloadType(int payload_type,
140 int associated_payload_type) {
141 rtp_sender_->packet_generator.SetRtxPayloadType(payload_type,
142 associated_payload_type);
143}
144
145absl::optional<uint32_t> ModuleRtpRtcpImpl2::RtxSsrc() const {
146 return rtp_sender_ ? rtp_sender_->packet_generator.RtxSsrc() : absl::nullopt;
147}
148
149absl::optional<uint32_t> ModuleRtpRtcpImpl2::FlexfecSsrc() const {
150 if (rtp_sender_) {
151 return rtp_sender_->packet_generator.FlexfecSsrc();
152 }
153 return absl::nullopt;
154}
155
156void ModuleRtpRtcpImpl2::IncomingRtcpPacket(const uint8_t* rtcp_packet,
157 const size_t length) {
Tommi08be9ba2021-06-15 23:01:57 +0200158 RTC_DCHECK_RUN_ON(&packet_sequence_checker_);
Tommi3a5742c2020-05-20 09:32:51 +0200159 rtcp_receiver_.IncomingPacket(rtcp_packet, length);
160}
161
162void ModuleRtpRtcpImpl2::RegisterSendPayloadFrequency(int payload_type,
163 int payload_frequency) {
164 rtcp_sender_.SetRtpClockRate(payload_type, payload_frequency);
165}
166
167int32_t ModuleRtpRtcpImpl2::DeRegisterSendPayload(const int8_t payload_type) {
168 return 0;
169}
170
171uint32_t ModuleRtpRtcpImpl2::StartTimestamp() const {
172 return rtp_sender_->packet_generator.TimestampOffset();
173}
174
175// Configure start timestamp, default is a random number.
176void ModuleRtpRtcpImpl2::SetStartTimestamp(const uint32_t timestamp) {
177 rtcp_sender_.SetTimestampOffset(timestamp);
178 rtp_sender_->packet_generator.SetTimestampOffset(timestamp);
179 rtp_sender_->packet_sender.SetTimestampOffset(timestamp);
180}
181
182uint16_t ModuleRtpRtcpImpl2::SequenceNumber() const {
183 return rtp_sender_->packet_generator.SequenceNumber();
184}
185
186// Set SequenceNumber, default is a random number.
187void ModuleRtpRtcpImpl2::SetSequenceNumber(const uint16_t seq_num) {
188 rtp_sender_->packet_generator.SetSequenceNumber(seq_num);
189}
190
191void ModuleRtpRtcpImpl2::SetRtpState(const RtpState& rtp_state) {
192 rtp_sender_->packet_generator.SetRtpState(rtp_state);
Tommi3a5742c2020-05-20 09:32:51 +0200193 rtcp_sender_.SetTimestampOffset(rtp_state.start_timestamp);
194}
195
196void ModuleRtpRtcpImpl2::SetRtxState(const RtpState& rtp_state) {
197 rtp_sender_->packet_generator.SetRtxRtpState(rtp_state);
198}
199
200RtpState ModuleRtpRtcpImpl2::GetRtpState() const {
201 RtpState state = rtp_sender_->packet_generator.GetRtpState();
Tommi3a5742c2020-05-20 09:32:51 +0200202 return state;
203}
204
205RtpState ModuleRtpRtcpImpl2::GetRtxState() const {
206 return rtp_sender_->packet_generator.GetRtxRtpState();
207}
208
Ivo Creusen8c40d512021-07-13 12:53:22 +0000209void ModuleRtpRtcpImpl2::SetNonSenderRttMeasurement(bool enabled) {
210 rtcp_sender_.SetNonSenderRttMeasurement(enabled);
211 rtcp_receiver_.SetNonSenderRttMeasurement(enabled);
212}
213
Tommi08be9ba2021-06-15 23:01:57 +0200214uint32_t ModuleRtpRtcpImpl2::local_media_ssrc() const {
215 RTC_DCHECK_RUN_ON(&packet_sequence_checker_);
216 RTC_DCHECK_EQ(rtcp_receiver_.local_media_ssrc(), rtcp_sender_.SSRC());
217 return rtcp_receiver_.local_media_ssrc();
218}
219
Tommi3a5742c2020-05-20 09:32:51 +0200220void ModuleRtpRtcpImpl2::SetRid(const std::string& rid) {
221 if (rtp_sender_) {
222 rtp_sender_->packet_generator.SetRid(rid);
223 }
224}
225
226void ModuleRtpRtcpImpl2::SetMid(const std::string& mid) {
227 if (rtp_sender_) {
228 rtp_sender_->packet_generator.SetMid(mid);
229 }
230 // TODO(bugs.webrtc.org/4050): If we end up supporting the MID SDES item for
231 // RTCP, this will need to be passed down to the RTCPSender also.
232}
233
234void ModuleRtpRtcpImpl2::SetCsrcs(const std::vector<uint32_t>& csrcs) {
235 rtcp_sender_.SetCsrcs(csrcs);
236 rtp_sender_->packet_generator.SetCsrcs(csrcs);
237}
238
239// TODO(pbos): Handle media and RTX streams separately (separate RTCP
240// feedbacks).
241RTCPSender::FeedbackState ModuleRtpRtcpImpl2::GetFeedbackState() {
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200242 // TODO(bugs.webrtc.org/11581): Called by potentially multiple threads.
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200243 // Mostly "Send*" methods. Make sure it's only called on the
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200244 // construction thread.
245
Tommi3a5742c2020-05-20 09:32:51 +0200246 RTCPSender::FeedbackState state;
247 // This is called also when receiver_only is true. Hence below
248 // checks that rtp_sender_ exists.
249 if (rtp_sender_) {
250 StreamDataCounters rtp_stats;
251 StreamDataCounters rtx_stats;
252 rtp_sender_->packet_sender.GetDataCounters(&rtp_stats, &rtx_stats);
253 state.packets_sent =
254 rtp_stats.transmitted.packets + rtx_stats.transmitted.packets;
255 state.media_bytes_sent = rtp_stats.transmitted.payload_bytes +
256 rtx_stats.transmitted.payload_bytes;
257 state.send_bitrate =
258 rtp_sender_->packet_sender.GetSendRates().Sum().bps<uint32_t>();
259 }
260 state.receiver = &rtcp_receiver_;
261
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100262 uint32_t received_ntp_secs = 0;
263 uint32_t received_ntp_frac = 0;
264 state.remote_sr = 0;
265 if (rtcp_receiver_.NTP(&received_ntp_secs, &received_ntp_frac,
266 /*rtcp_arrival_time_secs=*/&state.last_rr_ntp_secs,
267 /*rtcp_arrival_time_frac=*/&state.last_rr_ntp_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100268 /*rtcp_timestamp=*/nullptr,
269 /*remote_sender_packet_count=*/nullptr,
270 /*remote_sender_octet_count=*/nullptr,
271 /*remote_sender_reports_count=*/nullptr)) {
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100272 state.remote_sr = ((received_ntp_secs & 0x0000ffff) << 16) +
273 ((received_ntp_frac & 0xffff0000) >> 16);
274 }
Tommi3a5742c2020-05-20 09:32:51 +0200275
276 state.last_xr_rtis = rtcp_receiver_.ConsumeReceivedXrReferenceTimeInfo();
277
278 return state;
279}
280
281// TODO(nisse): This method shouldn't be called for a receive-only
282// stream. Delete rtp_sender_ check as soon as all applications are
283// updated.
284int32_t ModuleRtpRtcpImpl2::SetSendingStatus(const bool sending) {
285 if (rtcp_sender_.Sending() != sending) {
286 // Sends RTCP BYE when going from true to false
Tomas Gunnarssondbcf5d32021-04-23 20:31:08 +0200287 rtcp_sender_.SetSendingStatus(GetFeedbackState(), sending);
Tommi3a5742c2020-05-20 09:32:51 +0200288 }
289 return 0;
290}
291
292bool ModuleRtpRtcpImpl2::Sending() const {
293 return rtcp_sender_.Sending();
294}
295
296// TODO(nisse): This method shouldn't be called for a receive-only
297// stream. Delete rtp_sender_ check as soon as all applications are
298// updated.
299void ModuleRtpRtcpImpl2::SetSendingMediaStatus(const bool sending) {
300 if (rtp_sender_) {
301 rtp_sender_->packet_generator.SetSendingMediaStatus(sending);
302 } else {
303 RTC_DCHECK(!sending);
304 }
305}
306
307bool ModuleRtpRtcpImpl2::SendingMedia() const {
308 return rtp_sender_ ? rtp_sender_->packet_generator.SendingMedia() : false;
309}
310
311bool ModuleRtpRtcpImpl2::IsAudioConfigured() const {
312 return rtp_sender_ ? rtp_sender_->packet_generator.IsAudioConfigured()
313 : false;
314}
315
316void ModuleRtpRtcpImpl2::SetAsPartOfAllocation(bool part_of_allocation) {
317 RTC_CHECK(rtp_sender_);
318 rtp_sender_->packet_sender.ForceIncludeSendPacketsInAllocation(
319 part_of_allocation);
320}
321
322bool ModuleRtpRtcpImpl2::OnSendingRtpFrame(uint32_t timestamp,
323 int64_t capture_time_ms,
324 int payload_type,
325 bool force_sender_report) {
326 if (!Sending())
327 return false;
328
Markus Handellc6b9ac72021-06-18 13:44:51 +0200329 // TODO(bugs.webrtc.org/12873): Migrate this method and it's users to use
330 // optional Timestamps.
331 absl::optional<Timestamp> capture_time;
332 if (capture_time_ms > 0) {
333 capture_time = Timestamp::Millis(capture_time_ms);
334 }
335 absl::optional<int> payload_type_optional;
336 if (payload_type >= 0)
337 payload_type_optional = payload_type;
338 rtcp_sender_.SetLastRtpTime(timestamp, capture_time, payload_type_optional);
Tommi3a5742c2020-05-20 09:32:51 +0200339 // Make sure an RTCP report isn't queued behind a key frame.
340 if (rtcp_sender_.TimeToSendRTCPReport(force_sender_report))
341 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
342
343 return true;
344}
345
346bool ModuleRtpRtcpImpl2::TrySendPacket(RtpPacketToSend* packet,
347 const PacedPacketInfo& pacing_info) {
348 RTC_DCHECK(rtp_sender_);
349 // TODO(sprang): Consider if we can remove this check.
350 if (!rtp_sender_->packet_generator.SendingMedia()) {
351 return false;
352 }
353 rtp_sender_->packet_sender.SendPacket(packet, pacing_info);
354 return true;
355}
356
Erik Språng1d50cb62020-07-02 17:41:32 +0200357void ModuleRtpRtcpImpl2::SetFecProtectionParams(
358 const FecProtectionParams& delta_params,
359 const FecProtectionParams& key_params) {
360 RTC_DCHECK(rtp_sender_);
361 rtp_sender_->packet_sender.SetFecProtectionParameters(delta_params,
362 key_params);
363}
364
365std::vector<std::unique_ptr<RtpPacketToSend>>
366ModuleRtpRtcpImpl2::FetchFecPackets() {
367 RTC_DCHECK(rtp_sender_);
368 auto fec_packets = rtp_sender_->packet_sender.FetchFecPackets();
369 if (!fec_packets.empty()) {
370 // Don't assign sequence numbers for FlexFEC packets.
371 const bool generate_sequence_numbers =
372 !rtp_sender_->packet_sender.FlexFecSsrc().has_value();
373 if (generate_sequence_numbers) {
374 for (auto& fec_packet : fec_packets) {
375 rtp_sender_->packet_generator.AssignSequenceNumber(fec_packet.get());
376 }
377 }
378 }
379 return fec_packets;
380}
381
Tommi3a5742c2020-05-20 09:32:51 +0200382void ModuleRtpRtcpImpl2::OnPacketsAcknowledged(
383 rtc::ArrayView<const uint16_t> sequence_numbers) {
384 RTC_DCHECK(rtp_sender_);
385 rtp_sender_->packet_history.CullAcknowledgedPackets(sequence_numbers);
386}
387
388bool ModuleRtpRtcpImpl2::SupportsPadding() const {
389 RTC_DCHECK(rtp_sender_);
390 return rtp_sender_->packet_generator.SupportsPadding();
391}
392
393bool ModuleRtpRtcpImpl2::SupportsRtxPayloadPadding() const {
394 RTC_DCHECK(rtp_sender_);
395 return rtp_sender_->packet_generator.SupportsRtxPayloadPadding();
396}
397
398std::vector<std::unique_ptr<RtpPacketToSend>>
399ModuleRtpRtcpImpl2::GeneratePadding(size_t target_size_bytes) {
400 RTC_DCHECK(rtp_sender_);
Erik Språng51e30832021-08-05 16:15:14 +0200401 // `can_send_padding_on_media_ssrc` set to false but is ignored at this
402 // point, RTPSender will internally query `sequencer_` while holding the
403 // send lock.
Tommi3a5742c2020-05-20 09:32:51 +0200404 return rtp_sender_->packet_generator.GeneratePadding(
Erik Språngbfcfe032021-08-04 14:45:32 +0200405 target_size_bytes, rtp_sender_->packet_sender.MediaHasBeenSent(),
Erik Språng51e30832021-08-05 16:15:14 +0200406 /*can_send_padding_on_media_ssrc=*/false);
Tommi3a5742c2020-05-20 09:32:51 +0200407}
408
409std::vector<RtpSequenceNumberMap::Info>
410ModuleRtpRtcpImpl2::GetSentRtpPacketInfos(
411 rtc::ArrayView<const uint16_t> sequence_numbers) const {
412 RTC_DCHECK(rtp_sender_);
413 return rtp_sender_->packet_sender.GetSentRtpPacketInfos(sequence_numbers);
414}
415
416size_t ModuleRtpRtcpImpl2::ExpectedPerPacketOverhead() const {
417 if (!rtp_sender_) {
418 return 0;
419 }
420 return rtp_sender_->packet_generator.ExpectedPerPacketOverhead();
421}
422
423size_t ModuleRtpRtcpImpl2::MaxRtpPacketSize() const {
424 RTC_DCHECK(rtp_sender_);
425 return rtp_sender_->packet_generator.MaxRtpPacketSize();
426}
427
428void ModuleRtpRtcpImpl2::SetMaxRtpPacketSize(size_t rtp_packet_size) {
429 RTC_DCHECK_LE(rtp_packet_size, IP_PACKET_SIZE)
430 << "rtp packet size too large: " << rtp_packet_size;
431 RTC_DCHECK_GT(rtp_packet_size, packet_overhead_)
432 << "rtp packet size too small: " << rtp_packet_size;
433
434 rtcp_sender_.SetMaxRtpPacketSize(rtp_packet_size);
435 if (rtp_sender_) {
436 rtp_sender_->packet_generator.SetMaxRtpPacketSize(rtp_packet_size);
437 }
438}
439
440RtcpMode ModuleRtpRtcpImpl2::RTCP() const {
441 return rtcp_sender_.Status();
442}
443
444// Configure RTCP status i.e on/off.
445void ModuleRtpRtcpImpl2::SetRTCPStatus(const RtcpMode method) {
446 rtcp_sender_.SetRTCPStatus(method);
447}
448
449int32_t ModuleRtpRtcpImpl2::SetCNAME(const char* c_name) {
450 return rtcp_sender_.SetCNAME(c_name);
451}
452
Tommi3a5742c2020-05-20 09:32:51 +0200453int32_t ModuleRtpRtcpImpl2::RemoteNTP(uint32_t* received_ntpsecs,
454 uint32_t* received_ntpfrac,
455 uint32_t* rtcp_arrival_time_secs,
456 uint32_t* rtcp_arrival_time_frac,
457 uint32_t* rtcp_timestamp) const {
458 return rtcp_receiver_.NTP(received_ntpsecs, received_ntpfrac,
459 rtcp_arrival_time_secs, rtcp_arrival_time_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100460 rtcp_timestamp,
461 /*remote_sender_packet_count=*/nullptr,
462 /*remote_sender_octet_count=*/nullptr,
463 /*remote_sender_reports_count=*/nullptr)
Tommi3a5742c2020-05-20 09:32:51 +0200464 ? 0
465 : -1;
466}
467
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200468// TODO(tommi): Check if |avg_rtt_ms|, |min_rtt_ms|, |max_rtt_ms| params are
469// actually used in practice (some callers ask for it but don't use it). It
470// could be that only |rtt| is needed and if so, then the fast path could be to
471// just call rtt_ms() and rely on the calculation being done periodically.
Tommi3a5742c2020-05-20 09:32:51 +0200472int32_t ModuleRtpRtcpImpl2::RTT(const uint32_t remote_ssrc,
473 int64_t* rtt,
474 int64_t* avg_rtt,
475 int64_t* min_rtt,
476 int64_t* max_rtt) const {
477 int32_t ret = rtcp_receiver_.RTT(remote_ssrc, rtt, avg_rtt, min_rtt, max_rtt);
478 if (rtt && *rtt == 0) {
479 // Try to get RTT from RtcpRttStats class.
480 *rtt = rtt_ms();
481 }
482 return ret;
483}
484
485int64_t ModuleRtpRtcpImpl2::ExpectedRetransmissionTimeMs() const {
486 int64_t expected_retransmission_time_ms = rtt_ms();
487 if (expected_retransmission_time_ms > 0) {
488 return expected_retransmission_time_ms;
489 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200490 // No rtt available (|kRttUpdateInterval| not yet passed?), so try to
Tommi3a5742c2020-05-20 09:32:51 +0200491 // poll avg_rtt_ms directly from rtcp receiver.
492 if (rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), nullptr,
493 &expected_retransmission_time_ms, nullptr,
494 nullptr) == 0) {
495 return expected_retransmission_time_ms;
496 }
497 return kDefaultExpectedRetransmissionTimeMs;
498}
499
500// Force a send of an RTCP packet.
501// Normal SR and RR are triggered via the process function.
502int32_t ModuleRtpRtcpImpl2::SendRTCP(RTCPPacketType packet_type) {
503 return rtcp_sender_.SendRTCP(GetFeedbackState(), packet_type);
504}
505
Tommi3a5742c2020-05-20 09:32:51 +0200506void ModuleRtpRtcpImpl2::GetSendStreamDataCounters(
507 StreamDataCounters* rtp_counters,
508 StreamDataCounters* rtx_counters) const {
509 rtp_sender_->packet_sender.GetDataCounters(rtp_counters, rtx_counters);
510}
511
512// Received RTCP report.
Tommi3a5742c2020-05-20 09:32:51 +0200513std::vector<ReportBlockData> ModuleRtpRtcpImpl2::GetLatestReportBlockData()
514 const {
515 return rtcp_receiver_.GetLatestReportBlockData();
516}
517
Alessio Bazzicabc1c93d2021-03-12 17:45:26 +0100518absl::optional<RtpRtcpInterface::SenderReportStats>
519ModuleRtpRtcpImpl2::GetSenderReportStats() const {
520 SenderReportStats stats;
521 uint32_t remote_timestamp_secs;
522 uint32_t remote_timestamp_frac;
523 uint32_t arrival_timestamp_secs;
524 uint32_t arrival_timestamp_frac;
525 if (rtcp_receiver_.NTP(&remote_timestamp_secs, &remote_timestamp_frac,
526 &arrival_timestamp_secs, &arrival_timestamp_frac,
527 /*rtcp_timestamp=*/nullptr, &stats.packets_sent,
528 &stats.bytes_sent, &stats.reports_count)) {
529 stats.last_remote_timestamp.Set(remote_timestamp_secs,
530 remote_timestamp_frac);
531 stats.last_arrival_timestamp.Set(arrival_timestamp_secs,
532 arrival_timestamp_frac);
533 return stats;
534 }
535 return absl::nullopt;
536}
537
Tommi3a5742c2020-05-20 09:32:51 +0200538// (REMB) Receiver Estimated Max Bitrate.
539void ModuleRtpRtcpImpl2::SetRemb(int64_t bitrate_bps,
540 std::vector<uint32_t> ssrcs) {
541 rtcp_sender_.SetRemb(bitrate_bps, std::move(ssrcs));
542}
543
544void ModuleRtpRtcpImpl2::UnsetRemb() {
545 rtcp_sender_.UnsetRemb();
546}
547
548void ModuleRtpRtcpImpl2::SetExtmapAllowMixed(bool extmap_allow_mixed) {
549 rtp_sender_->packet_generator.SetExtmapAllowMixed(extmap_allow_mixed);
550}
551
Tommi3a5742c2020-05-20 09:32:51 +0200552void ModuleRtpRtcpImpl2::RegisterRtpHeaderExtension(absl::string_view uri,
553 int id) {
554 bool registered =
555 rtp_sender_->packet_generator.RegisterRtpHeaderExtension(uri, id);
556 RTC_CHECK(registered);
557}
558
559int32_t ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
560 const RTPExtensionType type) {
561 return rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(type);
562}
563void ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
564 absl::string_view uri) {
565 rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(uri);
566}
567
Tommi3a5742c2020-05-20 09:32:51 +0200568void ModuleRtpRtcpImpl2::SetTmmbn(std::vector<rtcp::TmmbItem> bounding_set) {
569 rtcp_sender_.SetTmmbn(std::move(bounding_set));
570}
571
572// Send a Negative acknowledgment packet.
573int32_t ModuleRtpRtcpImpl2::SendNACK(const uint16_t* nack_list,
574 const uint16_t size) {
575 uint16_t nack_length = size;
576 uint16_t start_id = 0;
577 int64_t now_ms = clock_->TimeInMilliseconds();
578 if (TimeToSendFullNackList(now_ms)) {
579 nack_last_time_sent_full_ms_ = now_ms;
580 } else {
581 // Only send extended list.
582 if (nack_last_seq_number_sent_ == nack_list[size - 1]) {
583 // Last sequence number is the same, do not send list.
584 return 0;
585 }
586 // Send new sequence numbers.
587 for (int i = 0; i < size; ++i) {
588 if (nack_last_seq_number_sent_ == nack_list[i]) {
589 start_id = i + 1;
590 break;
591 }
592 }
593 nack_length = size - start_id;
594 }
595
596 // Our RTCP NACK implementation is limited to kRtcpMaxNackFields sequence
597 // numbers per RTCP packet.
598 if (nack_length > kRtcpMaxNackFields) {
599 nack_length = kRtcpMaxNackFields;
600 }
601 nack_last_seq_number_sent_ = nack_list[start_id + nack_length - 1];
602
603 return rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, nack_length,
604 &nack_list[start_id]);
605}
606
607void ModuleRtpRtcpImpl2::SendNack(
608 const std::vector<uint16_t>& sequence_numbers) {
609 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, sequence_numbers.size(),
610 sequence_numbers.data());
611}
612
613bool ModuleRtpRtcpImpl2::TimeToSendFullNackList(int64_t now) const {
614 // Use RTT from RtcpRttStats class if provided.
615 int64_t rtt = rtt_ms();
616 if (rtt == 0) {
617 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
618 }
619
620 const int64_t kStartUpRttMs = 100;
621 int64_t wait_time = 5 + ((rtt * 3) >> 1); // 5 + RTT * 1.5.
622 if (rtt == 0) {
623 wait_time = kStartUpRttMs;
624 }
625
626 // Send a full NACK list once within every |wait_time|.
627 return now - nack_last_time_sent_full_ms_ > wait_time;
628}
629
630// Store the sent packets, needed to answer to Negative acknowledgment requests.
631void ModuleRtpRtcpImpl2::SetStorePacketsStatus(const bool enable,
632 const uint16_t number_to_store) {
633 rtp_sender_->packet_history.SetStorePacketsStatus(
634 enable ? RtpPacketHistory::StorageMode::kStoreAndCull
635 : RtpPacketHistory::StorageMode::kDisabled,
636 number_to_store);
637}
638
639bool ModuleRtpRtcpImpl2::StorePackets() const {
640 return rtp_sender_->packet_history.GetStorageMode() !=
641 RtpPacketHistory::StorageMode::kDisabled;
642}
643
644void ModuleRtpRtcpImpl2::SendCombinedRtcpPacket(
645 std::vector<std::unique_ptr<rtcp::RtcpPacket>> rtcp_packets) {
646 rtcp_sender_.SendCombinedRtcpPacket(std::move(rtcp_packets));
647}
648
649int32_t ModuleRtpRtcpImpl2::SendLossNotification(uint16_t last_decoded_seq_num,
650 uint16_t last_received_seq_num,
651 bool decodability_flag,
652 bool buffering_allowed) {
653 return rtcp_sender_.SendLossNotification(
654 GetFeedbackState(), last_decoded_seq_num, last_received_seq_num,
655 decodability_flag, buffering_allowed);
656}
657
658void ModuleRtpRtcpImpl2::SetRemoteSSRC(const uint32_t ssrc) {
659 // Inform about the incoming SSRC.
660 rtcp_sender_.SetRemoteSSRC(ssrc);
661 rtcp_receiver_.SetRemoteSSRC(ssrc);
662}
663
Tommi08be9ba2021-06-15 23:01:57 +0200664void ModuleRtpRtcpImpl2::SetLocalSsrc(uint32_t local_ssrc) {
665 RTC_DCHECK_RUN_ON(&packet_sequence_checker_);
666 rtcp_receiver_.set_local_media_ssrc(local_ssrc);
667 rtcp_sender_.SetSsrc(local_ssrc);
668}
669
Tommi3a5742c2020-05-20 09:32:51 +0200670RtpSendRates ModuleRtpRtcpImpl2::GetSendRates() const {
Tommi1050fbc2021-06-03 17:58:28 +0200671 // Typically called on the `rtp_transport_queue_` owned by an
672 // RtpTransportControllerSendInterface instance.
Tommi3a5742c2020-05-20 09:32:51 +0200673 return rtp_sender_->packet_sender.GetSendRates();
674}
675
676void ModuleRtpRtcpImpl2::OnRequestSendReport() {
677 SendRTCP(kRtcpSr);
678}
679
680void ModuleRtpRtcpImpl2::OnReceivedNack(
681 const std::vector<uint16_t>& nack_sequence_numbers) {
682 if (!rtp_sender_)
683 return;
684
685 if (!StorePackets() || nack_sequence_numbers.empty()) {
686 return;
687 }
688 // Use RTT from RtcpRttStats class if provided.
689 int64_t rtt = rtt_ms();
690 if (rtt == 0) {
691 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
692 }
693 rtp_sender_->packet_generator.OnReceivedNack(nack_sequence_numbers, rtt);
694}
695
696void ModuleRtpRtcpImpl2::OnReceivedRtcpReportBlocks(
697 const ReportBlockList& report_blocks) {
698 if (rtp_sender_) {
699 uint32_t ssrc = SSRC();
700 absl::optional<uint32_t> rtx_ssrc;
701 if (rtp_sender_->packet_generator.RtxStatus() != kRtxOff) {
702 rtx_ssrc = rtp_sender_->packet_generator.RtxSsrc();
703 }
704
705 for (const RTCPReportBlock& report_block : report_blocks) {
706 if (ssrc == report_block.source_ssrc) {
707 rtp_sender_->packet_generator.OnReceivedAckOnSsrc(
708 report_block.extended_highest_sequence_number);
709 } else if (rtx_ssrc && *rtx_ssrc == report_block.source_ssrc) {
710 rtp_sender_->packet_generator.OnReceivedAckOnRtxSsrc(
711 report_block.extended_highest_sequence_number);
712 }
713 }
714 }
715}
716
Tommi3a5742c2020-05-20 09:32:51 +0200717void ModuleRtpRtcpImpl2::set_rtt_ms(int64_t rtt_ms) {
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200718 RTC_DCHECK_RUN_ON(worker_queue_);
Tommi3a5742c2020-05-20 09:32:51 +0200719 {
Markus Handellf7303e62020-07-09 01:34:42 +0200720 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200721 rtt_ms_ = rtt_ms;
722 }
723 if (rtp_sender_) {
724 rtp_sender_->packet_history.SetRtt(rtt_ms);
725 }
726}
727
728int64_t ModuleRtpRtcpImpl2::rtt_ms() const {
Markus Handellf7303e62020-07-09 01:34:42 +0200729 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200730 return rtt_ms_;
731}
732
733void ModuleRtpRtcpImpl2::SetVideoBitrateAllocation(
734 const VideoBitrateAllocation& bitrate) {
735 rtcp_sender_.SetVideoBitrateAllocation(bitrate);
736}
737
738RTPSender* ModuleRtpRtcpImpl2::RtpSender() {
739 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
740}
741
742const RTPSender* ModuleRtpRtcpImpl2::RtpSender() const {
743 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
744}
745
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200746void ModuleRtpRtcpImpl2::PeriodicUpdate() {
747 RTC_DCHECK_RUN_ON(worker_queue_);
748
749 Timestamp check_since = clock_->CurrentTime() - kRttUpdateInterval;
750 absl::optional<TimeDelta> rtt =
751 rtcp_receiver_.OnPeriodicRttUpdate(check_since, rtcp_sender_.Sending());
752 if (rtt) {
Ivo Creusen8c40d512021-07-13 12:53:22 +0000753 if (rtt_stats_) {
754 rtt_stats_->OnRttUpdate(rtt->ms());
755 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200756 set_rtt_ms(rtt->ms());
757 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200758}
759
Markus Handell885d5382021-06-21 18:57:36 +0200760// RTC_RUN_ON(worker_queue_);
761void ModuleRtpRtcpImpl2::MaybeSendRtcp() {
762 if (rtcp_sender_.TimeToSendRTCPReport())
763 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
764}
765
766// TODO(bugs.webrtc.org/12889): Consider removing this function when the issue
767// is resolved.
768// RTC_RUN_ON(worker_queue_);
769void ModuleRtpRtcpImpl2::MaybeSendRtcpAtOrAfterTimestamp(
770 Timestamp execution_time) {
771 Timestamp now = clock_->CurrentTime();
772 if (now >= execution_time) {
773 MaybeSendRtcp();
774 return;
775 }
776
777 RTC_DLOG(LS_WARNING)
778 << "BUGBUG: Task queue scheduled delayed call too early.";
779
780 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, execution_time - now);
781}
782
783void ModuleRtpRtcpImpl2::ScheduleRtcpSendEvaluation(TimeDelta duration) {
784 // We end up here under various sequences including the worker queue, and
785 // the RTCPSender lock is held.
786 // We're assuming that the fact that RTCPSender executes under other sequences
787 // than the worker queue on which it's created on implies that external
788 // synchronization is present and removes this activity before destruction.
789 if (duration.IsZero()) {
790 worker_queue_->PostTask(ToQueuedTask(task_safety_, [this] {
791 RTC_DCHECK_RUN_ON(worker_queue_);
792 MaybeSendRtcp();
793 }));
794 } else {
795 Timestamp execution_time = clock_->CurrentTime() + duration;
796 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, duration);
797 }
798}
799
800void ModuleRtpRtcpImpl2::ScheduleMaybeSendRtcpAtOrAfterTimestamp(
801 Timestamp execution_time,
802 TimeDelta duration) {
803 // We end up here under various sequences including the worker queue, and
804 // the RTCPSender lock is held.
805 // See note in ScheduleRtcpSendEvaluation about why |worker_queue_| can be
806 // accessed.
807 worker_queue_->PostDelayedTask(
808 ToQueuedTask(task_safety_,
809 [this, execution_time] {
810 RTC_DCHECK_RUN_ON(worker_queue_);
811 MaybeSendRtcpAtOrAfterTimestamp(execution_time);
812 }),
813 DelayMillisForDuration(duration));
814}
815
Tommi3a5742c2020-05-20 09:32:51 +0200816} // namespace webrtc