blob: 518f61020924a4c8867c7f3454b0356e6ce15dfe [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
Ali Tofighd14e8892022-05-13 11:42:16 +020022#include "absl/strings/string_view.h"
Markus Handellc6b9ac72021-06-18 13:44:51 +020023#include "absl/types/optional.h"
Markus Handell885d5382021-06-21 18:57:36 +020024#include "api/sequence_checker.h"
Artem Titovc374d112022-06-16 21:27:45 +020025#include "api/task_queue/to_queued_task.h"
Tommi3a5742c2020-05-20 09:32:51 +020026#include "api/transport/field_trial_based_config.h"
Markus Handell885d5382021-06-21 18:57:36 +020027#include "api/units/time_delta.h"
Markus Handellc6b9ac72021-06-18 13:44:51 +020028#include "api/units/timestamp.h"
Tommi3a5742c2020-05-20 09:32:51 +020029#include "modules/rtp_rtcp/source/rtcp_packet/dlrr.h"
30#include "modules/rtp_rtcp/source/rtp_rtcp_config.h"
31#include "rtc_base/checks.h"
32#include "rtc_base/logging.h"
Markus Handell885d5382021-06-21 18:57:36 +020033#include "rtc_base/time_utils.h"
Alessio Bazzicabc1c93d2021-03-12 17:45:26 +010034#include "system_wrappers/include/ntp_time.h"
Tommi3a5742c2020-05-20 09:32:51 +020035
36#ifdef _WIN32
37// Disable warning C4355: 'this' : used in base member initializer list.
38#pragma warning(disable : 4355)
39#endif
40
41namespace webrtc {
42namespace {
Tommi3a5742c2020-05-20 09:32:51 +020043const int64_t kDefaultExpectedRetransmissionTimeMs = 125;
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +020044
45constexpr TimeDelta kRttUpdateInterval = TimeDelta::Millis(1000);
Markus Handell885d5382021-06-21 18:57:36 +020046
47RTCPSender::Configuration AddRtcpSendEvaluationCallback(
48 RTCPSender::Configuration config,
49 std::function<void(TimeDelta)> send_evaluation_callback) {
50 config.schedule_next_rtcp_send_evaluation_function =
51 std::move(send_evaluation_callback);
52 return config;
53}
54
55int DelayMillisForDuration(TimeDelta duration) {
56 // TimeDelta::ms() rounds downwards sometimes which leads to too little time
Artem Titov913cfa72021-07-28 23:57:33 +020057 // slept. Account for this, unless `duration` is exactly representable in
Markus Handell885d5382021-06-21 18:57:36 +020058 // millisecs.
59 return (duration.us() + rtc::kNumMillisecsPerSec - 1) /
60 rtc::kNumMicrosecsPerMillisec;
61}
Tommi3a5742c2020-05-20 09:32:51 +020062} // namespace
63
64ModuleRtpRtcpImpl2::RtpSenderContext::RtpSenderContext(
Tomas Gunnarssonf25761d2020-06-03 22:55:33 +020065 const RtpRtcpInterface::Configuration& config)
Tommi3a5742c2020-05-20 09:32:51 +020066 : packet_history(config.clock, config.enable_rtx_padding_prioritization),
Erik Språngb6bbdeb2021-08-13 16:12:41 +020067 sequencer(config.local_media_ssrc,
68 config.rtx_send_ssrc,
69 /*require_marker_before_media_padding=*/!config.audio,
70 config.clock),
Tommi3a5742c2020-05-20 09:32:51 +020071 packet_sender(config, &packet_history),
Erik Språng54abf982021-08-13 17:25:44 +020072 non_paced_sender(&packet_sender, &sequencer),
Tommi3a5742c2020-05-20 09:32:51 +020073 packet_generator(
74 config,
75 &packet_history,
Erik Språng54abf982021-08-13 17:25:44 +020076 config.paced_sender ? config.paced_sender : &non_paced_sender) {}
Tommi3a5742c2020-05-20 09:32:51 +020077
Tommi3a5742c2020-05-20 09:32:51 +020078ModuleRtpRtcpImpl2::ModuleRtpRtcpImpl2(const Configuration& configuration)
Niels Moller2accc7d2021-01-12 15:54:16 +000079 : worker_queue_(TaskQueueBase::Current()),
Markus Handell885d5382021-06-21 18:57:36 +020080 rtcp_sender_(AddRtcpSendEvaluationCallback(
81 RTCPSender::Configuration::FromRtpRtcpConfiguration(configuration),
82 [this](TimeDelta duration) {
83 ScheduleRtcpSendEvaluation(duration);
84 })),
Tommi3a5742c2020-05-20 09:32:51 +020085 rtcp_receiver_(configuration, this),
86 clock_(configuration.clock),
Tommi3a5742c2020-05-20 09:32:51 +020087 packet_overhead_(28), // IPV4 UDP.
88 nack_last_time_sent_full_ms_(0),
89 nack_last_seq_number_sent_(0),
Tommi3a5742c2020-05-20 09:32:51 +020090 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
Ali Tofighd14e8892022-05-13 11:42:16 +0200230void ModuleRtpRtcpImpl2::SetMid(absl::string_view mid) {
Tommi3a5742c2020-05-20 09:32:51 +0200231 if (rtp_sender_) {
232 rtp_sender_->packet_generator.SetMid(mid);
233 }
234 // TODO(bugs.webrtc.org/4050): If we end up supporting the MID SDES item for
235 // RTCP, this will need to be passed down to the RTCPSender also.
236}
237
238void ModuleRtpRtcpImpl2::SetCsrcs(const std::vector<uint32_t>& csrcs) {
239 rtcp_sender_.SetCsrcs(csrcs);
240 rtp_sender_->packet_generator.SetCsrcs(csrcs);
241}
242
243// TODO(pbos): Handle media and RTX streams separately (separate RTCP
244// feedbacks).
245RTCPSender::FeedbackState ModuleRtpRtcpImpl2::GetFeedbackState() {
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200246 // TODO(bugs.webrtc.org/11581): Called by potentially multiple threads.
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200247 // Mostly "Send*" methods. Make sure it's only called on the
Tomas Gunnarssona1163742020-06-29 17:41:22 +0200248 // construction thread.
249
Tommi3a5742c2020-05-20 09:32:51 +0200250 RTCPSender::FeedbackState state;
251 // This is called also when receiver_only is true. Hence below
252 // checks that rtp_sender_ exists.
253 if (rtp_sender_) {
254 StreamDataCounters rtp_stats;
255 StreamDataCounters rtx_stats;
256 rtp_sender_->packet_sender.GetDataCounters(&rtp_stats, &rtx_stats);
257 state.packets_sent =
258 rtp_stats.transmitted.packets + rtx_stats.transmitted.packets;
259 state.media_bytes_sent = rtp_stats.transmitted.payload_bytes +
260 rtx_stats.transmitted.payload_bytes;
261 state.send_bitrate =
262 rtp_sender_->packet_sender.GetSendRates().Sum().bps<uint32_t>();
263 }
264 state.receiver = &rtcp_receiver_;
265
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100266 uint32_t received_ntp_secs = 0;
267 uint32_t received_ntp_frac = 0;
268 state.remote_sr = 0;
269 if (rtcp_receiver_.NTP(&received_ntp_secs, &received_ntp_frac,
270 /*rtcp_arrival_time_secs=*/&state.last_rr_ntp_secs,
271 /*rtcp_arrival_time_frac=*/&state.last_rr_ntp_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100272 /*rtcp_timestamp=*/nullptr,
273 /*remote_sender_packet_count=*/nullptr,
274 /*remote_sender_octet_count=*/nullptr,
275 /*remote_sender_reports_count=*/nullptr)) {
Alessio Bazzica79011ef2021-03-10 14:52:35 +0100276 state.remote_sr = ((received_ntp_secs & 0x0000ffff) << 16) +
277 ((received_ntp_frac & 0xffff0000) >> 16);
278 }
Tommi3a5742c2020-05-20 09:32:51 +0200279
280 state.last_xr_rtis = rtcp_receiver_.ConsumeReceivedXrReferenceTimeInfo();
281
282 return state;
283}
284
285// TODO(nisse): This method shouldn't be called for a receive-only
286// stream. Delete rtp_sender_ check as soon as all applications are
287// updated.
288int32_t ModuleRtpRtcpImpl2::SetSendingStatus(const bool sending) {
289 if (rtcp_sender_.Sending() != sending) {
290 // Sends RTCP BYE when going from true to false
Tomas Gunnarssondbcf5d32021-04-23 20:31:08 +0200291 rtcp_sender_.SetSendingStatus(GetFeedbackState(), sending);
Tommi3a5742c2020-05-20 09:32:51 +0200292 }
293 return 0;
294}
295
296bool ModuleRtpRtcpImpl2::Sending() const {
297 return rtcp_sender_.Sending();
298}
299
300// TODO(nisse): This method shouldn't be called for a receive-only
301// stream. Delete rtp_sender_ check as soon as all applications are
302// updated.
303void ModuleRtpRtcpImpl2::SetSendingMediaStatus(const bool sending) {
304 if (rtp_sender_) {
305 rtp_sender_->packet_generator.SetSendingMediaStatus(sending);
306 } else {
307 RTC_DCHECK(!sending);
308 }
309}
310
311bool ModuleRtpRtcpImpl2::SendingMedia() const {
312 return rtp_sender_ ? rtp_sender_->packet_generator.SendingMedia() : false;
313}
314
315bool ModuleRtpRtcpImpl2::IsAudioConfigured() const {
316 return rtp_sender_ ? rtp_sender_->packet_generator.IsAudioConfigured()
317 : false;
318}
319
320void ModuleRtpRtcpImpl2::SetAsPartOfAllocation(bool part_of_allocation) {
321 RTC_CHECK(rtp_sender_);
322 rtp_sender_->packet_sender.ForceIncludeSendPacketsInAllocation(
323 part_of_allocation);
324}
325
326bool ModuleRtpRtcpImpl2::OnSendingRtpFrame(uint32_t timestamp,
327 int64_t capture_time_ms,
328 int payload_type,
329 bool force_sender_report) {
330 if (!Sending())
331 return false;
332
Markus Handellc6b9ac72021-06-18 13:44:51 +0200333 // TODO(bugs.webrtc.org/12873): Migrate this method and it's users to use
334 // optional Timestamps.
335 absl::optional<Timestamp> capture_time;
336 if (capture_time_ms > 0) {
337 capture_time = Timestamp::Millis(capture_time_ms);
338 }
339 absl::optional<int> payload_type_optional;
340 if (payload_type >= 0)
341 payload_type_optional = payload_type;
342 rtcp_sender_.SetLastRtpTime(timestamp, capture_time, payload_type_optional);
Tommi3a5742c2020-05-20 09:32:51 +0200343 // Make sure an RTCP report isn't queued behind a key frame.
344 if (rtcp_sender_.TimeToSendRTCPReport(force_sender_report))
345 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
346
347 return true;
348}
349
350bool ModuleRtpRtcpImpl2::TrySendPacket(RtpPacketToSend* packet,
351 const PacedPacketInfo& pacing_info) {
352 RTC_DCHECK(rtp_sender_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200353 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språng54abf982021-08-13 17:25:44 +0200354 if (!rtp_sender_->packet_generator.SendingMedia()) {
Tommi3a5742c2020-05-20 09:32:51 +0200355 return false;
356 }
Erik Språng54abf982021-08-13 17:25:44 +0200357 if (packet->packet_type() == RtpPacketMediaType::kPadding &&
358 packet->Ssrc() == rtp_sender_->packet_generator.SSRC() &&
359 !rtp_sender_->sequencer.CanSendPaddingOnMediaSsrc()) {
360 // New media packet preempted this generated padding packet, discard it.
361 return false;
362 }
363 bool is_flexfec =
364 packet->packet_type() == RtpPacketMediaType::kForwardErrorCorrection &&
365 packet->Ssrc() == rtp_sender_->packet_generator.FlexfecSsrc();
366 if (!is_flexfec) {
367 rtp_sender_->sequencer.Sequence(*packet);
368 }
369
Tommi3a5742c2020-05-20 09:32:51 +0200370 rtp_sender_->packet_sender.SendPacket(packet, pacing_info);
371 return true;
372}
373
Erik Språng1d50cb62020-07-02 17:41:32 +0200374void ModuleRtpRtcpImpl2::SetFecProtectionParams(
375 const FecProtectionParams& delta_params,
376 const FecProtectionParams& key_params) {
377 RTC_DCHECK(rtp_sender_);
378 rtp_sender_->packet_sender.SetFecProtectionParameters(delta_params,
379 key_params);
380}
381
382std::vector<std::unique_ptr<RtpPacketToSend>>
383ModuleRtpRtcpImpl2::FetchFecPackets() {
384 RTC_DCHECK(rtp_sender_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200385 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språng54abf982021-08-13 17:25:44 +0200386 return rtp_sender_->packet_sender.FetchFecPackets();
Erik Språng1d50cb62020-07-02 17:41:32 +0200387}
388
Tommi3a5742c2020-05-20 09:32:51 +0200389void ModuleRtpRtcpImpl2::OnPacketsAcknowledged(
390 rtc::ArrayView<const uint16_t> sequence_numbers) {
391 RTC_DCHECK(rtp_sender_);
392 rtp_sender_->packet_history.CullAcknowledgedPackets(sequence_numbers);
393}
394
395bool ModuleRtpRtcpImpl2::SupportsPadding() const {
396 RTC_DCHECK(rtp_sender_);
397 return rtp_sender_->packet_generator.SupportsPadding();
398}
399
400bool ModuleRtpRtcpImpl2::SupportsRtxPayloadPadding() const {
401 RTC_DCHECK(rtp_sender_);
402 return rtp_sender_->packet_generator.SupportsRtxPayloadPadding();
403}
404
405std::vector<std::unique_ptr<RtpPacketToSend>>
406ModuleRtpRtcpImpl2::GeneratePadding(size_t target_size_bytes) {
407 RTC_DCHECK(rtp_sender_);
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200408 RTC_DCHECK_RUN_ON(&rtp_sender_->sequencing_checker);
Erik Språngbb904972021-08-06 13:10:11 +0200409
Tommi3a5742c2020-05-20 09:32:51 +0200410 return rtp_sender_->packet_generator.GeneratePadding(
Erik Språngbfcfe032021-08-04 14:45:32 +0200411 target_size_bytes, rtp_sender_->packet_sender.MediaHasBeenSent(),
Erik Språng54abf982021-08-13 17:25:44 +0200412 rtp_sender_->sequencer.CanSendPaddingOnMediaSsrc());
Tommi3a5742c2020-05-20 09:32:51 +0200413}
414
415std::vector<RtpSequenceNumberMap::Info>
416ModuleRtpRtcpImpl2::GetSentRtpPacketInfos(
417 rtc::ArrayView<const uint16_t> sequence_numbers) const {
418 RTC_DCHECK(rtp_sender_);
419 return rtp_sender_->packet_sender.GetSentRtpPacketInfos(sequence_numbers);
420}
421
422size_t ModuleRtpRtcpImpl2::ExpectedPerPacketOverhead() const {
423 if (!rtp_sender_) {
424 return 0;
425 }
426 return rtp_sender_->packet_generator.ExpectedPerPacketOverhead();
427}
428
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200429void ModuleRtpRtcpImpl2::OnPacketSendingThreadSwitched() {
430 // Ownership of sequencing is being transferred to another thread.
431 rtp_sender_->sequencing_checker.Detach();
432}
433
Tommi3a5742c2020-05-20 09:32:51 +0200434size_t ModuleRtpRtcpImpl2::MaxRtpPacketSize() const {
435 RTC_DCHECK(rtp_sender_);
436 return rtp_sender_->packet_generator.MaxRtpPacketSize();
437}
438
439void ModuleRtpRtcpImpl2::SetMaxRtpPacketSize(size_t rtp_packet_size) {
440 RTC_DCHECK_LE(rtp_packet_size, IP_PACKET_SIZE)
441 << "rtp packet size too large: " << rtp_packet_size;
442 RTC_DCHECK_GT(rtp_packet_size, packet_overhead_)
443 << "rtp packet size too small: " << rtp_packet_size;
444
445 rtcp_sender_.SetMaxRtpPacketSize(rtp_packet_size);
446 if (rtp_sender_) {
447 rtp_sender_->packet_generator.SetMaxRtpPacketSize(rtp_packet_size);
448 }
449}
450
451RtcpMode ModuleRtpRtcpImpl2::RTCP() const {
452 return rtcp_sender_.Status();
453}
454
455// Configure RTCP status i.e on/off.
456void ModuleRtpRtcpImpl2::SetRTCPStatus(const RtcpMode method) {
457 rtcp_sender_.SetRTCPStatus(method);
458}
459
Ali Tofighd14e8892022-05-13 11:42:16 +0200460int32_t ModuleRtpRtcpImpl2::SetCNAME(absl::string_view c_name) {
Tommi3a5742c2020-05-20 09:32:51 +0200461 return rtcp_sender_.SetCNAME(c_name);
462}
463
Tommi3a5742c2020-05-20 09:32:51 +0200464int32_t ModuleRtpRtcpImpl2::RemoteNTP(uint32_t* received_ntpsecs,
465 uint32_t* received_ntpfrac,
466 uint32_t* rtcp_arrival_time_secs,
467 uint32_t* rtcp_arrival_time_frac,
468 uint32_t* rtcp_timestamp) const {
469 return rtcp_receiver_.NTP(received_ntpsecs, received_ntpfrac,
470 rtcp_arrival_time_secs, rtcp_arrival_time_frac,
Alessio Bazzica048adc72021-03-10 15:05:55 +0100471 rtcp_timestamp,
472 /*remote_sender_packet_count=*/nullptr,
473 /*remote_sender_octet_count=*/nullptr,
474 /*remote_sender_reports_count=*/nullptr)
Tommi3a5742c2020-05-20 09:32:51 +0200475 ? 0
476 : -1;
477}
478
Artem Titov913cfa72021-07-28 23:57:33 +0200479// TODO(tommi): Check if `avg_rtt_ms`, `min_rtt_ms`, `max_rtt_ms` params are
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200480// actually used in practice (some callers ask for it but don't use it). It
Artem Titov913cfa72021-07-28 23:57:33 +0200481// could be that only `rtt` is needed and if so, then the fast path could be to
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200482// just call rtt_ms() and rely on the calculation being done periodically.
Tommi3a5742c2020-05-20 09:32:51 +0200483int32_t ModuleRtpRtcpImpl2::RTT(const uint32_t remote_ssrc,
484 int64_t* rtt,
485 int64_t* avg_rtt,
486 int64_t* min_rtt,
487 int64_t* max_rtt) const {
488 int32_t ret = rtcp_receiver_.RTT(remote_ssrc, rtt, avg_rtt, min_rtt, max_rtt);
489 if (rtt && *rtt == 0) {
490 // Try to get RTT from RtcpRttStats class.
491 *rtt = rtt_ms();
492 }
493 return ret;
494}
495
496int64_t ModuleRtpRtcpImpl2::ExpectedRetransmissionTimeMs() const {
497 int64_t expected_retransmission_time_ms = rtt_ms();
498 if (expected_retransmission_time_ms > 0) {
499 return expected_retransmission_time_ms;
500 }
Artem Titov913cfa72021-07-28 23:57:33 +0200501 // No rtt available (`kRttUpdateInterval` not yet passed?), so try to
Tommi3a5742c2020-05-20 09:32:51 +0200502 // poll avg_rtt_ms directly from rtcp receiver.
503 if (rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), nullptr,
504 &expected_retransmission_time_ms, nullptr,
505 nullptr) == 0) {
506 return expected_retransmission_time_ms;
507 }
508 return kDefaultExpectedRetransmissionTimeMs;
509}
510
511// Force a send of an RTCP packet.
512// Normal SR and RR are triggered via the process function.
513int32_t ModuleRtpRtcpImpl2::SendRTCP(RTCPPacketType packet_type) {
514 return rtcp_sender_.SendRTCP(GetFeedbackState(), packet_type);
515}
516
Tommi3a5742c2020-05-20 09:32:51 +0200517void ModuleRtpRtcpImpl2::GetSendStreamDataCounters(
518 StreamDataCounters* rtp_counters,
519 StreamDataCounters* rtx_counters) const {
520 rtp_sender_->packet_sender.GetDataCounters(rtp_counters, rtx_counters);
521}
522
523// Received RTCP report.
Tommi3a5742c2020-05-20 09:32:51 +0200524std::vector<ReportBlockData> ModuleRtpRtcpImpl2::GetLatestReportBlockData()
525 const {
526 return rtcp_receiver_.GetLatestReportBlockData();
527}
528
Alessio Bazzicabc1c93d2021-03-12 17:45:26 +0100529absl::optional<RtpRtcpInterface::SenderReportStats>
530ModuleRtpRtcpImpl2::GetSenderReportStats() const {
531 SenderReportStats stats;
532 uint32_t remote_timestamp_secs;
533 uint32_t remote_timestamp_frac;
534 uint32_t arrival_timestamp_secs;
535 uint32_t arrival_timestamp_frac;
536 if (rtcp_receiver_.NTP(&remote_timestamp_secs, &remote_timestamp_frac,
537 &arrival_timestamp_secs, &arrival_timestamp_frac,
538 /*rtcp_timestamp=*/nullptr, &stats.packets_sent,
539 &stats.bytes_sent, &stats.reports_count)) {
540 stats.last_remote_timestamp.Set(remote_timestamp_secs,
541 remote_timestamp_frac);
542 stats.last_arrival_timestamp.Set(arrival_timestamp_secs,
543 arrival_timestamp_frac);
544 return stats;
545 }
546 return absl::nullopt;
547}
548
Ivo Creusen2562cf02021-09-03 14:51:22 +0000549absl::optional<RtpRtcpInterface::NonSenderRttStats>
550ModuleRtpRtcpImpl2::GetNonSenderRttStats() const {
551 RTCPReceiver::NonSenderRttStats non_sender_rtt_stats =
552 rtcp_receiver_.GetNonSenderRTT();
553 return {{
554 non_sender_rtt_stats.round_trip_time(),
555 non_sender_rtt_stats.total_round_trip_time(),
556 non_sender_rtt_stats.round_trip_time_measurements(),
557 }};
558}
559
Tommi3a5742c2020-05-20 09:32:51 +0200560// (REMB) Receiver Estimated Max Bitrate.
561void ModuleRtpRtcpImpl2::SetRemb(int64_t bitrate_bps,
562 std::vector<uint32_t> ssrcs) {
563 rtcp_sender_.SetRemb(bitrate_bps, std::move(ssrcs));
564}
565
566void ModuleRtpRtcpImpl2::UnsetRemb() {
567 rtcp_sender_.UnsetRemb();
568}
569
570void ModuleRtpRtcpImpl2::SetExtmapAllowMixed(bool extmap_allow_mixed) {
571 rtp_sender_->packet_generator.SetExtmapAllowMixed(extmap_allow_mixed);
572}
573
Tommi3a5742c2020-05-20 09:32:51 +0200574void ModuleRtpRtcpImpl2::RegisterRtpHeaderExtension(absl::string_view uri,
575 int id) {
576 bool registered =
577 rtp_sender_->packet_generator.RegisterRtpHeaderExtension(uri, id);
578 RTC_CHECK(registered);
579}
580
Tommi3a5742c2020-05-20 09:32:51 +0200581void ModuleRtpRtcpImpl2::DeregisterSendRtpHeaderExtension(
582 absl::string_view uri) {
583 rtp_sender_->packet_generator.DeregisterRtpHeaderExtension(uri);
584}
585
Tommi3a5742c2020-05-20 09:32:51 +0200586void ModuleRtpRtcpImpl2::SetTmmbn(std::vector<rtcp::TmmbItem> bounding_set) {
587 rtcp_sender_.SetTmmbn(std::move(bounding_set));
588}
589
590// Send a Negative acknowledgment packet.
591int32_t ModuleRtpRtcpImpl2::SendNACK(const uint16_t* nack_list,
592 const uint16_t size) {
593 uint16_t nack_length = size;
594 uint16_t start_id = 0;
595 int64_t now_ms = clock_->TimeInMilliseconds();
596 if (TimeToSendFullNackList(now_ms)) {
597 nack_last_time_sent_full_ms_ = now_ms;
598 } else {
599 // Only send extended list.
600 if (nack_last_seq_number_sent_ == nack_list[size - 1]) {
601 // Last sequence number is the same, do not send list.
602 return 0;
603 }
604 // Send new sequence numbers.
605 for (int i = 0; i < size; ++i) {
606 if (nack_last_seq_number_sent_ == nack_list[i]) {
607 start_id = i + 1;
608 break;
609 }
610 }
611 nack_length = size - start_id;
612 }
613
614 // Our RTCP NACK implementation is limited to kRtcpMaxNackFields sequence
615 // numbers per RTCP packet.
616 if (nack_length > kRtcpMaxNackFields) {
617 nack_length = kRtcpMaxNackFields;
618 }
619 nack_last_seq_number_sent_ = nack_list[start_id + nack_length - 1];
620
621 return rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, nack_length,
622 &nack_list[start_id]);
623}
624
625void ModuleRtpRtcpImpl2::SendNack(
626 const std::vector<uint16_t>& sequence_numbers) {
627 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpNack, sequence_numbers.size(),
628 sequence_numbers.data());
629}
630
631bool ModuleRtpRtcpImpl2::TimeToSendFullNackList(int64_t now) const {
632 // Use RTT from RtcpRttStats class if provided.
633 int64_t rtt = rtt_ms();
634 if (rtt == 0) {
635 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
636 }
637
638 const int64_t kStartUpRttMs = 100;
639 int64_t wait_time = 5 + ((rtt * 3) >> 1); // 5 + RTT * 1.5.
640 if (rtt == 0) {
641 wait_time = kStartUpRttMs;
642 }
643
Artem Titov913cfa72021-07-28 23:57:33 +0200644 // Send a full NACK list once within every `wait_time`.
Tommi3a5742c2020-05-20 09:32:51 +0200645 return now - nack_last_time_sent_full_ms_ > wait_time;
646}
647
648// Store the sent packets, needed to answer to Negative acknowledgment requests.
649void ModuleRtpRtcpImpl2::SetStorePacketsStatus(const bool enable,
650 const uint16_t number_to_store) {
651 rtp_sender_->packet_history.SetStorePacketsStatus(
652 enable ? RtpPacketHistory::StorageMode::kStoreAndCull
653 : RtpPacketHistory::StorageMode::kDisabled,
654 number_to_store);
655}
656
657bool ModuleRtpRtcpImpl2::StorePackets() const {
658 return rtp_sender_->packet_history.GetStorageMode() !=
659 RtpPacketHistory::StorageMode::kDisabled;
660}
661
662void ModuleRtpRtcpImpl2::SendCombinedRtcpPacket(
663 std::vector<std::unique_ptr<rtcp::RtcpPacket>> rtcp_packets) {
664 rtcp_sender_.SendCombinedRtcpPacket(std::move(rtcp_packets));
665}
666
667int32_t ModuleRtpRtcpImpl2::SendLossNotification(uint16_t last_decoded_seq_num,
668 uint16_t last_received_seq_num,
669 bool decodability_flag,
670 bool buffering_allowed) {
671 return rtcp_sender_.SendLossNotification(
672 GetFeedbackState(), last_decoded_seq_num, last_received_seq_num,
673 decodability_flag, buffering_allowed);
674}
675
676void ModuleRtpRtcpImpl2::SetRemoteSSRC(const uint32_t ssrc) {
677 // Inform about the incoming SSRC.
678 rtcp_sender_.SetRemoteSSRC(ssrc);
679 rtcp_receiver_.SetRemoteSSRC(ssrc);
680}
681
Tommi08be9ba2021-06-15 23:01:57 +0200682void ModuleRtpRtcpImpl2::SetLocalSsrc(uint32_t local_ssrc) {
Erik Språngb6bbdeb2021-08-13 16:12:41 +0200683 RTC_DCHECK_RUN_ON(&rtcp_thread_checker_);
Tommi08be9ba2021-06-15 23:01:57 +0200684 rtcp_receiver_.set_local_media_ssrc(local_ssrc);
685 rtcp_sender_.SetSsrc(local_ssrc);
686}
687
Tommi3a5742c2020-05-20 09:32:51 +0200688RtpSendRates ModuleRtpRtcpImpl2::GetSendRates() const {
Tommi1050fbc2021-06-03 17:58:28 +0200689 // Typically called on the `rtp_transport_queue_` owned by an
690 // RtpTransportControllerSendInterface instance.
Tommi3a5742c2020-05-20 09:32:51 +0200691 return rtp_sender_->packet_sender.GetSendRates();
692}
693
694void ModuleRtpRtcpImpl2::OnRequestSendReport() {
695 SendRTCP(kRtcpSr);
696}
697
698void ModuleRtpRtcpImpl2::OnReceivedNack(
699 const std::vector<uint16_t>& nack_sequence_numbers) {
700 if (!rtp_sender_)
701 return;
702
703 if (!StorePackets() || nack_sequence_numbers.empty()) {
704 return;
705 }
706 // Use RTT from RtcpRttStats class if provided.
707 int64_t rtt = rtt_ms();
708 if (rtt == 0) {
709 rtcp_receiver_.RTT(rtcp_receiver_.RemoteSSRC(), NULL, &rtt, NULL, NULL);
710 }
711 rtp_sender_->packet_generator.OnReceivedNack(nack_sequence_numbers, rtt);
712}
713
714void ModuleRtpRtcpImpl2::OnReceivedRtcpReportBlocks(
715 const ReportBlockList& report_blocks) {
716 if (rtp_sender_) {
717 uint32_t ssrc = SSRC();
718 absl::optional<uint32_t> rtx_ssrc;
719 if (rtp_sender_->packet_generator.RtxStatus() != kRtxOff) {
720 rtx_ssrc = rtp_sender_->packet_generator.RtxSsrc();
721 }
722
723 for (const RTCPReportBlock& report_block : report_blocks) {
724 if (ssrc == report_block.source_ssrc) {
725 rtp_sender_->packet_generator.OnReceivedAckOnSsrc(
726 report_block.extended_highest_sequence_number);
727 } else if (rtx_ssrc && *rtx_ssrc == report_block.source_ssrc) {
728 rtp_sender_->packet_generator.OnReceivedAckOnRtxSsrc(
729 report_block.extended_highest_sequence_number);
730 }
731 }
732 }
733}
734
Tommi3a5742c2020-05-20 09:32:51 +0200735void ModuleRtpRtcpImpl2::set_rtt_ms(int64_t rtt_ms) {
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200736 RTC_DCHECK_RUN_ON(worker_queue_);
Tommi3a5742c2020-05-20 09:32:51 +0200737 {
Markus Handellf7303e62020-07-09 01:34:42 +0200738 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200739 rtt_ms_ = rtt_ms;
740 }
741 if (rtp_sender_) {
Danil Chapovalova2ee9232022-03-04 15:03:02 +0100742 rtp_sender_->packet_history.SetRtt(TimeDelta::Millis(rtt_ms));
Tommi3a5742c2020-05-20 09:32:51 +0200743 }
744}
745
746int64_t ModuleRtpRtcpImpl2::rtt_ms() const {
Markus Handellf7303e62020-07-09 01:34:42 +0200747 MutexLock lock(&mutex_rtt_);
Tommi3a5742c2020-05-20 09:32:51 +0200748 return rtt_ms_;
749}
750
751void ModuleRtpRtcpImpl2::SetVideoBitrateAllocation(
752 const VideoBitrateAllocation& bitrate) {
753 rtcp_sender_.SetVideoBitrateAllocation(bitrate);
754}
755
756RTPSender* ModuleRtpRtcpImpl2::RtpSender() {
757 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
758}
759
760const RTPSender* ModuleRtpRtcpImpl2::RtpSender() const {
761 return rtp_sender_ ? &rtp_sender_->packet_generator : nullptr;
762}
763
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200764void ModuleRtpRtcpImpl2::PeriodicUpdate() {
765 RTC_DCHECK_RUN_ON(worker_queue_);
766
767 Timestamp check_since = clock_->CurrentTime() - kRttUpdateInterval;
768 absl::optional<TimeDelta> rtt =
769 rtcp_receiver_.OnPeriodicRttUpdate(check_since, rtcp_sender_.Sending());
770 if (rtt) {
Ivo Creusen8c40d512021-07-13 12:53:22 +0000771 if (rtt_stats_) {
772 rtt_stats_->OnRttUpdate(rtt->ms());
773 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200774 set_rtt_ms(rtt->ms());
775 }
Tomas Gunnarssonba0ba712020-07-01 08:53:21 +0200776}
777
Markus Handell885d5382021-06-21 18:57:36 +0200778// RTC_RUN_ON(worker_queue_);
779void ModuleRtpRtcpImpl2::MaybeSendRtcp() {
780 if (rtcp_sender_.TimeToSendRTCPReport())
781 rtcp_sender_.SendRTCP(GetFeedbackState(), kRtcpReport);
782}
783
784// TODO(bugs.webrtc.org/12889): Consider removing this function when the issue
785// is resolved.
786// RTC_RUN_ON(worker_queue_);
787void ModuleRtpRtcpImpl2::MaybeSendRtcpAtOrAfterTimestamp(
788 Timestamp execution_time) {
789 Timestamp now = clock_->CurrentTime();
790 if (now >= execution_time) {
791 MaybeSendRtcp();
792 return;
793 }
794
795 RTC_DLOG(LS_WARNING)
796 << "BUGBUG: Task queue scheduled delayed call too early.";
797
798 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, execution_time - now);
799}
800
801void ModuleRtpRtcpImpl2::ScheduleRtcpSendEvaluation(TimeDelta duration) {
802 // We end up here under various sequences including the worker queue, and
803 // the RTCPSender lock is held.
804 // We're assuming that the fact that RTCPSender executes under other sequences
805 // than the worker queue on which it's created on implies that external
806 // synchronization is present and removes this activity before destruction.
807 if (duration.IsZero()) {
808 worker_queue_->PostTask(ToQueuedTask(task_safety_, [this] {
809 RTC_DCHECK_RUN_ON(worker_queue_);
810 MaybeSendRtcp();
811 }));
812 } else {
813 Timestamp execution_time = clock_->CurrentTime() + duration;
814 ScheduleMaybeSendRtcpAtOrAfterTimestamp(execution_time, duration);
815 }
816}
817
818void ModuleRtpRtcpImpl2::ScheduleMaybeSendRtcpAtOrAfterTimestamp(
819 Timestamp execution_time,
820 TimeDelta duration) {
821 // We end up here under various sequences including the worker queue, and
822 // the RTCPSender lock is held.
Artem Titov913cfa72021-07-28 23:57:33 +0200823 // See note in ScheduleRtcpSendEvaluation about why `worker_queue_` can be
Markus Handell885d5382021-06-21 18:57:36 +0200824 // accessed.
825 worker_queue_->PostDelayedTask(
826 ToQueuedTask(task_safety_,
827 [this, execution_time] {
828 RTC_DCHECK_RUN_ON(worker_queue_);
829 MaybeSendRtcpAtOrAfterTimestamp(execution_time);
830 }),
831 DelayMillisForDuration(duration));
832}
833
Tommi3a5742c2020-05-20 09:32:51 +0200834} // namespace webrtc