blob: 88de8db38785dd9c2dd0af451b27221ce3224d85 [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
Tommi3a5742c2020-05-20 09:32:51 +0200555// (REMB) Receiver Estimated Max Bitrate.
556void ModuleRtpRtcpImpl2::SetRemb(int64_t bitrate_bps,
557 std::vector<uint32_t> ssrcs) {
558 rtcp_sender_.SetRemb(bitrate_bps, std::move(ssrcs));
559}
560
561void ModuleRtpRtcpImpl2::UnsetRemb() {
562 rtcp_sender_.UnsetRemb();
563}
564
565void ModuleRtpRtcpImpl2::SetExtmapAllowMixed(bool extmap_allow_mixed) {
566 rtp_sender_->packet_generator.SetExtmapAllowMixed(extmap_allow_mixed);
567}
568
Tommi3a5742c2020-05-20 09:32:51 +0200569void ModuleRtpRtcpImpl2::RegisterRtpHeaderExtension(absl::string_view uri,
570 int id) {
571 bool registered =
572 rtp_sender_->packet_generator.RegisterRtpHeaderExtension(uri, id);
573 RTC_CHECK(registered);
574}
575
576int32_t ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
577 const RTPExtensionType type) {
578 return rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(type);
579}
580void ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
581 absl::string_view uri) {
582 rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(uri);
583}
584
Tommi3a5742c2020-05-20 09:32:51 +0200585void ModuleRtpRtcpImpl2::SetTmmbn(std::vector<rtcp::TmmbItem> bounding_set) {
586 rtcp_sender_.SetTmmbn(std::move(bounding_set));
587}
588
589// Send a Negative acknowledgment packet.
590int32_t ModuleRtpRtcpImpl2::SendNACK(const uint16_t* nack_list,
591 const uint16_t size) {
592 uint16_t nack_length = size;
593 uint16_t start_id = 0;
594 int64_t now_ms = clock_->TimeInMilliseconds();
595 if (TimeToSendFullNackList(now_ms)) {
596 nack_last_time_sent_full_ms_ = now_ms;
597 } else {
598 // Only send extended list.
599 if (nack_last_seq_number_sent_ == nack_list[size - 1]) {
600 // Last sequence number is the same, do not send list.
601 return 0;
602 }
603 // Send new sequence numbers.
604 for (int i = 0; i < size; ++i) {
605 if (nack_last_seq_number_sent_ == nack_list[i]) {
606 start_id = i + 1;
607 break;
608 }
609 }
610 nack_length = size - start_id;
611 }
612
613 // Our RTCP NACK implementation is limited to kRtcpMaxNackFields sequence
614 // numbers per RTCP packet.
615 if (nack_length > kRtcpMaxNackFields) {
616 nack_length = kRtcpMaxNackFields;
617 }
618 nack_last_seq_number_sent_ = nack_list[start_id + nack_length - 1];
619
620 return rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, nack_length,
621 &nack_list[start_id]);
622}
623
624void ModuleRtpRtcpImpl2::SendNack(
625 const std::vector<uint16_t>& sequence_numbers) {
626 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, sequence_numbers.size(),
627 sequence_numbers.data());
628}
629
630bool ModuleRtpRtcpImpl2::TimeToSendFullNackList(int64_t now) const {
631 // Use RTT from RtcpRttStats class if provided.
632 int64_t rtt = rtt_ms();
633 if (rtt == 0) {
634 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
635 }
636
637 const int64_t kStartUpRttMs = 100;
638 int64_t wait_time = 5 + ((rtt * 3) >> 1); // 5 + RTT * 1.5.
639 if (rtt == 0) {
640 wait_time = kStartUpRttMs;
641 }
642
Artem Titov913cfa72021-07-28 23:57:33 +0200643 // Send a full NACK list once within every `wait_time`.
Tommi3a5742c2020-05-20 09:32:51 +0200644 return now - nack_last_time_sent_full_ms_ > wait_time;
645}
646
647// Store the sent packets, needed to answer to Negative acknowledgment requests.
648void ModuleRtpRtcpImpl2::SetStorePacketsStatus(const bool enable,
649 const uint16_t number_to_store) {
650 rtp_sender_->packet_history.SetStorePacketsStatus(
651 enable ? RtpPacketHistory::StorageMode::kStoreAndCull
652 : RtpPacketHistory::StorageMode::kDisabled,
653 number_to_store);
654}
655
656bool ModuleRtpRtcpImpl2::StorePackets() const {
657 return rtp_sender_->packet_history.GetStorageMode() !=
658 RtpPacketHistory::StorageMode::kDisabled;
659}
660
661void ModuleRtpRtcpImpl2::SendCombinedRtcpPacket(
662 std::vector<std::unique_ptr<rtcp::RtcpPacket>> rtcp_packets) {
663 rtcp_sender_.SendCombinedRtcpPacket(std::move(rtcp_packets));
664}
665
666int32_t ModuleRtpRtcpImpl2::SendLossNotification(uint16_t last_decoded_seq_num,
667 uint16_t last_received_seq_num,
668 bool decodability_flag,
669 bool buffering_allowed) {
670 return rtcp_sender_.SendLossNotification(
671 GetFeedbackState(), last_decoded_seq_num, last_received_seq_num,
672 decodability_flag, buffering_allowed);
673}
674
675void ModuleRtpRtcpImpl2::SetRemoteSSRC(const uint32_t ssrc) {
676 // Inform about the incoming SSRC.
677 rtcp_sender_.SetRemoteSSRC(ssrc);
678 rtcp_receiver_.SetRemoteSSRC(ssrc);
679}
680
Tommi08be9ba2021-06-15 23:01:57 +0200681void ModuleRtpRtcpImpl2::SetLocalSsrc(uint32_t local_ssrc) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200682 RTC_DCHECK_RUN_ON(&rtcp_thread_checker_);
Tommi08be9ba2021-06-15 23:01:57 +0200683 rtcp_receiver_.set_local_media_ssrc(local_ssrc);
684 rtcp_sender_.SetSsrc(local_ssrc);
685}
686
Tommi3a5742c2020-05-20 09:32:51 +0200687RtpSendRates ModuleRtpRtcpImpl2::GetSendRates() const {
Tommi1050fbc2021-06-03 17:58:28 +0200688 // Typically called on the `rtp_transport_queue_` owned by an
689 // RtpTransportControllerSendInterface instance.
Tommi3a5742c2020-05-20 09:32:51 +0200690 return rtp_sender_->packet_sender.GetSendRates();
691}
692
693void ModuleRtpRtcpImpl2::OnRequestSendReport() {
694 SendRTCP(kRtcpSr);
695}
696
697void ModuleRtpRtcpImpl2::OnReceivedNack(
698 const std::vector<uint16_t>& nack_sequence_numbers) {
699 if (!rtp_sender_)
700 return;
701
702 if (!StorePackets() || nack_sequence_numbers.empty()) {
703 return;
704 }
705 // Use RTT from RtcpRttStats class if provided.
706 int64_t rtt = rtt_ms();
707 if (rtt == 0) {
708 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
709 }
710 rtp_sender_->packet_generator.OnReceivedNack(nack_sequence_numbers, rtt);
711}
712
713void ModuleRtpRtcpImpl2::OnReceivedRtcpReportBlocks(
714 const ReportBlockList& report_blocks) {
715 if (rtp_sender_) {
716 uint32_t ssrc = SSRC();
717 absl::optional<uint32_t> rtx_ssrc;
718 if (rtp_sender_->packet_generator.RtxStatus() != kRtxOff) {
719 rtx_ssrc = rtp_sender_->packet_generator.RtxSsrc();
720 }
721
722 for (const RTCPReportBlock& report_block : report_blocks) {
723 if (ssrc == report_block.source_ssrc) {
724 rtp_sender_->packet_generator.OnReceivedAckOnSsrc(
725 report_block.extended_highest_sequence_number);
726 } else if (rtx_ssrc && *rtx_ssrc == report_block.source_ssrc) {
727 rtp_sender_->packet_generator.OnReceivedAckOnRtxSsrc(
728 report_block.extended_highest_sequence_number);
729 }
730 }
731 }
732}
733
Tommi3a5742c2020-05-20 09:32:51 +0200734void ModuleRtpRtcpImpl2::set_rtt_ms(int64_t rtt_ms) {
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200735 RTC_DCHECK_RUN_ON(worker_queue_);
Tommi3a5742c2020-05-20 09:32:51 +0200736 {
Markus Handellf7303e62020-07-09 01:34:42 +0200737 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200738 rtt_ms_ = rtt_ms;
739 }
740 if (rtp_sender_) {
741 rtp_sender_->packet_history.SetRtt(rtt_ms);
742 }
743}
744
745int64_t ModuleRtpRtcpImpl2::rtt_ms() const {
Markus Handellf7303e62020-07-09 01:34:42 +0200746 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200747 return rtt_ms_;
748}
749
750void ModuleRtpRtcpImpl2::SetVideoBitrateAllocation(
751 const VideoBitrateAllocation& bitrate) {
752 rtcp_sender_.SetVideoBitrateAllocation(bitrate);
753}
754
755RTPSender* ModuleRtpRtcpImpl2::RtpSender() {
756 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
757}
758
759const RTPSender* ModuleRtpRtcpImpl2::RtpSender() const {
760 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
761}
762
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200763void ModuleRtpRtcpImpl2::PeriodicUpdate() {
764 RTC_DCHECK_RUN_ON(worker_queue_);
765
766 Timestamp check_since = clock_->CurrentTime() - kRttUpdateInterval;
767 absl::optional<TimeDelta> rtt =
768 rtcp_receiver_.OnPeriodicRttUpdate(check_since, rtcp_sender_.Sending());
769 if (rtt) {
Ivo Creusen8c40d512021-07-13 12:53:22 +0000770 if (rtt_stats_) {
771 rtt_stats_->OnRttUpdate(rtt->ms());
772 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200773 set_rtt_ms(rtt->ms());
774 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200775}
776
Markus Handell885d5382021-06-21 18:57:36 +0200777// RTC_RUN_ON(worker_queue_);
778void ModuleRtpRtcpImpl2::MaybeSendRtcp() {
779 if (rtcp_sender_.TimeToSendRTCPReport())
780 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
781}
782
783// TODO(bugs.webrtc.org/12889): Consider removing this function when the issue
784// is resolved.
785// RTC_RUN_ON(worker_queue_);
786void ModuleRtpRtcpImpl2::MaybeSendRtcpAtOrAfterTimestamp(
787 Timestamp execution_time) {
788 Timestamp now = clock_->CurrentTime();
789 if (now >= execution_time) {
790 MaybeSendRtcp();
791 return;
792 }
793
794 RTC_DLOG(LS_WARNING)
795 << "BUGBUG: Task queue scheduled delayed call too early.";
796
797 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, execution_time - now);
798}
799
800void ModuleRtpRtcpImpl2::ScheduleRtcpSendEvaluation(TimeDelta duration) {
801 // We end up here under various sequences including the worker queue, and
802 // the RTCPSender lock is held.
803 // We're assuming that the fact that RTCPSender executes under other sequences
804 // than the worker queue on which it's created on implies that external
805 // synchronization is present and removes this activity before destruction.
806 if (duration.IsZero()) {
807 worker_queue_->PostTask(ToQueuedTask(task_safety_, [this] {
808 RTC_DCHECK_RUN_ON(worker_queue_);
809 MaybeSendRtcp();
810 }));
811 } else {
812 Timestamp execution_time = clock_->CurrentTime() + duration;
813 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, duration);
814 }
815}
816
817void ModuleRtpRtcpImpl2::ScheduleMaybeSendRtcpAtOrAfterTimestamp(
818 Timestamp execution_time,
819 TimeDelta duration) {
820 // We end up here under various sequences including the worker queue, and
821 // the RTCPSender lock is held.
Artem Titov913cfa72021-07-28 23:57:33 +0200822 // See note in ScheduleRtcpSendEvaluation about why `worker_queue_` can be
Markus Handell885d5382021-06-21 18:57:36 +0200823 // accessed.
824 worker_queue_->PostDelayedTask(
825 ToQueuedTask(task_safety_,
826 [this, execution_time] {
827 RTC_DCHECK_RUN_ON(worker_queue_);
828 MaybeSendRtcpAtOrAfterTimestamp(execution_time);
829 }),
830 DelayMillisForDuration(duration));
831}
832
Tommi3a5742c2020-05-20 09:32:51 +0200833} // namespace webrtc