blob: 6f39c5ce5319b2901793dcb4710dae49f09fde49 [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
Artem Titov913cfa72021-07-28 23:57:33 +020056 // slept. Account for this, unless `duration` is exactly representable in
Markus Handell885d5382021-06-21 18:57:36 +020057 // 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ångb6bbdeb2021-08-13 16:12:41 +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ång54abf982021-08-13 17:25:44 +020071 non_paced_sender(&packet_sender, &sequencer),
Tommi3a5742c2020-05-20 09:32:51 +020072 packet_generator(
73 config,
74 &packet_history,
Erik Språng54abf982021-08-13 17:25:44 +020075 config.paced_sender ? config.paced_sender : &non_paced_sender) {}
Tommi3a5742c2020-05-20 09:32:51 +020076
Tommi3a5742c2020-05-20 09:32:51 +020077ModuleRtpRtcpImpl2::ModuleRtpRtcpImpl2(const Configuration& configuration)
Niels Moller2accc7d2021-01-12 15:54:16 +000078 : worker_queue_(TaskQueueBase::Current()),
Markus Handell885d5382021-06-21 18:57:36 +020079 rtcp_sender_(AddRtcpSendEvaluationCallback(
80 RTCPSender::Configuration::FromRtpRtcpConfiguration(configuration),
81 [this](TimeDelta duration) {
82 ScheduleRtcpSendEvaluation(duration);
83 })),
Tommi3a5742c2020-05-20 09:32:51 +020084 rtcp_receiver_(configuration, this),
85 clock_(configuration.clock),
Tommi3a5742c2020-05-20 09:32:51 +020086 packet_overhead_(28), // IPV4 UDP.
87 nack_last_time_sent_full_ms_(0),
88 nack_last_seq_number_sent_(0),
89 remote_bitrate_(configuration.remote_bitrate_estimator),
90 rtt_stats_(configuration.rtt_stats),
91 rtt_ms_(0) {
Niels Moller2accc7d2021-01-12 15:54:16 +000092 RTC_DCHECK(worker_queue_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +020093 rtcp_thread_checker_.Detach();
Tommi3a5742c2020-05-20 09:32:51 +020094 if (!configuration.receiver_only) {
95 rtp_sender_ = std::make_unique<RtpSenderContext>(configuration);
Erik Språngb6bbdeb2021-08-13 16:12:41 +020096 rtp_sender_->sequencing_checker.Detach();
Tommi3a5742c2020-05-20 09:32:51 +020097 // Make sure rtcp sender use same timestamp offset as rtp sender.
98 rtcp_sender_.SetTimestampOffset(
99 rtp_sender_->packet_generator.TimestampOffset());
100 }
101
102 // Set default packet size limit.
103 // TODO(nisse): Kind-of duplicates
104 // webrtc::VideoSendStream::Config::Rtp::kDefaultMaxPacketSize.
105 const size_t kTcpOverIpv4HeaderSize = 40;
106 SetMaxRtpPacketSize(IP_PACKET_SIZE - kTcpOverIpv4HeaderSize);
Ivo Creusen8c40d512021-07-13 12:53:22 +0000107 rtt_update_task_ = RepeatingTaskHandle::DelayedStart(
108 worker_queue_, kRttUpdateInterval, [this]() {
109 PeriodicUpdate();
110 return kRttUpdateInterval;
111 });
Tommi3a5742c2020-05-20 09:32:51 +0200112}
113
114ModuleRtpRtcpImpl2::~ModuleRtpRtcpImpl2() {
Niels Moller2accc7d2021-01-12 15:54:16 +0000115 RTC_DCHECK_RUN_ON(worker_queue_);
116 rtt_update_task_.Stop();
117}
118
119// static
120std::unique_ptr<ModuleRtpRtcpImpl2> ModuleRtpRtcpImpl2::Create(
121 const Configuration& configuration) {
122 RTC_DCHECK(configuration.clock);
123 RTC_DCHECK(TaskQueueBase::Current());
124 return std::make_unique<ModuleRtpRtcpImpl2>(configuration);
Tomas Gunnarssonfae05622020-06-03 08:54:39 +0200125}
126
Tommi3a5742c2020-05-20 09:32:51 +0200127void ModuleRtpRtcpImpl2::SetRtxSendStatus(int mode) {
128 rtp_sender_->packet_generator.SetRtxStatus(mode);
129}
130
131int ModuleRtpRtcpImpl2::RtxSendStatus() const {
132 return rtp_sender_ ? rtp_sender_->packet_generator.RtxStatus() : kRtxOff;
133}
134
135void ModuleRtpRtcpImpl2::SetRtxSendPayloadType(int payload_type,
136 int associated_payload_type) {
137 rtp_sender_->packet_generator.SetRtxPayloadType(payload_type,
138 associated_payload_type);
139}
140
141absl::optional<uint32_t> ModuleRtpRtcpImpl2::RtxSsrc() const {
142 return rtp_sender_ ? rtp_sender_->packet_generator.RtxSsrc() : absl::nullopt;
143}
144
145absl::optional<uint32_t> ModuleRtpRtcpImpl2::FlexfecSsrc() const {
146 if (rtp_sender_) {
147 return rtp_sender_->packet_generator.FlexfecSsrc();
148 }
149 return absl::nullopt;
150}
151
152void ModuleRtpRtcpImpl2::IncomingRtcpPacket(const uint8_t* rtcp_packet,
153 const size_t length) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200154 RTC_DCHECK_RUN_ON(&rtcp_thread_checker_);
Tommi3a5742c2020-05-20 09:32:51 +0200155 rtcp_receiver_.IncomingPacket(rtcp_packet, length);
156}
157
158void ModuleRtpRtcpImpl2::RegisterSendPayloadFrequency(int payload_type,
159 int payload_frequency) {
160 rtcp_sender_.SetRtpClockRate(payload_type, payload_frequency);
161}
162
163int32_t ModuleRtpRtcpImpl2::DeRegisterSendPayload(const int8_t payload_type) {
164 return 0;
165}
166
167uint32_t ModuleRtpRtcpImpl2::StartTimestamp() const {
168 return rtp_sender_->packet_generator.TimestampOffset();
169}
170
171// Configure start timestamp, default is a random number.
172void ModuleRtpRtcpImpl2::SetStartTimestamp(const uint32_t timestamp) {
173 rtcp_sender_.SetTimestampOffset(timestamp);
174 rtp_sender_->packet_generator.SetTimestampOffset(timestamp);
175 rtp_sender_->packet_sender.SetTimestampOffset(timestamp);
176}
177
178uint16_t ModuleRtpRtcpImpl2::SequenceNumber() const {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200179 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språng54abf982021-08-13 17:25:44 +0200180 return rtp_sender_->sequencer.media_sequence_number();
Tommi3a5742c2020-05-20 09:32:51 +0200181}
182
183// Set SequenceNumber, default is a random number.
184void ModuleRtpRtcpImpl2::SetSequenceNumber(const uint16_t seq_num) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200185 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språng54abf982021-08-13 17:25:44 +0200186 if (rtp_sender_->sequencer.media_sequence_number() != seq_num) {
187 rtp_sender_->sequencer.set_media_sequence_number(seq_num);
188 rtp_sender_->packet_history.Clear();
Erik Språngbb904972021-08-06 13:10:11 +0200189 }
Tommi3a5742c2020-05-20 09:32:51 +0200190}
191
192void ModuleRtpRtcpImpl2::SetRtpState(const RtpState& rtp_state) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200193 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Tommi3a5742c2020-05-20 09:32:51 +0200194 rtp_sender_->packet_generator.SetRtpState(rtp_state);
Erik Språng54abf982021-08-13 17:25:44 +0200195 rtp_sender_->sequencer.SetRtpState(rtp_state);
Tommi3a5742c2020-05-20 09:32:51 +0200196 rtcp_sender_.SetTimestampOffset(rtp_state.start_timestamp);
197}
198
199void ModuleRtpRtcpImpl2::SetRtxState(const RtpState& rtp_state) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200200 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Tommi3a5742c2020-05-20 09:32:51 +0200201 rtp_sender_->packet_generator.SetRtxRtpState(rtp_state);
Erik Språng54abf982021-08-13 17:25:44 +0200202 rtp_sender_->sequencer.set_rtx_sequence_number(rtp_state.sequence_number);
Tommi3a5742c2020-05-20 09:32:51 +0200203}
204
205RtpState ModuleRtpRtcpImpl2::GetRtpState() const {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200206 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Tommi3a5742c2020-05-20 09:32:51 +0200207 RtpState state = rtp_sender_->packet_generator.GetRtpState();
Erik Språng54abf982021-08-13 17:25:44 +0200208 rtp_sender_->sequencer.PopulateRtpState(state);
Tommi3a5742c2020-05-20 09:32:51 +0200209 return state;
210}
211
212RtpState ModuleRtpRtcpImpl2::GetRtxState() const {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200213 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språngbb904972021-08-06 13:10:11 +0200214 RtpState state = rtp_sender_->packet_generator.GetRtxRtpState();
Erik Språng54abf982021-08-13 17:25:44 +0200215 state.sequence_number = rtp_sender_->sequencer.rtx_sequence_number();
Erik Språngbb904972021-08-06 13:10:11 +0200216 return state;
Tommi3a5742c2020-05-20 09:32:51 +0200217}
218
Ivo Creusen8c40d512021-07-13 12:53:22 +0000219void ModuleRtpRtcpImpl2::SetNonSenderRttMeasurement(bool enabled) {
220 rtcp_sender_.SetNonSenderRttMeasurement(enabled);
221 rtcp_receiver_.SetNonSenderRttMeasurement(enabled);
222}
223
Tommi08be9ba2021-06-15 23:01:57 +0200224uint32_t ModuleRtpRtcpImpl2::local_media_ssrc() const {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200225 RTC_DCHECK_RUN_ON(&rtcp_thread_checker_);
Tommi08be9ba2021-06-15 23:01:57 +0200226 RTC_DCHECK_EQ(rtcp_receiver_.local_media_ssrc(), rtcp_sender_.SSRC());
227 return rtcp_receiver_.local_media_ssrc();
228}
229
Tommi3a5742c2020-05-20 09:32:51 +0200230void ModuleRtpRtcpImpl2::SetRid(const std::string& rid) {
231 if (rtp_sender_) {
232 rtp_sender_->packet_generator.SetRid(rid);
233 }
234}
235
236void ModuleRtpRtcpImpl2::SetMid(const std::string& mid) {
237 if (rtp_sender_) {
238 rtp_sender_->packet_generator.SetMid(mid);
239 }
240 // TODO(bugs.webrtc.org/4050): If we end up supporting the MID SDES item for
241 // RTCP, this will need to be passed down to the RTCPSender also.
242}
243
244void ModuleRtpRtcpImpl2::SetCsrcs(const std::vector<uint32_t>& csrcs) {
245 rtcp_sender_.SetCsrcs(csrcs);
246 rtp_sender_->packet_generator.SetCsrcs(csrcs);
247}
248
249// TODO(pbos): Handle media and RTX streams separately (separate RTCP
250// feedbacks).
251RTCPSender::FeedbackState ModuleRtpRtcpImpl2::GetFeedbackState() {
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200252 // TODO(bugs.webrtc.org/11581): Called by potentially multiple threads.
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200253 // Mostly "Send*" methods. Make sure it's only called on the
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200254 // construction thread.
255
Tommi3a5742c2020-05-20 09:32:51 +0200256 RTCPSender::FeedbackState state;
257 // This is called also when receiver_only is true. Hence below
258 // checks that rtp_sender_ exists.
259 if (rtp_sender_) {
260 StreamDataCounters rtp_stats;
261 StreamDataCounters rtx_stats;
262 rtp_sender_->packet_sender.GetDataCounters(&rtp_stats, &rtx_stats);
263 state.packets_sent =
264 rtp_stats.transmitted.packets + rtx_stats.transmitted.packets;
265 state.media_bytes_sent = rtp_stats.transmitted.payload_bytes +
266 rtx_stats.transmitted.payload_bytes;
267 state.send_bitrate =
268 rtp_sender_->packet_sender.GetSendRates().Sum().bps<uint32_t>();
269 }
270 state.receiver = &rtcp_receiver_;
271
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100272 uint32_t received_ntp_secs = 0;
273 uint32_t received_ntp_frac = 0;
274 state.remote_sr = 0;
275 if (rtcp_receiver_.NTP(&received_ntp_secs, &received_ntp_frac,
276 /*rtcp_arrival_time_secs=*/&state.last_rr_ntp_secs,
277 /*rtcp_arrival_time_frac=*/&state.last_rr_ntp_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100278 /*rtcp_timestamp=*/nullptr,
279 /*remote_sender_packet_count=*/nullptr,
280 /*remote_sender_octet_count=*/nullptr,
281 /*remote_sender_reports_count=*/nullptr)) {
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100282 state.remote_sr = ((received_ntp_secs & 0x0000ffff) << 16) +
283 ((received_ntp_frac & 0xffff0000) >> 16);
284 }
Tommi3a5742c2020-05-20 09:32:51 +0200285
286 state.last_xr_rtis = rtcp_receiver_.ConsumeReceivedXrReferenceTimeInfo();
287
288 return state;
289}
290
291// TODO(nisse): This method shouldn't be called for a receive-only
292// stream. Delete rtp_sender_ check as soon as all applications are
293// updated.
294int32_t ModuleRtpRtcpImpl2::SetSendingStatus(const bool sending) {
295 if (rtcp_sender_.Sending() != sending) {
296 // Sends RTCP BYE when going from true to false
Tomas Gunnarssondbcf5d32021-04-23 20:31:08 +0200297 rtcp_sender_.SetSendingStatus(GetFeedbackState(), sending);
Tommi3a5742c2020-05-20 09:32:51 +0200298 }
299 return 0;
300}
301
302bool ModuleRtpRtcpImpl2::Sending() const {
303 return rtcp_sender_.Sending();
304}
305
306// TODO(nisse): This method shouldn't be called for a receive-only
307// stream. Delete rtp_sender_ check as soon as all applications are
308// updated.
309void ModuleRtpRtcpImpl2::SetSendingMediaStatus(const bool sending) {
310 if (rtp_sender_) {
311 rtp_sender_->packet_generator.SetSendingMediaStatus(sending);
312 } else {
313 RTC_DCHECK(!sending);
314 }
315}
316
317bool ModuleRtpRtcpImpl2::SendingMedia() const {
318 return rtp_sender_ ? rtp_sender_->packet_generator.SendingMedia() : false;
319}
320
321bool ModuleRtpRtcpImpl2::IsAudioConfigured() const {
322 return rtp_sender_ ? rtp_sender_->packet_generator.IsAudioConfigured()
323 : false;
324}
325
326void ModuleRtpRtcpImpl2::SetAsPartOfAllocation(bool part_of_allocation) {
327 RTC_CHECK(rtp_sender_);
328 rtp_sender_->packet_sender.ForceIncludeSendPacketsInAllocation(
329 part_of_allocation);
330}
331
332bool ModuleRtpRtcpImpl2::OnSendingRtpFrame(uint32_t timestamp,
333 int64_t capture_time_ms,
334 int payload_type,
335 bool force_sender_report) {
336 if (!Sending())
337 return false;
338
Markus Handellc6b9ac72021-06-18 13:44:51 +0200339 // TODO(bugs.webrtc.org/12873): Migrate this method and it's users to use
340 // optional Timestamps.
341 absl::optional<Timestamp> capture_time;
342 if (capture_time_ms > 0) {
343 capture_time = Timestamp::Millis(capture_time_ms);
344 }
345 absl::optional<int> payload_type_optional;
346 if (payload_type >= 0)
347 payload_type_optional = payload_type;
348 rtcp_sender_.SetLastRtpTime(timestamp, capture_time, payload_type_optional);
Tommi3a5742c2020-05-20 09:32:51 +0200349 // Make sure an RTCP report isn't queued behind a key frame.
350 if (rtcp_sender_.TimeToSendRTCPReport(force_sender_report))
351 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
352
353 return true;
354}
355
356bool ModuleRtpRtcpImpl2::TrySendPacket(RtpPacketToSend* packet,
357 const PacedPacketInfo& pacing_info) {
358 RTC_DCHECK(rtp_sender_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200359 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språng54abf982021-08-13 17:25:44 +0200360 if (!rtp_sender_->packet_generator.SendingMedia()) {
Tommi3a5742c2020-05-20 09:32:51 +0200361 return false;
362 }
Erik Språng54abf982021-08-13 17:25:44 +0200363 if (packet->packet_type() == RtpPacketMediaType::kPadding &&
364 packet->Ssrc() == rtp_sender_->packet_generator.SSRC() &&
365 !rtp_sender_->sequencer.CanSendPaddingOnMediaSsrc()) {
366 // New media packet preempted this generated padding packet, discard it.
367 return false;
368 }
369 bool is_flexfec =
370 packet->packet_type() == RtpPacketMediaType::kForwardErrorCorrection &&
371 packet->Ssrc() == rtp_sender_->packet_generator.FlexfecSsrc();
372 if (!is_flexfec) {
373 rtp_sender_->sequencer.Sequence(*packet);
374 }
375
Tommi3a5742c2020-05-20 09:32:51 +0200376 rtp_sender_->packet_sender.SendPacket(packet, pacing_info);
377 return true;
378}
379
Erik Språng1d50cb62020-07-02 17:41:32 +0200380void ModuleRtpRtcpImpl2::SetFecProtectionParams(
381 const FecProtectionParams& delta_params,
382 const FecProtectionParams& key_params) {
383 RTC_DCHECK(rtp_sender_);
384 rtp_sender_->packet_sender.SetFecProtectionParameters(delta_params,
385 key_params);
386}
387
388std::vector<std::unique_ptr<RtpPacketToSend>>
389ModuleRtpRtcpImpl2::FetchFecPackets() {
390 RTC_DCHECK(rtp_sender_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200391 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språng54abf982021-08-13 17:25:44 +0200392 return rtp_sender_->packet_sender.FetchFecPackets();
Erik Språng1d50cb62020-07-02 17:41:32 +0200393}
394
Tommi3a5742c2020-05-20 09:32:51 +0200395void ModuleRtpRtcpImpl2::OnPacketsAcknowledged(
396 rtc::ArrayView<const uint16_t> sequence_numbers) {
397 RTC_DCHECK(rtp_sender_);
398 rtp_sender_->packet_history.CullAcknowledgedPackets(sequence_numbers);
399}
400
401bool ModuleRtpRtcpImpl2::SupportsPadding() const {
402 RTC_DCHECK(rtp_sender_);
403 return rtp_sender_->packet_generator.SupportsPadding();
404}
405
406bool ModuleRtpRtcpImpl2::SupportsRtxPayloadPadding() const {
407 RTC_DCHECK(rtp_sender_);
408 return rtp_sender_->packet_generator.SupportsRtxPayloadPadding();
409}
410
411std::vector<std::unique_ptr<RtpPacketToSend>>
412ModuleRtpRtcpImpl2::GeneratePadding(size_t target_size_bytes) {
413 RTC_DCHECK(rtp_sender_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200414 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språngbb904972021-08-06 13:10:11 +0200415
Tommi3a5742c2020-05-20 09:32:51 +0200416 return rtp_sender_->packet_generator.GeneratePadding(
Erik Språngbfcfe032021-08-04 14:45:32 +0200417 target_size_bytes, rtp_sender_->packet_sender.MediaHasBeenSent(),
Erik Språng54abf982021-08-13 17:25:44 +0200418 rtp_sender_->sequencer.CanSendPaddingOnMediaSsrc());
Tommi3a5742c2020-05-20 09:32:51 +0200419}
420
421std::vector<RtpSequenceNumberMap::Info>
422ModuleRtpRtcpImpl2::GetSentRtpPacketInfos(
423 rtc::ArrayView<const uint16_t> sequence_numbers) const {
424 RTC_DCHECK(rtp_sender_);
425 return rtp_sender_->packet_sender.GetSentRtpPacketInfos(sequence_numbers);
426}
427
428size_t ModuleRtpRtcpImpl2::ExpectedPerPacketOverhead() const {
429 if (!rtp_sender_) {
430 return 0;
431 }
432 return rtp_sender_->packet_generator.ExpectedPerPacketOverhead();
433}
434
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200435void ModuleRtpRtcpImpl2::OnPacketSendingThreadSwitched() {
436 // Ownership of sequencing is being transferred to another thread.
437 rtp_sender_->sequencing_checker.Detach();
438}
439
Tommi3a5742c2020-05-20 09:32:51 +0200440size_t ModuleRtpRtcpImpl2::MaxRtpPacketSize() const {
441 RTC_DCHECK(rtp_sender_);
442 return rtp_sender_->packet_generator.MaxRtpPacketSize();
443}
444
445void ModuleRtpRtcpImpl2::SetMaxRtpPacketSize(size_t rtp_packet_size) {
446 RTC_DCHECK_LE(rtp_packet_size, IP_PACKET_SIZE)
447 << "rtp packet size too large: " << rtp_packet_size;
448 RTC_DCHECK_GT(rtp_packet_size, packet_overhead_)
449 << "rtp packet size too small: " << rtp_packet_size;
450
451 rtcp_sender_.SetMaxRtpPacketSize(rtp_packet_size);
452 if (rtp_sender_) {
453 rtp_sender_->packet_generator.SetMaxRtpPacketSize(rtp_packet_size);
454 }
455}
456
457RtcpMode ModuleRtpRtcpImpl2::RTCP() const {
458 return rtcp_sender_.Status();
459}
460
461// Configure RTCP status i.e on/off.
462void ModuleRtpRtcpImpl2::SetRTCPStatus(const RtcpMode method) {
463 rtcp_sender_.SetRTCPStatus(method);
464}
465
466int32_t ModuleRtpRtcpImpl2::SetCNAME(const char* c_name) {
467 return rtcp_sender_.SetCNAME(c_name);
468}
469
Tommi3a5742c2020-05-20 09:32:51 +0200470int32_t ModuleRtpRtcpImpl2::RemoteNTP(uint32_t* received_ntpsecs,
471 uint32_t* received_ntpfrac,
472 uint32_t* rtcp_arrival_time_secs,
473 uint32_t* rtcp_arrival_time_frac,
474 uint32_t* rtcp_timestamp) const {
475 return rtcp_receiver_.NTP(received_ntpsecs, received_ntpfrac,
476 rtcp_arrival_time_secs, rtcp_arrival_time_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100477 rtcp_timestamp,
478 /*remote_sender_packet_count=*/nullptr,
479 /*remote_sender_octet_count=*/nullptr,
480 /*remote_sender_reports_count=*/nullptr)
Tommi3a5742c2020-05-20 09:32:51 +0200481 ? 0
482 : -1;
483}
484
Artem Titov913cfa72021-07-28 23:57:33 +0200485// TODO(tommi): Check if `avg_rtt_ms`, `min_rtt_ms`, `max_rtt_ms` params are
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200486// actually used in practice (some callers ask for it but don't use it). It
Artem Titov913cfa72021-07-28 23:57:33 +0200487// could be that only `rtt` is needed and if so, then the fast path could be to
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200488// just call rtt_ms() and rely on the calculation being done periodically.
Tommi3a5742c2020-05-20 09:32:51 +0200489int32_t ModuleRtpRtcpImpl2::RTT(const uint32_t remote_ssrc,
490 int64_t* rtt,
491 int64_t* avg_rtt,
492 int64_t* min_rtt,
493 int64_t* max_rtt) const {
494 int32_t ret = rtcp_receiver_.RTT(remote_ssrc, rtt, avg_rtt, min_rtt, max_rtt);
495 if (rtt && *rtt == 0) {
496 // Try to get RTT from RtcpRttStats class.
497 *rtt = rtt_ms();
498 }
499 return ret;
500}
501
502int64_t ModuleRtpRtcpImpl2::ExpectedRetransmissionTimeMs() const {
503 int64_t expected_retransmission_time_ms = rtt_ms();
504 if (expected_retransmission_time_ms > 0) {
505 return expected_retransmission_time_ms;
506 }
Artem Titov913cfa72021-07-28 23:57:33 +0200507 // No rtt available (`kRttUpdateInterval` not yet passed?), so try to
Tommi3a5742c2020-05-20 09:32:51 +0200508 // poll avg_rtt_ms directly from rtcp receiver.
509 if (rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), nullptr,
510 &expected_retransmission_time_ms, nullptr,
511 nullptr) == 0) {
512 return expected_retransmission_time_ms;
513 }
514 return kDefaultExpectedRetransmissionTimeMs;
515}
516
517// Force a send of an RTCP packet.
518// Normal SR and RR are triggered via the process function.
519int32_t ModuleRtpRtcpImpl2::SendRTCP(RTCPPacketType packet_type) {
520 return rtcp_sender_.SendRTCP(GetFeedbackState(), packet_type);
521}
522
Tommi3a5742c2020-05-20 09:32:51 +0200523void ModuleRtpRtcpImpl2::GetSendStreamDataCounters(
524 StreamDataCounters* rtp_counters,
525 StreamDataCounters* rtx_counters) const {
526 rtp_sender_->packet_sender.GetDataCounters(rtp_counters, rtx_counters);
527}
528
529// Received RTCP report.
Tommi3a5742c2020-05-20 09:32:51 +0200530std::vector<ReportBlockData> ModuleRtpRtcpImpl2::GetLatestReportBlockData()
531 const {
532 return rtcp_receiver_.GetLatestReportBlockData();
533}
534
Alessio Bazzicabc1c93d2021-03-12 17:45:26 +0100535absl::optional<RtpRtcpInterface::SenderReportStats>
536ModuleRtpRtcpImpl2::GetSenderReportStats() const {
537 SenderReportStats stats;
538 uint32_t remote_timestamp_secs;
539 uint32_t remote_timestamp_frac;
540 uint32_t arrival_timestamp_secs;
541 uint32_t arrival_timestamp_frac;
542 if (rtcp_receiver_.NTP(&remote_timestamp_secs, &remote_timestamp_frac,
543 &arrival_timestamp_secs, &arrival_timestamp_frac,
544 /*rtcp_timestamp=*/nullptr, &stats.packets_sent,
545 &stats.bytes_sent, &stats.reports_count)) {
546 stats.last_remote_timestamp.Set(remote_timestamp_secs,
547 remote_timestamp_frac);
548 stats.last_arrival_timestamp.Set(arrival_timestamp_secs,
549 arrival_timestamp_frac);
550 return stats;
551 }
552 return absl::nullopt;
553}
554
Ivo Creusen2562cf02021-09-03 14:51:22 +0000555absl::optional<RtpRtcpInterface::NonSenderRttStats>
556ModuleRtpRtcpImpl2::GetNonSenderRttStats() const {
557 RTCPReceiver::NonSenderRttStats non_sender_rtt_stats =
558 rtcp_receiver_.GetNonSenderRTT();
559 return {{
560 non_sender_rtt_stats.round_trip_time(),
561 non_sender_rtt_stats.total_round_trip_time(),
562 non_sender_rtt_stats.round_trip_time_measurements(),
563 }};
564}
565
Tommi3a5742c2020-05-20 09:32:51 +0200566// (REMB) Receiver Estimated Max Bitrate.
567void ModuleRtpRtcpImpl2::SetRemb(int64_t bitrate_bps,
568 std::vector<uint32_t> ssrcs) {
569 rtcp_sender_.SetRemb(bitrate_bps, std::move(ssrcs));
570}
571
572void ModuleRtpRtcpImpl2::UnsetRemb() {
573 rtcp_sender_.UnsetRemb();
574}
575
576void ModuleRtpRtcpImpl2::SetExtmapAllowMixed(bool extmap_allow_mixed) {
577 rtp_sender_->packet_generator.SetExtmapAllowMixed(extmap_allow_mixed);
578}
579
Tommi3a5742c2020-05-20 09:32:51 +0200580void ModuleRtpRtcpImpl2::RegisterRtpHeaderExtension(absl::string_view uri,
581 int id) {
582 bool registered =
583 rtp_sender_->packet_generator.RegisterRtpHeaderExtension(uri, id);
584 RTC_CHECK(registered);
585}
586
Tommi3a5742c2020-05-20 09:32:51 +0200587void ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
588 absl::string_view uri) {
589 rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(uri);
590}
591
Tommi3a5742c2020-05-20 09:32:51 +0200592void ModuleRtpRtcpImpl2::SetTmmbn(std::vector<rtcp::TmmbItem> bounding_set) {
593 rtcp_sender_.SetTmmbn(std::move(bounding_set));
594}
595
596// Send a Negative acknowledgment packet.
597int32_t ModuleRtpRtcpImpl2::SendNACK(const uint16_t* nack_list,
598 const uint16_t size) {
599 uint16_t nack_length = size;
600 uint16_t start_id = 0;
601 int64_t now_ms = clock_->TimeInMilliseconds();
602 if (TimeToSendFullNackList(now_ms)) {
603 nack_last_time_sent_full_ms_ = now_ms;
604 } else {
605 // Only send extended list.
606 if (nack_last_seq_number_sent_ == nack_list[size - 1]) {
607 // Last sequence number is the same, do not send list.
608 return 0;
609 }
610 // Send new sequence numbers.
611 for (int i = 0; i < size; ++i) {
612 if (nack_last_seq_number_sent_ == nack_list[i]) {
613 start_id = i + 1;
614 break;
615 }
616 }
617 nack_length = size - start_id;
618 }
619
620 // Our RTCP NACK implementation is limited to kRtcpMaxNackFields sequence
621 // numbers per RTCP packet.
622 if (nack_length > kRtcpMaxNackFields) {
623 nack_length = kRtcpMaxNackFields;
624 }
625 nack_last_seq_number_sent_ = nack_list[start_id + nack_length - 1];
626
627 return rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, nack_length,
628 &nack_list[start_id]);
629}
630
631void ModuleRtpRtcpImpl2::SendNack(
632 const std::vector<uint16_t>& sequence_numbers) {
633 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, sequence_numbers.size(),
634 sequence_numbers.data());
635}
636
637bool ModuleRtpRtcpImpl2::TimeToSendFullNackList(int64_t now) const {
638 // Use RTT from RtcpRttStats class if provided.
639 int64_t rtt = rtt_ms();
640 if (rtt == 0) {
641 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
642 }
643
644 const int64_t kStartUpRttMs = 100;
645 int64_t wait_time = 5 + ((rtt * 3) >> 1); // 5 + RTT * 1.5.
646 if (rtt == 0) {
647 wait_time = kStartUpRttMs;
648 }
649
Artem Titov913cfa72021-07-28 23:57:33 +0200650 // Send a full NACK list once within every `wait_time`.
Tommi3a5742c2020-05-20 09:32:51 +0200651 return now - nack_last_time_sent_full_ms_ > wait_time;
652}
653
654// Store the sent packets, needed to answer to Negative acknowledgment requests.
655void ModuleRtpRtcpImpl2::SetStorePacketsStatus(const bool enable,
656 const uint16_t number_to_store) {
657 rtp_sender_->packet_history.SetStorePacketsStatus(
658 enable ? RtpPacketHistory::StorageMode::kStoreAndCull
659 : RtpPacketHistory::StorageMode::kDisabled,
660 number_to_store);
661}
662
663bool ModuleRtpRtcpImpl2::StorePackets() const {
664 return rtp_sender_->packet_history.GetStorageMode() !=
665 RtpPacketHistory::StorageMode::kDisabled;
666}
667
668void ModuleRtpRtcpImpl2::SendCombinedRtcpPacket(
669 std::vector<std::unique_ptr<rtcp::RtcpPacket>> rtcp_packets) {
670 rtcp_sender_.SendCombinedRtcpPacket(std::move(rtcp_packets));
671}
672
673int32_t ModuleRtpRtcpImpl2::SendLossNotification(uint16_t last_decoded_seq_num,
674 uint16_t last_received_seq_num,
675 bool decodability_flag,
676 bool buffering_allowed) {
677 return rtcp_sender_.SendLossNotification(
678 GetFeedbackState(), last_decoded_seq_num, last_received_seq_num,
679 decodability_flag, buffering_allowed);
680}
681
682void ModuleRtpRtcpImpl2::SetRemoteSSRC(const uint32_t ssrc) {
683 // Inform about the incoming SSRC.
684 rtcp_sender_.SetRemoteSSRC(ssrc);
685 rtcp_receiver_.SetRemoteSSRC(ssrc);
686}
687
Tommi08be9ba2021-06-15 23:01:57 +0200688void ModuleRtpRtcpImpl2::SetLocalSsrc(uint32_t local_ssrc) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200689 RTC_DCHECK_RUN_ON(&rtcp_thread_checker_);
Tommi08be9ba2021-06-15 23:01:57 +0200690 rtcp_receiver_.set_local_media_ssrc(local_ssrc);
691 rtcp_sender_.SetSsrc(local_ssrc);
692}
693
Tommi3a5742c2020-05-20 09:32:51 +0200694RtpSendRates ModuleRtpRtcpImpl2::GetSendRates() const {
Tommi1050fbc2021-06-03 17:58:28 +0200695 // Typically called on the `rtp_transport_queue_` owned by an
696 // RtpTransportControllerSendInterface instance.
Tommi3a5742c2020-05-20 09:32:51 +0200697 return rtp_sender_->packet_sender.GetSendRates();
698}
699
700void ModuleRtpRtcpImpl2::OnRequestSendReport() {
701 SendRTCP(kRtcpSr);
702}
703
704void ModuleRtpRtcpImpl2::OnReceivedNack(
705 const std::vector<uint16_t>& nack_sequence_numbers) {
706 if (!rtp_sender_)
707 return;
708
709 if (!StorePackets() || nack_sequence_numbers.empty()) {
710 return;
711 }
712 // Use RTT from RtcpRttStats class if provided.
713 int64_t rtt = rtt_ms();
714 if (rtt == 0) {
715 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
716 }
717 rtp_sender_->packet_generator.OnReceivedNack(nack_sequence_numbers, rtt);
718}
719
720void ModuleRtpRtcpImpl2::OnReceivedRtcpReportBlocks(
721 const ReportBlockList& report_blocks) {
722 if (rtp_sender_) {
723 uint32_t ssrc = SSRC();
724 absl::optional<uint32_t> rtx_ssrc;
725 if (rtp_sender_->packet_generator.RtxStatus() != kRtxOff) {
726 rtx_ssrc = rtp_sender_->packet_generator.RtxSsrc();
727 }
728
729 for (const RTCPReportBlock& report_block : report_blocks) {
730 if (ssrc == report_block.source_ssrc) {
731 rtp_sender_->packet_generator.OnReceivedAckOnSsrc(
732 report_block.extended_highest_sequence_number);
733 } else if (rtx_ssrc && *rtx_ssrc == report_block.source_ssrc) {
734 rtp_sender_->packet_generator.OnReceivedAckOnRtxSsrc(
735 report_block.extended_highest_sequence_number);
736 }
737 }
738 }
739}
740
Tommi3a5742c2020-05-20 09:32:51 +0200741void ModuleRtpRtcpImpl2::set_rtt_ms(int64_t rtt_ms) {
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200742 RTC_DCHECK_RUN_ON(worker_queue_);
Tommi3a5742c2020-05-20 09:32:51 +0200743 {
Markus Handellf7303e62020-07-09 01:34:42 +0200744 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200745 rtt_ms_ = rtt_ms;
746 }
747 if (rtp_sender_) {
748 rtp_sender_->packet_history.SetRtt(rtt_ms);
749 }
750}
751
752int64_t ModuleRtpRtcpImpl2::rtt_ms() const {
Markus Handellf7303e62020-07-09 01:34:42 +0200753 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200754 return rtt_ms_;
755}
756
757void ModuleRtpRtcpImpl2::SetVideoBitrateAllocation(
758 const VideoBitrateAllocation& bitrate) {
759 rtcp_sender_.SetVideoBitrateAllocation(bitrate);
760}
761
762RTPSender* ModuleRtpRtcpImpl2::RtpSender() {
763 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
764}
765
766const RTPSender* ModuleRtpRtcpImpl2::RtpSender() const {
767 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
768}
769
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200770void ModuleRtpRtcpImpl2::PeriodicUpdate() {
771 RTC_DCHECK_RUN_ON(worker_queue_);
772
773 Timestamp check_since = clock_->CurrentTime() - kRttUpdateInterval;
774 absl::optional<TimeDelta> rtt =
775 rtcp_receiver_.OnPeriodicRttUpdate(check_since, rtcp_sender_.Sending());
776 if (rtt) {
Ivo Creusen8c40d512021-07-13 12:53:22 +0000777 if (rtt_stats_) {
778 rtt_stats_->OnRttUpdate(rtt->ms());
779 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200780 set_rtt_ms(rtt->ms());
781 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200782}
783
Markus Handell885d5382021-06-21 18:57:36 +0200784// RTC_RUN_ON(worker_queue_);
785void ModuleRtpRtcpImpl2::MaybeSendRtcp() {
786 if (rtcp_sender_.TimeToSendRTCPReport())
787 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
788}
789
790// TODO(bugs.webrtc.org/12889): Consider removing this function when the issue
791// is resolved.
792// RTC_RUN_ON(worker_queue_);
793void ModuleRtpRtcpImpl2::MaybeSendRtcpAtOrAfterTimestamp(
794 Timestamp execution_time) {
795 Timestamp now = clock_->CurrentTime();
796 if (now >= execution_time) {
797 MaybeSendRtcp();
798 return;
799 }
800
801 RTC_DLOG(LS_WARNING)
802 << "BUGBUG: Task queue scheduled delayed call too early.";
803
804 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, execution_time - now);
805}
806
807void ModuleRtpRtcpImpl2::ScheduleRtcpSendEvaluation(TimeDelta duration) {
808 // We end up here under various sequences including the worker queue, and
809 // the RTCPSender lock is held.
810 // We're assuming that the fact that RTCPSender executes under other sequences
811 // than the worker queue on which it's created on implies that external
812 // synchronization is present and removes this activity before destruction.
813 if (duration.IsZero()) {
814 worker_queue_->PostTask(ToQueuedTask(task_safety_, [this] {
815 RTC_DCHECK_RUN_ON(worker_queue_);
816 MaybeSendRtcp();
817 }));
818 } else {
819 Timestamp execution_time = clock_->CurrentTime() + duration;
820 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, duration);
821 }
822}
823
824void ModuleRtpRtcpImpl2::ScheduleMaybeSendRtcpAtOrAfterTimestamp(
825 Timestamp execution_time,
826 TimeDelta duration) {
827 // We end up here under various sequences including the worker queue, and
828 // the RTCPSender lock is held.
Artem Titov913cfa72021-07-28 23:57:33 +0200829 // See note in ScheduleRtcpSendEvaluation about why `worker_queue_` can be
Markus Handell885d5382021-06-21 18:57:36 +0200830 // accessed.
831 worker_queue_->PostDelayedTask(
832 ToQueuedTask(task_safety_,
833 [this, execution_time] {
834 RTC_DCHECK_RUN_ON(worker_queue_);
835 MaybeSendRtcpAtOrAfterTimestamp(execution_time);
836 }),
837 DelayMillisForDuration(duration));
838}
839
Tommi3a5742c2020-05-20 09:32:51 +0200840} // namespace webrtc