blob: b762e60e88c214b860435384b3e10a314f5f646c [file] [log] [blame]
niklase@google.com470e71d2011-07-07 08:21:25 +00001/*
pwestin@webrtc.orgf6bb77a2012-01-24 17:16:59 +00002 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
niklase@google.com470e71d2011-07-07 08:21:25 +00003 *
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
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "modules/rtp_rtcp/source/rtp_sender.h"
pwestin@webrtc.org571a1c02012-11-13 21:12:39 +000012
danilchapb8b6fbb2015-12-10 05:05:27 -080013#include <algorithm>
Johannes Kron965e7942018-09-13 15:36:20 +020014#include <limits>
Steve Anton296a0ce2018-03-22 15:17:27 -070015#include <string>
Shao Changbine62202f2015-04-21 20:24:50 +080016#include <utility>
niklase@google.com470e71d2011-07-07 08:21:25 +000017
Karl Wiberg918f50c2018-07-05 11:40:33 +020018#include "absl/memory/memory.h"
Niels Mölleraa3c1cc2018-11-02 10:54:56 +010019#include "absl/strings/match.h"
Amit Hilbuch77938e62018-12-21 09:23:38 -080020#include "api/array_view.h"
Erik Språng4580ca22019-07-04 10:38:43 +020021#include "api/transport/field_trial_based_config.h"
Elad Alon4a87e1c2017-10-03 16:11:34 +020022#include "logging/rtc_event_log/events/rtc_event_rtp_packet_outgoing.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020023#include "logging/rtc_event_log/rtc_event_log.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020024#include "modules/rtp_rtcp/include/rtp_cvo.h"
25#include "modules/rtp_rtcp/source/byte_io.h"
philipel569397f2018-09-26 12:25:31 +020026#include "modules/rtp_rtcp/source/rtp_generic_frame_descriptor_extension.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020027#include "modules/rtp_rtcp/source/rtp_header_extensions.h"
28#include "modules/rtp_rtcp/source/rtp_packet_to_send.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020029#include "modules/rtp_rtcp/source/time_util.h"
30#include "rtc_base/arraysize.h"
31#include "rtc_base/checks.h"
32#include "rtc_base/logging.h"
Karl Wiberge40468b2017-11-22 10:42:26 +010033#include "rtc_base/numerics/safe_minmax.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020034#include "rtc_base/rate_limiter.h"
Steve Anton10542f22019-01-11 09:11:00 -080035#include "rtc_base/time_utils.h"
niklase@google.com470e71d2011-07-07 08:21:25 +000036
37namespace webrtc {
niklase@google.com470e71d2011-07-07 08:21:25 +000038
hclam@chromium.org806dc3b2013-04-09 19:54:10 +000039namespace {
Danil Chapovalov31e4e802016-08-03 18:27:40 +020040// Max in the RFC 3550 is 255 bytes, we limit it to be modulus 32 for SRTP.
41constexpr size_t kMaxPaddingLength = 224;
stefan53b6cc32017-02-03 08:13:57 -080042constexpr size_t kMinAudioPaddingLength = 50;
Danil Chapovalov31e4e802016-08-03 18:27:40 +020043constexpr int kSendSideDelayWindowMs = 1000;
44constexpr size_t kRtpHeaderLength = 12;
45constexpr uint16_t kMaxInitRtpSeqNumber = 32767; // 2^15 -1.
46constexpr uint32_t kTimestampTicksPerMs = 90;
47constexpr int kBitrateStatisticsWindowMs = 1000;
guoweis@webrtc.org45362892015-03-04 22:55:15 +000048
brandtr9dfff292016-11-14 05:14:50 -080049constexpr size_t kMinFlexfecPacketsToStoreForPacing = 50;
50
Erik Språng214f5432019-06-20 15:09:58 +020051// Min size needed to get payload padding from packet history.
52constexpr int kMinPayloadPaddingBytes = 50;
53
erikvarga27883732017-05-17 05:08:38 -070054template <typename Extension>
55constexpr RtpExtensionSize CreateExtensionSize() {
56 return {Extension::kId, Extension::kValueSizeBytes};
57}
58
Amit Hilbuch77938e62018-12-21 09:23:38 -080059template <typename Extension>
60constexpr RtpExtensionSize CreateMaxExtensionSize() {
61 return {Extension::kId, Extension::kMaxValueSizeBytes};
62}
63
erikvarga27883732017-05-17 05:08:38 -070064// Size info for header extensions that might be used in padding or FEC packets.
Ilya Nikolaevskiy1d037ae2018-03-15 15:46:17 +010065constexpr RtpExtensionSize kFecOrPaddingExtensionSizes[] = {
erikvarga27883732017-05-17 05:08:38 -070066 CreateExtensionSize<AbsoluteSendTime>(),
67 CreateExtensionSize<TransmissionOffset>(),
68 CreateExtensionSize<TransportSequenceNumber>(),
69 CreateExtensionSize<PlayoutDelayLimits>(),
Amit Hilbuch77938e62018-12-21 09:23:38 -080070 CreateMaxExtensionSize<RtpMid>(),
erikvarga27883732017-05-17 05:08:38 -070071};
72
Ilya Nikolaevskiy1d037ae2018-03-15 15:46:17 +010073// Size info for header extensions that might be used in video packets.
74constexpr RtpExtensionSize kVideoExtensionSizes[] = {
75 CreateExtensionSize<AbsoluteSendTime>(),
Chen Xingcd8a6e22019-07-01 10:56:51 +020076 CreateExtensionSize<AbsoluteCaptureTimeExtension>(),
Ilya Nikolaevskiy1d037ae2018-03-15 15:46:17 +010077 CreateExtensionSize<TransmissionOffset>(),
78 CreateExtensionSize<TransportSequenceNumber>(),
79 CreateExtensionSize<PlayoutDelayLimits>(),
80 CreateExtensionSize<VideoOrientation>(),
81 CreateExtensionSize<VideoContentTypeExtension>(),
82 CreateExtensionSize<VideoTimingExtension>(),
Amit Hilbuch77938e62018-12-21 09:23:38 -080083 CreateMaxExtensionSize<RtpStreamId>(),
84 CreateMaxExtensionSize<RepairedRtpStreamId>(),
85 CreateMaxExtensionSize<RtpMid>(),
Elad Alonccb9b752019-02-19 13:01:31 +010086 {RtpGenericFrameDescriptorExtension00::kId,
87 RtpGenericFrameDescriptorExtension00::kMaxSizeBytes},
88 {RtpGenericFrameDescriptorExtension01::kId,
89 RtpGenericFrameDescriptorExtension01::kMaxSizeBytes},
Ilya Nikolaevskiy1d037ae2018-03-15 15:46:17 +010090};
91
Erik Språng13eb7642019-06-24 10:58:48 +020092// TODO(bugs.webrtc.org/10633): Remove when downstream code stops using
93// priority. At the time of writing, the priority can be directly mapped to a
94// packet type. This is only for a transition period.
95RtpPacketToSend::Type PacketPriorityToType(RtpPacketSender::Priority priority) {
96 switch (priority) {
97 case RtpPacketSender::Priority::kLowPriority:
98 return RtpPacketToSend::Type::kVideo;
99 case RtpPacketSender::Priority::kNormalPriority:
100 return RtpPacketToSend::Type::kRetransmission;
101 case RtpPacketSender::Priority::kHighPriority:
102 return RtpPacketToSend::Type::kAudio;
103 default:
104 RTC_NOTREACHED() << "Unexpected priority: " << priority;
105 return RtpPacketToSend::Type::kVideo;
106 }
107}
108
109// TODO(bugs.webrtc.org/10633): Remove when packets are always owned by pacer.
110RtpPacketSender::Priority PacketTypeToPriority(RtpPacketToSend::Type type) {
111 switch (type) {
112 case RtpPacketToSend::Type::kAudio:
113 return RtpPacketSender::Priority::kHighPriority;
114 case RtpPacketToSend::Type::kVideo:
115 return RtpPacketSender::Priority::kLowPriority;
116 case RtpPacketToSend::Type::kRetransmission:
117 return RtpPacketSender::Priority::kNormalPriority;
118 case RtpPacketToSend::Type::kForwardErrorCorrection:
119 return RtpPacketSender::Priority::kLowPriority;
120 break;
121 case RtpPacketToSend::Type::kPadding:
122 RTC_NOTREACHED() << "Unexpected type for legacy path: kPadding";
123 break;
124 }
125 return RtpPacketSender::Priority::kLowPriority;
126}
127
Erik Språng4580ca22019-07-04 10:38:43 +0200128bool IsEnabled(absl::string_view name,
129 const WebRtcKeyValueConfig* field_trials) {
130 FieldTrialBasedConfig default_trials;
131 auto& trials = field_trials ? *field_trials : default_trials;
132 return trials.Lookup(name).find("Enabled") == 0;
133}
134
135bool IsDisabled(absl::string_view name,
136 const WebRtcKeyValueConfig* field_trials) {
137 FieldTrialBasedConfig default_trials;
138 auto& trials = field_trials ? *field_trials : default_trials;
139 return trials.Lookup(name).find("Disabled") == 0;
140}
141
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000142bool HasBweExtension(const RtpHeaderExtensionMap& extensions_map) {
143 return extensions_map.IsRegistered(kRtpExtensionTransportSequenceNumber) ||
144 extensions_map.IsRegistered(kRtpExtensionTransportSequenceNumber02) ||
145 extensions_map.IsRegistered(kRtpExtensionAbsoluteSendTime) ||
146 extensions_map.IsRegistered(kRtpExtensionTransmissionTimeOffset);
147}
148
hclam@chromium.org806dc3b2013-04-09 19:54:10 +0000149} // namespace
150
Erik Språng4580ca22019-07-04 10:38:43 +0200151RTPSender::RTPSender(const RtpRtcp::Configuration& config)
152 : clock_(config.clock),
153 random_(clock_->TimeInMicroseconds()),
154 audio_configured_(config.audio),
155 flexfec_ssrc_(config.flexfec_sender
156 ? absl::make_optional(config.flexfec_sender->ssrc())
157 : absl::nullopt),
158 paced_sender_(config.paced_sender),
159 transport_sequence_number_allocator_(
160 config.transport_sequence_number_allocator),
161 transport_feedback_observer_(config.transport_feedback_callback),
162 transport_(config.outgoing_transport),
163 sending_media_(true), // Default to sending media.
164 force_part_of_allocation_(false),
165 max_packet_size_(IP_PACKET_SIZE - 28), // Default is IP-v4/UDP.
166 last_payload_type_(-1),
167 rtp_header_extension_map_(config.extmap_allow_mixed),
168 packet_history_(clock_),
169 flexfec_packet_history_(clock_),
170 // Statistics
171 send_delays_(),
172 max_delay_it_(send_delays_.end()),
173 sum_delays_ms_(0),
174 total_packet_send_delay_ms_(0),
175 rtp_stats_callback_(nullptr),
176 total_bitrate_sent_(kBitrateStatisticsWindowMs,
177 RateStatistics::kBpsScale),
178 nack_bitrate_sent_(kBitrateStatisticsWindowMs, RateStatistics::kBpsScale),
179 send_side_delay_observer_(config.send_side_delay_observer),
180 event_log_(config.event_log),
181 send_packet_observer_(config.send_packet_observer),
182 bitrate_callback_(config.send_bitrate_observer),
183 // RTP variables
184 sequence_number_forced_(false),
185 ssrc_(config.media_send_ssrc),
186 last_rtp_timestamp_(0),
187 capture_time_ms_(0),
188 last_timestamp_time_ms_(0),
189 media_has_been_sent_(false),
190 last_packet_marker_bit_(false),
191 csrcs_(),
192 rtx_(kRtxOff),
193 ssrc_rtx_(config.rtx_send_ssrc),
194 rtp_overhead_bytes_per_packet_(0),
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000195 supports_bwe_extension_(false),
Erik Språng4580ca22019-07-04 10:38:43 +0200196 retransmission_rate_limiter_(config.retransmission_rate_limiter),
197 overhead_observer_(config.overhead_observer),
198 populate_network2_timestamp_(config.populate_network2_timestamp),
199 send_side_bwe_with_overhead_(
200 IsEnabled("WebRTC-SendSideBwe-WithOverhead", config.field_trials)),
201 legacy_packet_history_storage_mode_(
202 IsEnabled("WebRTC-UseRtpPacketHistoryLegacyStorageMode",
203 config.field_trials)),
Erik Språngf6468d22019-07-05 16:53:43 +0200204 pacer_legacy_packet_referencing_(
205 !IsDisabled("WebRTC-Pacer-LegacyPacketReferencing",
Erik Språng4580ca22019-07-04 10:38:43 +0200206 config.field_trials)) {
207 // This random initialization is not intended to be cryptographic strong.
208 timestamp_offset_ = random_.Rand<uint32_t>();
209 // Random start, 16 bits. Can't be 0.
210 sequence_number_rtx_ = random_.Rand(1, kMaxInitRtpSeqNumber);
211 sequence_number_ = random_.Rand(1, kMaxInitRtpSeqNumber);
212
213 // Store FlexFEC packets in the packet history data structure, so they can
214 // be found when paced.
215 if (flexfec_ssrc_) {
216 RtpPacketHistory::StorageMode storage_mode =
217 legacy_packet_history_storage_mode_
218 ? RtpPacketHistory::StorageMode::kStore
219 : RtpPacketHistory::StorageMode::kStoreAndCull;
220
221 flexfec_packet_history_.SetStorePacketsStatus(
222 storage_mode, kMinFlexfecPacketsToStoreForPacing);
223 }
224}
225
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000226RTPSender::RTPSender(
227 bool audio,
228 Clock* clock,
229 Transport* transport,
230 RtpPacketPacer* paced_sender,
231 absl::optional<uint32_t> flexfec_ssrc,
232 TransportSequenceNumberAllocator* sequence_number_allocator,
233 TransportFeedbackObserver* transport_feedback_observer,
234 BitrateStatisticsObserver* bitrate_callback,
235 SendSideDelayObserver* send_side_delay_observer,
236 RtcEventLog* event_log,
237 SendPacketObserver* send_packet_observer,
238 RateLimiter* retransmission_rate_limiter,
239 OverheadObserver* overhead_observer,
240 bool populate_network2_timestamp,
241 FrameEncryptorInterface* frame_encryptor,
242 bool require_frame_encryption,
243 bool extmap_allow_mixed,
244 const WebRtcKeyValueConfig& field_trials)
245 : clock_(clock),
danilchap47a740b2015-12-15 00:30:07 -0800246 random_(clock_->TimeInMicroseconds()),
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000247 audio_configured_(audio),
248 flexfec_ssrc_(flexfec_ssrc),
249 paced_sender_(paced_sender),
250 transport_sequence_number_allocator_(sequence_number_allocator),
251 transport_feedback_observer_(transport_feedback_observer),
252 transport_(transport),
Sebastian Jansson1bca65b2018-10-10 09:58:08 +0200253 sending_media_(true), // Default to sending media.
254 force_part_of_allocation_(false),
nisse284542b2017-01-10 08:58:32 -0800255 max_packet_size_(IP_PACKET_SIZE - 28), // Default is IP-v4/UDP.
Danil Chapovalovb3179c72018-03-22 10:13:07 +0100256 last_payload_type_(-1),
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000257 rtp_header_extension_map_(extmap_allow_mixed),
258 packet_history_(clock),
259 flexfec_packet_history_(clock),
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +0000260 // Statistics
Johannes Kron4a8a5e72018-09-26 09:57:48 +0200261 send_delays_(),
262 max_delay_it_(send_delays_.end()),
263 sum_delays_ms_(0),
Henrik Boström9fe18342019-05-16 18:38:20 +0200264 total_packet_send_delay_ms_(0),
sprangcd349d92016-07-13 09:11:28 -0700265 rtp_stats_callback_(nullptr),
266 total_bitrate_sent_(kBitrateStatisticsWindowMs,
267 RateStatistics::kBpsScale),
268 nack_bitrate_sent_(kBitrateStatisticsWindowMs, RateStatistics::kBpsScale),
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000269 send_side_delay_observer_(send_side_delay_observer),
270 event_log_(event_log),
271 send_packet_observer_(send_packet_observer),
272 bitrate_callback_(bitrate_callback),
sprang@webrtc.orgebad7652013-12-05 14:29:02 +0000273 // RTP variables
sprang@webrtc.org6811b6e2013-12-13 09:46:59 +0000274 sequence_number_forced_(false),
danilchape5b41412016-08-22 03:39:23 -0700275 last_rtp_timestamp_(0),
sprang@webrtc.org6811b6e2013-12-13 09:46:59 +0000276 capture_time_ms_(0),
277 last_timestamp_time_ms_(0),
stefan@webrtc.org8b94e3d2014-07-17 16:10:14 +0000278 media_has_been_sent_(false),
sprang@webrtc.org6811b6e2013-12-13 09:46:59 +0000279 last_packet_marker_bit_(false),
sprang@webrtc.org6811b6e2013-12-13 09:46:59 +0000280 csrcs_(),
sprang@webrtc.org6811b6e2013-12-13 09:46:59 +0000281 rtx_(kRtxOff),
michaelt4da30442016-11-17 01:38:43 -0800282 rtp_overhead_bytes_per_packet_(0),
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000283 supports_bwe_extension_(false),
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000284 retransmission_rate_limiter_(retransmission_rate_limiter),
285 overhead_observer_(overhead_observer),
286 populate_network2_timestamp_(populate_network2_timestamp),
elad.alonc3dfff32017-01-26 02:46:55 -0800287 send_side_bwe_with_overhead_(
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000288 field_trials.Lookup("WebRTC-SendSideBwe-WithOverhead")
289 .find("Enabled") == 0),
Erik Språngd2a63442019-05-03 10:58:50 -0400290 legacy_packet_history_storage_mode_(
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000291 field_trials.Lookup("WebRTC-UseRtpPacketHistoryLegacyStorageMode")
292 .find("Enabled") == 0),
Erik Språngf6468d22019-07-05 16:53:43 +0200293 pacer_legacy_packet_referencing_(
294 field_trials.Lookup("WebRTC-Pacer-LegacyPacketReferencing")
Amit Hilbuch02d7d352019-07-02 21:04:57 +0000295 .find("Disabled") != 0) {
danilchap71fead22016-08-18 02:01:49 -0700296 // This random initialization is not intended to be cryptographic strong.
297 timestamp_offset_ = random_.Rand<uint32_t>();
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +0000298 // Random start, 16 bits. Can't be 0.
danilchap47a740b2015-12-15 00:30:07 -0800299 sequence_number_rtx_ = random_.Rand(1, kMaxInitRtpSeqNumber);
300 sequence_number_ = random_.Rand(1, kMaxInitRtpSeqNumber);
brandtr9dfff292016-11-14 05:14:50 -0800301
302 // Store FlexFEC packets in the packet history data structure, so they can
303 // be found when paced.
Niels Möller59ab1cf2019-02-06 22:48:11 +0100304 if (flexfec_ssrc_) {
Erik Språngd2a63442019-05-03 10:58:50 -0400305 RtpPacketHistory::StorageMode storage_mode =
306 legacy_packet_history_storage_mode_
307 ? RtpPacketHistory::StorageMode::kStore
308 : RtpPacketHistory::StorageMode::kStoreAndCull;
309
brandtr9dfff292016-11-14 05:14:50 -0800310 flexfec_packet_history_.SetStorePacketsStatus(
Erik Språngd2a63442019-05-03 10:58:50 -0400311 storage_mode, kMinFlexfecPacketsToStoreForPacing);
brandtr9dfff292016-11-14 05:14:50 -0800312 }
niklase@google.com470e71d2011-07-07 08:21:25 +0000313}
314
pwestin@webrtc.org00741872012-01-19 15:56:10 +0000315RTPSender::~RTPSender() {
tommiae695e92016-02-02 08:31:45 -0800316 // TODO(tommi): Use a thread checker to ensure the object is created and
317 // deleted on the same thread. At the moment this isn't possible due to
318 // voe::ChannelOwner in voice engine. To reproduce, run:
319 // voe_auto_test --automated --gtest_filter=*MixManyChannelsForStressOpus
320
321 // TODO(tommi,holmer): We don't grab locks in the dtor before accessing member
322 // variables but we grab them in all other methods. (what's the design?)
323 // Start documenting what thread we're on in what method so that it's easier
324 // to understand performance attributes and possibly remove locks.
niklase@google.com470e71d2011-07-07 08:21:25 +0000325}
niklase@google.com470e71d2011-07-07 08:21:25 +0000326
erikvarga27883732017-05-17 05:08:38 -0700327rtc::ArrayView<const RtpExtensionSize> RTPSender::FecExtensionSizes() {
Ilya Nikolaevskiy1d037ae2018-03-15 15:46:17 +0100328 return rtc::MakeArrayView(kFecOrPaddingExtensionSizes,
329 arraysize(kFecOrPaddingExtensionSizes));
330}
331
332rtc::ArrayView<const RtpExtensionSize> RTPSender::VideoExtensionSizes() {
333 return rtc::MakeArrayView(kVideoExtensionSizes,
334 arraysize(kVideoExtensionSizes));
erikvarga27883732017-05-17 05:08:38 -0700335}
336
pbos@webrtc.org2f446732013-04-08 11:08:41 +0000337uint16_t RTPSender::ActualSendBitrateKbit() const {
sprangcd349d92016-07-13 09:11:28 -0700338 rtc::CritScope cs(&statistics_crit_);
339 return static_cast<uint16_t>(
340 total_bitrate_sent_.Rate(clock_->TimeInMilliseconds()).value_or(0) /
341 1000);
niklase@google.com470e71d2011-07-07 08:21:25 +0000342}
343
pbos@webrtc.org2f446732013-04-08 11:08:41 +0000344uint32_t RTPSender::NackOverheadRate() const {
sprangcd349d92016-07-13 09:11:28 -0700345 rtc::CritScope cs(&statistics_crit_);
346 return nack_bitrate_sent_.Rate(clock_->TimeInMilliseconds()).value_or(0);
stefan@webrtc.orgd0bdab02011-10-14 14:24:54 +0000347}
348
Johannes Kron9190b822018-10-29 11:22:05 +0100349void RTPSender::SetExtmapAllowMixed(bool extmap_allow_mixed) {
350 rtc::CritScope lock(&send_critsect_);
351 rtp_header_extension_map_.SetExtmapAllowMixed(extmap_allow_mixed);
352}
353
pbos@webrtc.orgd16e8392014-12-19 13:49:55 +0000354int32_t RTPSender::RegisterRtpHeaderExtension(RTPExtensionType type,
355 uint8_t id) {
tommiae695e92016-02-02 08:31:45 -0800356 rtc::CritScope lock(&send_critsect_);
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000357 bool registered = rtp_header_extension_map_.RegisterByType(id, type);
358 supports_bwe_extension_ = HasBweExtension(rtp_header_extension_map_);
359 return registered ? 0 : -1;
asapersson@webrtc.org5249cc82011-12-16 14:31:37 +0000360}
361
Danil Chapovalov585d1aa2018-09-14 18:29:32 +0200362bool RTPSender::RegisterRtpHeaderExtension(const std::string& uri, int id) {
363 rtc::CritScope lock(&send_critsect_);
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000364 bool registered = rtp_header_extension_map_.RegisterByUri(id, uri);
365 supports_bwe_extension_ = HasBweExtension(rtp_header_extension_map_);
366 return registered;
Danil Chapovalov585d1aa2018-09-14 18:29:32 +0200367}
368
stefan53b6cc32017-02-03 08:13:57 -0800369bool RTPSender::IsRtpHeaderExtensionRegistered(RTPExtensionType type) const {
tommiae695e92016-02-02 08:31:45 -0800370 rtc::CritScope lock(&send_critsect_);
guoweis@webrtc.org45362892015-03-04 22:55:15 +0000371 return rtp_header_extension_map_.IsRegistered(type);
372}
373
pbos@webrtc.orgd16e8392014-12-19 13:49:55 +0000374int32_t RTPSender::DeregisterRtpHeaderExtension(RTPExtensionType type) {
tommiae695e92016-02-02 08:31:45 -0800375 rtc::CritScope lock(&send_critsect_);
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000376 int32_t deregistered = rtp_header_extension_map_.Deregister(type);
377 supports_bwe_extension_ = HasBweExtension(rtp_header_extension_map_);
378 return deregistered;
asapersson@webrtc.org5249cc82011-12-16 14:31:37 +0000379}
380
nisse284542b2017-01-10 08:58:32 -0800381void RTPSender::SetMaxRtpPacketSize(size_t max_packet_size) {
kwibergee89e782017-08-09 17:22:01 -0700382 RTC_DCHECK_GE(max_packet_size, 100);
383 RTC_DCHECK_LE(max_packet_size, IP_PACKET_SIZE);
tommiae695e92016-02-02 08:31:45 -0800384 rtc::CritScope lock(&send_critsect_);
nisse284542b2017-01-10 08:58:32 -0800385 max_packet_size_ = max_packet_size;
niklase@google.com470e71d2011-07-07 08:21:25 +0000386}
387
nisse284542b2017-01-10 08:58:32 -0800388size_t RTPSender::MaxRtpPacketSize() const {
389 return max_packet_size_;
niklase@google.com470e71d2011-07-07 08:21:25 +0000390}
391
pbos@webrtc.org0b0c2412015-01-13 14:15:15 +0000392void RTPSender::SetRtxStatus(int mode) {
tommiae695e92016-02-02 08:31:45 -0800393 rtc::CritScope lock(&send_critsect_);
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +0000394 rtx_ = mode;
stefan@webrtc.orgef927552014-06-05 08:25:29 +0000395}
396
pbos@webrtc.org0b0c2412015-01-13 14:15:15 +0000397int RTPSender::RtxStatus() const {
tommiae695e92016-02-02 08:31:45 -0800398 rtc::CritScope lock(&send_critsect_);
pbos@webrtc.org0b0c2412015-01-13 14:15:15 +0000399 return rtx_;
400}
401
stefan@webrtc.orgef927552014-06-05 08:25:29 +0000402void RTPSender::SetRtxSsrc(uint32_t ssrc) {
tommiae695e92016-02-02 08:31:45 -0800403 rtc::CritScope lock(&send_critsect_);
nisse7d59f6b2017-02-21 03:40:24 -0800404 ssrc_rtx_.emplace(ssrc);
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000405}
406
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +0000407uint32_t RTPSender::RtxSsrc() const {
tommiae695e92016-02-02 08:31:45 -0800408 rtc::CritScope lock(&send_critsect_);
nisse7d59f6b2017-02-21 03:40:24 -0800409 RTC_DCHECK(ssrc_rtx_);
410 return *ssrc_rtx_;
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +0000411}
412
Shao Changbine62202f2015-04-21 20:24:50 +0800413void RTPSender::SetRtxPayloadType(int payload_type,
414 int associated_payload_type) {
tommiae695e92016-02-02 08:31:45 -0800415 rtc::CritScope lock(&send_critsect_);
henrikg91d6ede2015-09-17 00:24:34 -0700416 RTC_DCHECK_LE(payload_type, 127);
417 RTC_DCHECK_LE(associated_payload_type, 127);
Shao Changbine62202f2015-04-21 20:24:50 +0800418 if (payload_type < 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100419 RTC_LOG(LS_ERROR) << "Invalid RTX payload type: " << payload_type << ".";
Shao Changbine62202f2015-04-21 20:24:50 +0800420 return;
421 }
422
423 rtx_payload_type_map_[associated_payload_type] = payload_type;
Åsa Persson6ae25722015-04-13 17:48:08 +0200424}
425
philipela1ed0b32016-06-01 06:31:17 -0700426size_t RTPSender::TrySendRedundantPayloads(size_t bytes_to_send,
philipel8aadd502017-02-23 02:56:13 -0800427 const PacedPacketInfo& pacing_info) {
andresp@webrtc.org817a0342014-08-14 08:24:47 +0000428 {
tommiae695e92016-02-02 08:31:45 -0800429 rtc::CritScope lock(&send_critsect_);
Peter Boströmfc968a22016-02-19 16:14:37 +0100430 if (!sending_media_)
431 return 0;
andresp@webrtc.org817a0342014-08-14 08:24:47 +0000432 if ((rtx_ & kRtxRedundantPayloads) == 0)
433 return 0;
434 }
435
pkasting@chromium.org4591fbd2014-11-20 22:28:14 +0000436 int bytes_left = static_cast<int>(bytes_to_send);
Erik Språng214f5432019-06-20 15:09:58 +0200437 while (bytes_left >= kMinPayloadPaddingBytes) {
Erik Språng21f2fc92019-07-16 21:09:14 +0200438 std::unique_ptr<RtpPacketToSend> packet =
439 packet_history_.GetPayloadPaddingPacket();
Erik Språng4ffed7c2019-05-28 11:18:04 +0200440
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200441 if (!packet)
stefan@webrtc.org7e9315b2013-12-04 10:24:26 +0000442 break;
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200443 size_t payload_size = packet->payload_size();
philipel8aadd502017-02-23 02:56:13 -0800444 if (!PrepareAndSendPacket(std::move(packet), true, false, pacing_info))
pkasting@chromium.org4591fbd2014-11-20 22:28:14 +0000445 break;
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200446 bytes_left -= payload_size;
stefan@webrtc.org7e9315b2013-12-04 10:24:26 +0000447 }
448 return bytes_to_send - bytes_left;
449}
450
philipel8aadd502017-02-23 02:56:13 -0800451size_t RTPSender::SendPadData(size_t bytes,
452 const PacedPacketInfo& pacing_info) {
stefan53b6cc32017-02-03 08:13:57 -0800453 size_t padding_bytes_in_packet;
erikvarga76a55932017-05-17 07:50:17 -0700454 size_t max_payload_size = max_packet_size_ - RtpHeaderLength();
erikvarga27883732017-05-17 05:08:38 -0700455
stefan53b6cc32017-02-03 08:13:57 -0800456 if (audio_configured_) {
457 // Allow smaller padding packets for audio.
Erik Språng478cb462019-06-26 15:49:27 +0200458 padding_bytes_in_packet =
459 rtc::SafeClamp(bytes, kMinAudioPaddingLength,
460 rtc::SafeMin(max_payload_size, kMaxPaddingLength));
stefan53b6cc32017-02-03 08:13:57 -0800461 } else {
462 // Always send full padding packets. This is accounted for by the
463 // RtpPacketSender, which will make sure we don't send too much padding even
464 // if a single packet is larger than requested.
465 // We do this to avoid frequently sending small packets on higher bitrates.
Erik Språng478cb462019-06-26 15:49:27 +0200466 padding_bytes_in_packet = rtc::SafeMin(max_payload_size, kMaxPaddingLength);
stefan53b6cc32017-02-03 08:13:57 -0800467 }
pkasting@chromium.org4591fbd2014-11-20 22:28:14 +0000468 size_t bytes_sent = 0;
danilchap90069872016-12-14 06:16:33 -0800469 while (bytes_sent < bytes) {
470 int64_t now_ms = clock_->TimeInMilliseconds();
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000471 uint32_t ssrc;
danilchap90069872016-12-14 06:16:33 -0800472 uint32_t timestamp;
473 int64_t capture_time_ms;
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000474 uint16_t sequence_number;
andresp@webrtc.org817a0342014-08-14 08:24:47 +0000475 int payload_type;
pbos@webrtc.org63c60ed2014-07-16 09:37:29 +0000476 bool over_rtx;
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000477 {
tommiae695e92016-02-02 08:31:45 -0800478 rtc::CritScope lock(&send_critsect_);
Peter Boströmfc968a22016-02-19 16:14:37 +0100479 if (!sending_media_)
danilchap90069872016-12-14 06:16:33 -0800480 break;
481 timestamp = last_rtp_timestamp_;
482 capture_time_ms = capture_time_ms_;
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000483 if (rtx_ == kRtxOff) {
Danil Chapovalovb3179c72018-03-22 10:13:07 +0100484 if (last_payload_type_ == -1)
stefane35f89a2017-02-01 09:06:25 -0800485 break;
stefan53b6cc32017-02-03 08:13:57 -0800486 // Without RTX we can't send padding in the middle of frames.
487 // For audio marker bits doesn't mark the end of a frame and frames
488 // are usually a single packet, so for now we don't apply this rule
489 // for audio.
490 if (!audio_configured_ && !last_packet_marker_bit_) {
491 break;
492 }
nisse7d59f6b2017-02-21 03:40:24 -0800493 if (!ssrc_) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100494 RTC_LOG(LS_ERROR) << "SSRC unset.";
nisse7d59f6b2017-02-21 03:40:24 -0800495 return 0;
496 }
497
498 RTC_DCHECK(ssrc_);
499 ssrc = *ssrc_;
500
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000501 sequence_number = sequence_number_;
502 ++sequence_number_;
Danil Chapovalovb3179c72018-03-22 10:13:07 +0100503 payload_type = last_payload_type_;
pbos@webrtc.org63c60ed2014-07-16 09:37:29 +0000504 over_rtx = false;
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000505 } else {
Stefan Holmerf5dca482016-01-27 12:58:51 +0100506 // Without abs-send-time or transport sequence number a media packet
507 // must be sent before padding so that the timestamps used for
508 // estimation are correct.
509 if (!media_has_been_sent_ &&
danilchap90069872016-12-14 06:16:33 -0800510 !(rtp_header_extension_map_.IsRegistered(AbsoluteSendTime::kId) ||
511 (rtp_header_extension_map_.IsRegistered(
512 TransportSequenceNumber::kId) &&
513 transport_sequence_number_allocator_))) {
514 break;
Stefan Holmerf5dca482016-01-27 12:58:51 +0100515 }
Stefan Holmer586b19b2015-09-18 11:14:31 +0200516 // Only change change the timestamp of padding packets sent over RTX.
517 // Padding only packets over RTP has to be sent as part of a media
518 // frame (and therefore the same timestamp).
519 if (last_timestamp_time_ms_ > 0) {
520 timestamp +=
danilchap90069872016-12-14 06:16:33 -0800521 (now_ms - last_timestamp_time_ms_) * kTimestampTicksPerMs;
522 capture_time_ms += (now_ms - last_timestamp_time_ms_);
Stefan Holmer586b19b2015-09-18 11:14:31 +0200523 }
nisse7d59f6b2017-02-21 03:40:24 -0800524 if (!ssrc_rtx_) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100525 RTC_LOG(LS_ERROR) << "RTX SSRC unset.";
nisse7d59f6b2017-02-21 03:40:24 -0800526 return 0;
527 }
528 RTC_DCHECK(ssrc_rtx_);
529 ssrc = *ssrc_rtx_;
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000530 sequence_number = sequence_number_rtx_;
531 ++sequence_number_rtx_;
Stefan Holmer10880012016-02-03 13:29:59 +0100532 payload_type = rtx_payload_type_map_.begin()->second;
pbos@webrtc.org63c60ed2014-07-16 09:37:29 +0000533 over_rtx = true;
stefan@webrtc.org8ccb9f92013-06-19 14:13:42 +0000534 }
535 }
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +0000536
danilchap90069872016-12-14 06:16:33 -0800537 RtpPacketToSend padding_packet(&rtp_header_extension_map_);
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200538 padding_packet.SetPayloadType(payload_type);
539 padding_packet.SetMarker(false);
540 padding_packet.SetSequenceNumber(sequence_number);
541 padding_packet.SetTimestamp(timestamp);
542 padding_packet.SetSsrc(ssrc);
543
pbos@webrtc.org72491b92014-07-10 16:24:54 +0000544 if (capture_time_ms > 0) {
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200545 padding_packet.SetExtension<TransmissionOffset>(
danilchap90069872016-12-14 06:16:33 -0800546 (now_ms - capture_time_ms) * kTimestampTicksPerMs);
pwestin@webrtc.org12d97f62012-01-05 10:54:44 +0000547 }
Danil Chapovalovf3ba6482017-06-12 15:43:55 +0200548 padding_packet.SetExtension<AbsoluteSendTime>(
549 AbsoluteSendTime::MsTo24Bits(now_ms));
stefan1d8a5062015-10-02 03:39:33 -0700550 PacketOptions options;
Petter Strandmark26bc6692018-05-29 08:43:35 +0200551 // Padding packets are never retransmissions.
552 options.is_retransmit = false;
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +0200553 bool has_transport_seq_num;
554 {
555 rtc::CritScope lock(&send_critsect_);
556 has_transport_seq_num =
557 UpdateTransportSequenceNumber(&padding_packet, &options.packet_id);
Sebastian Jansson1bca65b2018-10-10 09:58:08 +0200558 options.included_in_allocation =
559 has_transport_seq_num || force_part_of_allocation_;
560 options.included_in_feedback = has_transport_seq_num;
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +0200561 }
Danil Chapovalovf7fcaf02018-10-10 14:56:01 +0200562 padding_packet.SetPadding(padding_bytes_in_packet);
michaelt4da30442016-11-17 01:38:43 -0800563 if (has_transport_seq_num) {
564 AddPacketToTransportFeedback(options.packet_id, padding_packet,
philipel8aadd502017-02-23 02:56:13 -0800565 pacing_info);
michaelt4da30442016-11-17 01:38:43 -0800566 }
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200567
philipel32d00102017-02-27 02:18:46 -0800568 if (!SendPacketToNetwork(padding_packet, options, pacing_info))
stefanf116bd02015-10-27 08:29:42 -0700569 break;
570
stefan@webrtc.org508a84b2013-06-17 12:53:37 +0000571 bytes_sent += padding_bytes_in_packet;
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200572 UpdateRtpStats(padding_packet, over_rtx, false);
pwestin@webrtc.org12d97f62012-01-05 10:54:44 +0000573 }
pbos@webrtc.org72491b92014-07-10 16:24:54 +0000574
stefan@webrtc.org508a84b2013-06-17 12:53:37 +0000575 return bytes_sent;
pwestin@webrtc.org12d97f62012-01-05 10:54:44 +0000576}
577
pbos@webrtc.orgd16e8392014-12-19 13:49:55 +0000578void RTPSender::SetStorePacketsStatus(bool enable, uint16_t number_to_store) {
Erik Språngd2a63442019-05-03 10:58:50 -0400579 RtpPacketHistory::StorageMode mode;
580 if (enable) {
581 mode = legacy_packet_history_storage_mode_
582 ? RtpPacketHistory::StorageMode::kStore
583 : RtpPacketHistory::StorageMode::kStoreAndCull;
584 } else {
585 mode = RtpPacketHistory::StorageMode::kDisabled;
586 }
Erik Språnga12b1d62018-03-14 12:39:24 +0100587 packet_history_.SetStorePacketsStatus(mode, number_to_store);
niklase@google.com470e71d2011-07-07 08:21:25 +0000588}
589
pwestin@webrtc.orgb0061f92013-04-27 00:41:08 +0000590bool RTPSender::StorePackets() const {
Erik Språnga12b1d62018-03-14 12:39:24 +0100591 return packet_history_.GetStorageMode() !=
592 RtpPacketHistory::StorageMode::kDisabled;
pwestin@webrtc.orgb0061f92013-04-27 00:41:08 +0000593}
niklase@google.com470e71d2011-07-07 08:21:25 +0000594
Erik Språnga12b1d62018-03-14 12:39:24 +0100595int32_t RTPSender::ReSendPacket(uint16_t packet_id) {
596 // Try to find packet in RTP packet history. Also verify RTT here, so that we
597 // don't retransmit too often.
Danil Chapovalovd264df52018-06-14 12:59:38 +0200598 absl::optional<RtpPacketHistory::PacketState> stored_packet =
Danil Chapovalov6c78ff42018-10-16 11:01:05 +0200599 packet_history_.GetPacketState(packet_id);
Erik Språng0f4f0552019-05-08 10:15:05 -0700600 if (!stored_packet || stored_packet->pending_transmission) {
601 // Packet not found or already queued for retransmission, ignore.
asapersson@webrtc.org83ed0a42012-04-23 12:43:05 +0000602 return 0;
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000603 }
Oleh Prypin5a980492018-03-09 12:27:24 +0000604
Per Kjellander252725d2019-02-20 13:14:34 +0100605 const int32_t packet_size = static_cast<int32_t>(stored_packet->packet_size);
Erik Språngf6468d22019-07-05 16:53:43 +0200606 const bool rtx = (RtxStatus() & kRtxRetransmitted) > 0;
Erik Språng7bb37b82018-03-09 09:52:59 +0100607
Oleh Prypin5a980492018-03-09 12:27:24 +0000608 if (paced_sender_) {
Erik Språngf6468d22019-07-05 16:53:43 +0200609 if (pacer_legacy_packet_referencing_) {
610 // Check if we're overusing retransmission bitrate.
611 // TODO(sprang): Add histograms for nack success or failure reasons.
612 if (retransmission_rate_limiter_ &&
613 !retransmission_rate_limiter_->TryUseRate(packet_size)) {
614 return -1;
615 }
616
617 // Mark packet as being in pacer queue again, to prevent duplicates.
618 if (!packet_history_.SetPendingTransmission(packet_id)) {
619 // Packet has already been removed from history, return early.
620 return 0;
621 }
622
623 paced_sender_->InsertPacket(
624 RtpPacketSender::kNormalPriority, stored_packet->ssrc,
625 stored_packet->rtp_sequence_number, stored_packet->capture_time_ms,
626 stored_packet->packet_size, true);
627 } else {
628 std::unique_ptr<RtpPacketToSend> packet =
629 packet_history_.GetPacketAndMarkAsPending(
630 packet_id, [&](const RtpPacketToSend& stored_packet) {
631 // Check if we're overusing retransmission bitrate.
632 // TODO(sprang): Add histograms for nack success or failure
633 // reasons.
634 std::unique_ptr<RtpPacketToSend> retransmit_packet;
635 if (retransmission_rate_limiter_ &&
636 !retransmission_rate_limiter_->TryUseRate(packet_size)) {
637 return retransmit_packet;
638 }
639 if (rtx) {
640 retransmit_packet = BuildRtxPacket(stored_packet);
641 } else {
642 retransmit_packet =
643 absl::make_unique<RtpPacketToSend>(stored_packet);
644 }
645 retransmit_packet->set_retransmitted_sequence_number(
646 stored_packet.SequenceNumber());
647 return retransmit_packet;
648 });
649 if (!packet) {
650 return -1;
651 }
652 packet->set_packet_type(RtpPacketToSend::Type::kRetransmission);
653 paced_sender_->EnqueuePacket(std::move(packet));
Erik Språng0f4f0552019-05-08 10:15:05 -0700654 }
655
Erik Språnga12b1d62018-03-14 12:39:24 +0100656 return packet_size;
Oleh Prypin5a980492018-03-09 12:27:24 +0000657 }
Erik Språnga12b1d62018-03-14 12:39:24 +0100658
Erik Språngf6468d22019-07-05 16:53:43 +0200659 // TODO(sprang): Replace this whole code-path with a pass-through pacer.
660 // Check if we're overusing retransmission bitrate.
661 // TODO(sprang): Add histograms for nack success or failure reasons.
662 if (retransmission_rate_limiter_ &&
663 !retransmission_rate_limiter_->TryUseRate(packet_size)) {
664 return -1;
665 }
666
Erik Språnga12b1d62018-03-14 12:39:24 +0100667 std::unique_ptr<RtpPacketToSend> packet =
Danil Chapovalov6c78ff42018-10-16 11:01:05 +0200668 packet_history_.GetPacketAndSetSendTime(packet_id);
Erik Språnga12b1d62018-03-14 12:39:24 +0100669 if (!packet) {
670 // Packet could theoretically time out between the first check and this one.
671 return 0;
672 }
673
philipel8aadd502017-02-23 02:56:13 -0800674 if (!PrepareAndSendPacket(std::move(packet), rtx, true, PacedPacketInfo()))
sprang867fb522015-08-03 04:38:41 -0700675 return -1;
Erik Språnga12b1d62018-03-14 12:39:24 +0100676
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200677 return packet_size;
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000678}
679
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200680bool RTPSender::SendPacketToNetwork(const RtpPacketToSend& packet,
philipel32d00102017-02-27 02:18:46 -0800681 const PacketOptions& options,
682 const PacedPacketInfo& pacing_info) {
pwestin@webrtc.orgb0061f92013-04-27 00:41:08 +0000683 int bytes_sent = -1;
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +0000684 if (transport_) {
michaelt4da30442016-11-17 01:38:43 -0800685 UpdateRtpOverhead(packet);
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200686 bytes_sent = transport_->SendRtp(packet.data(), packet.size(), options)
687 ? static_cast<int>(packet.size())
stefan1d8a5062015-10-02 03:39:33 -0700688 : -1;
terelius429c3452016-01-21 05:42:04 -0800689 if (event_log_ && bytes_sent > 0) {
Karl Wiberg918f50c2018-07-05 11:40:33 +0200690 event_log_->Log(absl::make_unique<RtcEventRtpPacketOutgoing>(
Elad Alon4a87e1c2017-10-03 16:11:34 +0200691 packet, pacing_info.probe_cluster_id));
terelius429c3452016-01-21 05:42:04 -0800692 }
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000693 }
andresp@webrtc.orgdc80bae2014-04-08 11:06:12 +0000694 // TODO(pwestin): Add a separate bitrate for sent bitrate after pacer.
asapersson@webrtc.org0b3c35a2012-01-16 11:06:31 +0000695 if (bytes_sent <= 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100696 RTC_LOG(LS_WARNING) << "Transport failed to send packet.";
pwestin@webrtc.orgb0061f92013-04-27 00:41:08 +0000697 return false;
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000698 }
pwestin@webrtc.orgb0061f92013-04-27 00:41:08 +0000699 return true;
niklase@google.com470e71d2011-07-07 08:21:25 +0000700}
701
Danil Chapovalov2800d742016-08-26 18:48:46 +0200702void RTPSender::OnReceivedNack(
703 const std::vector<uint16_t>& nack_sequence_numbers,
704 int64_t avg_rtt) {
Erik Språnga12b1d62018-03-14 12:39:24 +0100705 packet_history_.SetRtt(5 + avg_rtt);
sprangcd349d92016-07-13 09:11:28 -0700706 for (uint16_t seq_no : nack_sequence_numbers) {
Erik Språnga12b1d62018-03-14 12:39:24 +0100707 const int32_t bytes_sent = ReSendPacket(seq_no);
sprangcd349d92016-07-13 09:11:28 -0700708 if (bytes_sent < 0) {
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000709 // Failed to send one Sequence number. Give up the rest in this nack.
Mirko Bonadei675513b2017-11-09 11:09:25 +0100710 RTC_LOG(LS_WARNING) << "Failed resending RTP packet " << seq_no
711 << ", Discard rest of packets.";
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000712 break;
niklase@google.com470e71d2011-07-07 08:21:25 +0000713 }
pwestin@webrtc.org8281e7d2012-01-10 14:09:18 +0000714 }
niklase@google.com470e71d2011-07-07 08:21:25 +0000715}
716
pwestin@webrtc.orgb0061f92013-04-27 00:41:08 +0000717// Called from pacer when we can send the packet.
Erik Språngd2879622019-05-10 08:29:01 -0700718RtpPacketSendResult RTPSender::TimeToSendPacket(
719 uint32_t ssrc,
720 uint16_t sequence_number,
721 int64_t capture_time_ms,
722 bool retransmission,
723 const PacedPacketInfo& pacing_info) {
724 if (!SendingMedia()) {
725 return RtpPacketSendResult::kPacketNotFound;
726 }
brandtr9dfff292016-11-14 05:14:50 -0800727
728 std::unique_ptr<RtpPacketToSend> packet;
729 if (ssrc == SSRC()) {
Danil Chapovalov6c78ff42018-10-16 11:01:05 +0200730 packet = packet_history_.GetPacketAndSetSendTime(sequence_number);
brandtr9dfff292016-11-14 05:14:50 -0800731 } else if (ssrc == FlexfecSsrc()) {
Danil Chapovalov6c78ff42018-10-16 11:01:05 +0200732 packet = flexfec_packet_history_.GetPacketAndSetSendTime(sequence_number);
brandtr9dfff292016-11-14 05:14:50 -0800733 }
734
Stefan Holmera246cfb2016-08-23 17:51:42 +0200735 if (!packet) {
Erik Språngd2879622019-05-10 08:29:01 -0700736 // Packet cannot be found or was resent too recently.
737 return RtpPacketSendResult::kPacketNotFound;
Stefan Holmera246cfb2016-08-23 17:51:42 +0200738 }
asapersson35151f32016-05-02 23:44:01 -0700739
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200740 return PrepareAndSendPacket(
Erik Språngd2879622019-05-10 08:29:01 -0700741 std::move(packet),
742 retransmission && (RtxStatus() & kRtxRetransmitted) > 0,
743 retransmission, pacing_info)
744 ? RtpPacketSendResult::kSuccess
745 : RtpPacketSendResult::kTransportUnavailable;
stefan@webrtc.org7e9315b2013-12-04 10:24:26 +0000746}
asapersson@webrtc.org0b3c35a2012-01-16 11:06:31 +0000747
Erik Språng9c771c22019-06-17 16:31:53 +0200748// Called from pacer when we can send the packet.
749bool RTPSender::TrySendPacket(RtpPacketToSend* packet,
750 const PacedPacketInfo& pacing_info) {
751 RTC_DCHECK(packet);
752
753 const uint32_t packet_ssrc = packet->Ssrc();
754 const auto packet_type = packet->packet_type();
755 RTC_DCHECK(packet_type.has_value());
756
757 PacketOptions options;
758 bool is_media = false;
759 bool is_rtx = false;
760 {
761 rtc::CritScope lock(&send_critsect_);
762 if (!sending_media_) {
763 return false;
764 }
765
766 switch (*packet_type) {
767 case RtpPacketToSend::Type::kAudio:
768 case RtpPacketToSend::Type::kVideo:
769 if (packet_ssrc != ssrc_) {
770 return false;
771 }
772 is_media = true;
773 break;
774 case RtpPacketToSend::Type::kRetransmission:
775 case RtpPacketToSend::Type::kPadding:
776 // Both padding and retransmission must be on either the media or the
777 // RTX stream.
778 if (packet_ssrc == ssrc_rtx_) {
779 is_rtx = true;
780 } else if (packet_ssrc != ssrc_) {
781 return false;
782 }
783 break;
784 case RtpPacketToSend::Type::kForwardErrorCorrection:
785 // FlexFEC is on separate SSRC, ULPFEC uses media SSRC.
786 if (packet_ssrc != ssrc_ && packet_ssrc != flexfec_ssrc_) {
787 return false;
788 }
789 break;
790 }
791
792 options.included_in_allocation = force_part_of_allocation_;
793 }
794
795 // Bug webrtc:7859. While FEC is invoked from rtp_sender_video, and not after
796 // the pacer, these modifications of the header below are happening after the
797 // FEC protection packets are calculated. This will corrupt recovered packets
798 // at the same place. It's not an issue for extensions, which are present in
799 // all the packets (their content just may be incorrect on recovered packets).
800 // In case of VideoTimingExtension, since it's present not in every packet,
801 // data after rtp header may be corrupted if these packets are protected by
802 // the FEC.
803 int64_t now_ms = clock_->TimeInMilliseconds();
804 int64_t diff_ms = now_ms - packet->capture_time_ms();
Erik Språng0f6191d2019-07-15 20:33:40 +0200805 if (packet->IsExtensionReserved<TransmissionOffset>()) {
806 packet->SetExtension<TransmissionOffset>(kTimestampTicksPerMs * diff_ms);
807 }
808 if (packet->IsExtensionReserved<AbsoluteSendTime>()) {
809 packet->SetExtension<AbsoluteSendTime>(
810 AbsoluteSendTime::MsTo24Bits(now_ms));
811 }
Erik Språng9c771c22019-06-17 16:31:53 +0200812
813 if (packet->HasExtension<VideoTimingExtension>()) {
814 if (populate_network2_timestamp_) {
815 packet->set_network2_time_ms(now_ms);
816 } else {
817 packet->set_pacer_exit_time_ms(now_ms);
818 }
819 }
820
821 // Downstream code actually uses this flag to distinguish between media and
822 // everything else.
823 options.is_retransmit = !is_media;
824 if (auto packet_id = packet->GetExtension<TransportSequenceNumber>()) {
825 options.packet_id = *packet_id;
826 options.included_in_feedback = true;
827 options.included_in_allocation = true;
828 AddPacketToTransportFeedback(*packet_id, *packet, pacing_info);
829 }
830
831 options.application_data.assign(packet->application_data().begin(),
832 packet->application_data().end());
833
834 if (packet->packet_type() != RtpPacketToSend::Type::kPadding &&
835 packet->packet_type() != RtpPacketToSend::Type::kRetransmission) {
836 UpdateDelayStatistics(packet->capture_time_ms(), now_ms, packet_ssrc);
837 UpdateOnSendPacket(options.packet_id, packet->capture_time_ms(),
838 packet_ssrc);
839 }
840
841 const bool send_success = SendPacketToNetwork(*packet, options, pacing_info);
842
843 // Put packet in retransmission history or update pending status even if
844 // actual sending fails.
845 if (is_media && packet->allow_retransmission()) {
846 packet_history_.PutRtpPacket(absl::make_unique<RtpPacketToSend>(*packet),
847 StorageType::kAllowRetransmission, now_ms);
848 } else if (packet->retransmitted_sequence_number()) {
849 packet_history_.MarkPacketAsSent(*packet->retransmitted_sequence_number());
850 }
851
852 if (send_success) {
853 UpdateRtpStats(*packet, is_rtx,
854 packet_type == RtpPacketToSend::Type::kRetransmission);
855
856 rtc::CritScope lock(&send_critsect_);
857 media_has_been_sent_ = true;
858 }
859
860 // Return true even if transport failed (will be handled by retransmissions
861 // instead in that case), so that PacketRouter does not have to iterate over
862 // all other RTP modules and fail to send there too.
863 return true;
864}
865
Mirko Bonadei999a72a2019-07-12 17:33:46 +0000866bool RTPSender::SupportsPadding() const {
867 rtc::CritScope lock(&send_critsect_);
868 return sending_media_ && supports_bwe_extension_;
869}
870
871bool RTPSender::SupportsRtxPayloadPadding() const {
872 rtc::CritScope lock(&send_critsect_);
873 return sending_media_ && supports_bwe_extension_ &&
874 (rtx_ & kRtxRedundantPayloads);
875}
876
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200877bool RTPSender::PrepareAndSendPacket(std::unique_ptr<RtpPacketToSend> packet,
stefan@webrtc.org7c6ff2d2014-03-19 18:14:52 +0000878 bool send_over_rtx,
philipela1ed0b32016-06-01 06:31:17 -0700879 bool is_retransmit,
philipel8aadd502017-02-23 02:56:13 -0800880 const PacedPacketInfo& pacing_info) {
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200881 RTC_DCHECK(packet);
882 int64_t capture_time_ms = packet->capture_time_ms();
883 RtpPacketToSend* packet_to_send = packet.get();
stefan@webrtc.org7e9315b2013-12-04 10:24:26 +0000884
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200885 std::unique_ptr<RtpPacketToSend> packet_rtx;
stefan@webrtc.org7e9315b2013-12-04 10:24:26 +0000886 if (send_over_rtx) {
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200887 packet_rtx = BuildRtxPacket(*packet);
888 if (!packet_rtx)
danilchap32cd2c42016-08-01 06:58:34 -0700889 return false;
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200890 packet_to_send = packet_rtx.get();
stefan@webrtc.org9b82f5a2013-11-13 15:29:21 +0000891 }
892
ilnik10894992017-06-21 08:23:19 -0700893 // Bug webrtc:7859. While FEC is invoked from rtp_sender_video, and not after
894 // the pacer, these modifications of the header below are happening after the
895 // FEC protection packets are calculated. This will corrupt recovered packets
896 // at the same place. It's not an issue for extensions, which are present in
897 // all the packets (their content just may be incorrect on recovered packets).
898 // In case of VideoTimingExtension, since it's present not in every packet,
899 // data after rtp header may be corrupted if these packets are protected by
900 // the FEC.
solenberg@webrtc.org7ebbea12013-05-16 11:10:31 +0000901 int64_t now_ms = clock_->TimeInMilliseconds();
902 int64_t diff_ms = now_ms - capture_time_ms;
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200903 packet_to_send->SetExtension<TransmissionOffset>(kTimestampTicksPerMs *
904 diff_ms);
Danil Chapovalovf3ba6482017-06-12 15:43:55 +0200905 packet_to_send->SetExtension<AbsoluteSendTime>(
906 AbsoluteSendTime::MsTo24Bits(now_ms));
sprang867fb522015-08-03 04:38:41 -0700907
Erik Språng7b52f102018-02-07 14:37:37 +0100908 if (packet_to_send->HasExtension<VideoTimingExtension>()) {
909 if (populate_network2_timestamp_) {
910 packet_to_send->set_network2_time_ms(now_ms);
911 } else {
912 packet_to_send->set_pacer_exit_time_ms(now_ms);
913 }
914 }
ilnik04f4d122017-06-19 07:18:55 -0700915
stefan1d8a5062015-10-02 03:39:33 -0700916 PacketOptions options;
Petter Strandmark26bc6692018-05-29 08:43:35 +0200917 // If we are sending over RTX, it also means this is a retransmission.
918 // E.g. RTPSender::TrySendRedundantPayloads calls PrepareAndSendPacket with
919 // send_over_rtx = true but is_retransmit = false.
920 options.is_retransmit = is_retransmit || send_over_rtx;
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +0200921 bool has_transport_seq_num;
922 {
923 rtc::CritScope lock(&send_critsect_);
924 has_transport_seq_num =
925 UpdateTransportSequenceNumber(packet_to_send, &options.packet_id);
Sebastian Jansson1bca65b2018-10-10 09:58:08 +0200926 options.included_in_allocation =
927 has_transport_seq_num || force_part_of_allocation_;
928 options.included_in_feedback = has_transport_seq_num;
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +0200929 }
930 if (has_transport_seq_num) {
michaelt4da30442016-11-17 01:38:43 -0800931 AddPacketToTransportFeedback(options.packet_id, *packet_to_send,
philipel8aadd502017-02-23 02:56:13 -0800932 pacing_info);
sprang867fb522015-08-03 04:38:41 -0700933 }
Dino Radaković1807d572018-02-22 14:18:06 +0100934 options.application_data.assign(packet_to_send->application_data().begin(),
935 packet_to_send->application_data().end());
sprang867fb522015-08-03 04:38:41 -0700936
asapersson35151f32016-05-02 23:44:01 -0700937 if (!is_retransmit && !send_over_rtx) {
Erik Språng9c771c22019-06-17 16:31:53 +0200938 UpdateDelayStatistics(packet->capture_time_ms(), now_ms, packet->Ssrc());
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200939 UpdateOnSendPacket(options.packet_id, packet->capture_time_ms(),
940 packet->Ssrc());
stefanf116bd02015-10-27 08:29:42 -0700941 }
942
philipel32d00102017-02-27 02:18:46 -0800943 if (!SendPacketToNetwork(*packet_to_send, options, pacing_info))
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200944 return false;
945
946 {
tommiae695e92016-02-02 08:31:45 -0800947 rtc::CritScope lock(&send_critsect_);
stefan@webrtc.org8b94e3d2014-07-17 16:10:14 +0000948 media_has_been_sent_ = true;
949 }
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200950 UpdateRtpStats(*packet_to_send, send_over_rtx, is_retransmit);
951 return true;
sprang@webrtc.orgebad7652013-12-05 14:29:02 +0000952}
953
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200954void RTPSender::UpdateRtpStats(const RtpPacketToSend& packet,
sprang@webrtc.orgebad7652013-12-05 14:29:02 +0000955 bool is_rtx,
956 bool is_retransmit) {
sprangcd349d92016-07-13 09:11:28 -0700957 int64_t now_ms = clock_->TimeInMilliseconds();
sprang@webrtc.org5314e852014-01-27 13:20:36 +0000958
danilchap7c9426c2016-04-14 03:05:31 -0700959 rtc::CritScope lock(&statistics_crit_);
Danil Chapovalovd69e5262016-09-20 15:48:09 +0200960 StreamDataCounters* counters = is_rtx ? &rtx_rtp_stats_ : &rtp_stats_;
sprang@webrtc.orgebad7652013-12-05 14:29:02 +0000961
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200962 total_bitrate_sent_.Update(packet.size(), now_ms);
asapersson@webrtc.org44149392015-02-04 08:34:47 +0000963
Danil Chapovalovd69e5262016-09-20 15:48:09 +0200964 if (counters->first_packet_time_ms == -1)
965 counters->first_packet_time_ms = now_ms;
966
Erik Språngf53cfa92019-06-12 13:58:17 +0200967 if (packet.packet_type() == RtpPacketToSend::Type::kForwardErrorCorrection) {
Niels Möllerdbb988b2018-11-15 08:05:16 +0100968 counters->fec.AddPacket(packet);
Erik Språngf53cfa92019-06-12 13:58:17 +0200969 }
Danil Chapovalovd69e5262016-09-20 15:48:09 +0200970
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200971 if (is_retransmit) {
Niels Möllerdbb988b2018-11-15 08:05:16 +0100972 counters->retransmitted.AddPacket(packet);
Danil Chapovalov31e4e802016-08-03 18:27:40 +0200973 nack_bitrate_sent_.Update(packet.size(), now_ms);
974 }
Niels Möllerdbb988b2018-11-15 08:05:16 +0100975 counters->transmitted.AddPacket(packet);
sprangcd349d92016-07-13 09:11:28 -0700976
Danil Chapovalovd69e5262016-09-20 15:48:09 +0200977 if (rtp_stats_callback_)
978 rtp_stats_callback_->DataCountersUpdated(*counters, packet.Ssrc());
sprang@webrtc.orgebad7652013-12-05 14:29:02 +0000979}
980
philipel8aadd502017-02-23 02:56:13 -0800981size_t RTPSender::TimeToSendPadding(size_t bytes,
982 const PacedPacketInfo& pacing_info) {
stefan53b6cc32017-02-03 08:13:57 -0800983 if (bytes == 0)
pbos545727e2015-07-01 06:31:06 -0700984 return 0;
philipel8aadd502017-02-23 02:56:13 -0800985 size_t bytes_sent = TrySendRedundantPayloads(bytes, pacing_info);
pkasting@chromium.org4591fbd2014-11-20 22:28:14 +0000986 if (bytes_sent < bytes)
philipel8aadd502017-02-23 02:56:13 -0800987 bytes_sent += SendPadData(bytes - bytes_sent, pacing_info);
pkasting@chromium.org4591fbd2014-11-20 22:28:14 +0000988 return bytes_sent;
stefan@webrtc.org508a84b2013-06-17 12:53:37 +0000989}
990
Erik Språngf6468d22019-07-05 16:53:43 +0200991std::vector<std::unique_ptr<RtpPacketToSend>> RTPSender::GeneratePadding(
992 size_t target_size_bytes) {
Erik Språng478cb462019-06-26 15:49:27 +0200993 // This method does not actually send packets, it just generates
994 // them and puts them in the pacer queue. Since this should incur
995 // low overhead, keep the lock for the scope of the method in order
996 // to make the code more readable.
Erik Språng478cb462019-06-26 15:49:27 +0200997
Erik Språngf6468d22019-07-05 16:53:43 +0200998 std::vector<std::unique_ptr<RtpPacketToSend>> padding_packets;
Erik Språng478cb462019-06-26 15:49:27 +0200999 size_t bytes_left = target_size_bytes;
Erik Språng0f6191d2019-07-15 20:33:40 +02001000 if (SupportsRtxPayloadPadding()) {
Mirko Bonadeia7e3bce2019-07-12 17:35:56 +00001001 while (bytes_left >= kMinPayloadPaddingBytes) {
Erik Språng478cb462019-06-26 15:49:27 +02001002 std::unique_ptr<RtpPacketToSend> packet =
1003 packet_history_.GetPayloadPaddingPacket(
1004 [&](const RtpPacketToSend& packet)
1005 -> std::unique_ptr<RtpPacketToSend> {
Erik Språng478cb462019-06-26 15:49:27 +02001006 return BuildRtxPacket(packet);
1007 });
1008 if (!packet) {
1009 break;
1010 }
1011
1012 bytes_left -= std::min(bytes_left, packet->payload_size());
1013 packet->set_packet_type(RtpPacketToSend::Type::kPadding);
Erik Språngf6468d22019-07-05 16:53:43 +02001014 padding_packets.push_back(std::move(packet));
Erik Språng478cb462019-06-26 15:49:27 +02001015 }
1016 }
1017
Erik Språng0f6191d2019-07-15 20:33:40 +02001018 rtc::CritScope lock(&send_critsect_);
1019 if (!sending_media_) {
1020 return {};
1021 }
1022
Erik Språng478cb462019-06-26 15:49:27 +02001023 size_t padding_bytes_in_packet;
1024 const size_t max_payload_size = max_packet_size_ - RtpHeaderLength();
1025 if (audio_configured_) {
1026 // Allow smaller padding packets for audio.
1027 padding_bytes_in_packet = rtc::SafeClamp<size_t>(
1028 bytes_left, kMinAudioPaddingLength,
1029 rtc::SafeMin(max_payload_size, kMaxPaddingLength));
1030 } else {
1031 // Always send full padding packets. This is accounted for by the
1032 // RtpPacketSender, which will make sure we don't send too much padding even
1033 // if a single packet is larger than requested.
1034 // We do this to avoid frequently sending small packets on higher bitrates.
1035 padding_bytes_in_packet = rtc::SafeMin(max_payload_size, kMaxPaddingLength);
1036 }
1037
1038 while (bytes_left > 0) {
1039 auto padding_packet =
1040 absl::make_unique<RtpPacketToSend>(&rtp_header_extension_map_);
1041 padding_packet->set_packet_type(RtpPacketToSend::Type::kPadding);
1042 padding_packet->SetMarker(false);
1043 padding_packet->SetTimestamp(last_rtp_timestamp_);
1044 padding_packet->set_capture_time_ms(capture_time_ms_);
1045 if (rtx_ == kRtxOff) {
1046 if (last_payload_type_ == -1) {
1047 break;
1048 }
1049 // Without RTX we can't send padding in the middle of frames.
1050 // For audio marker bits doesn't mark the end of a frame and frames
1051 // are usually a single packet, so for now we don't apply this rule
1052 // for audio.
1053 if (!audio_configured_ && !last_packet_marker_bit_) {
1054 break;
1055 }
1056
1057 RTC_DCHECK(ssrc_);
1058 padding_packet->SetSsrc(*ssrc_);
1059 padding_packet->SetPayloadType(last_payload_type_);
1060 padding_packet->SetSequenceNumber(sequence_number_++);
1061 } else {
1062 // Without abs-send-time or transport sequence number a media packet
1063 // must be sent before padding so that the timestamps used for
1064 // estimation are correct.
1065 if (!media_has_been_sent_ &&
1066 !(rtp_header_extension_map_.IsRegistered(AbsoluteSendTime::kId) ||
1067 rtp_header_extension_map_.IsRegistered(
1068 TransportSequenceNumber::kId))) {
1069 break;
1070 }
1071 // Only change the timestamp of padding packets sent over RTX.
1072 // Padding only packets over RTP has to be sent as part of a media
1073 // frame (and therefore the same timestamp).
1074 int64_t now_ms = clock_->TimeInMilliseconds();
1075 if (last_timestamp_time_ms_ > 0) {
1076 padding_packet->SetTimestamp(padding_packet->Timestamp() +
1077 (now_ms - last_timestamp_time_ms_) *
1078 kTimestampTicksPerMs);
1079 padding_packet->set_capture_time_ms(padding_packet->capture_time_ms() +
1080 (now_ms - last_timestamp_time_ms_));
1081 }
1082 RTC_DCHECK(ssrc_rtx_);
1083 padding_packet->SetSsrc(*ssrc_rtx_);
1084 padding_packet->SetSequenceNumber(sequence_number_rtx_++);
1085 padding_packet->SetPayloadType(rtx_payload_type_map_.begin()->second);
1086 }
1087
Erik Språngf6468d22019-07-05 16:53:43 +02001088 if (rtp_header_extension_map_.IsRegistered(TransportSequenceNumber::kId)) {
1089 padding_packet->ReserveExtension<TransportSequenceNumber>();
1090 }
Erik Språng0f6191d2019-07-15 20:33:40 +02001091 if (rtp_header_extension_map_.IsRegistered(TransmissionOffset::kId)) {
1092 padding_packet->ReserveExtension<TransmissionOffset>();
1093 }
1094 if (rtp_header_extension_map_.IsRegistered(AbsoluteSendTime::kId)) {
1095 padding_packet->ReserveExtension<AbsoluteSendTime>();
1096 }
1097
Erik Språng478cb462019-06-26 15:49:27 +02001098 padding_packet->SetPadding(padding_bytes_in_packet);
1099 bytes_left -= std::min(bytes_left, padding_bytes_in_packet);
Erik Språngf6468d22019-07-05 16:53:43 +02001100 padding_packets.push_back(std::move(padding_packet));
Erik Språng478cb462019-06-26 15:49:27 +02001101 }
Erik Språngf6468d22019-07-05 16:53:43 +02001102
1103 return padding_packets;
Erik Språng478cb462019-06-26 15:49:27 +02001104}
1105
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001106bool RTPSender::SendToNetwork(std::unique_ptr<RtpPacketToSend> packet,
Erik Språng13eb7642019-06-24 10:58:48 +02001107 StorageType storage) {
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001108 RTC_DCHECK(packet);
solenberg@webrtc.org7ebbea12013-05-16 11:10:31 +00001109 int64_t now_ms = clock_->TimeInMilliseconds();
1110
brandtr9dfff292016-11-14 05:14:50 -08001111 uint32_t ssrc = packet->Ssrc();
Peter Boströme23e7372015-10-08 11:44:14 +02001112 if (paced_sender_) {
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001113 uint16_t seq_no = packet->SequenceNumber();
Erik Språng83afeeb2019-05-14 15:57:19 +02001114 int64_t capture_time_ms = packet->capture_time_ms();
Per Kjellander17c147c2019-02-20 12:06:17 +01001115 size_t packet_size =
1116 send_side_bwe_with_overhead_ ? packet->size() : packet->payload_size();
Erik Språng13eb7642019-06-24 10:58:48 +02001117 auto packet_type = packet->packet_type();
Erik Språngf6468d22019-07-05 16:53:43 +02001118 RTC_CHECK(packet_type) << "Packet type must be set before sending.";
1119
1120 if (pacer_legacy_packet_referencing_) {
1121 // If |pacer_reference_packets_| then pacer needs to find the packet in
1122 // the history when it is time to send, so move packet there.
1123 if (ssrc == FlexfecSsrc()) {
1124 // Store FlexFEC packets in a separate history since they are on a
1125 // separate SSRC.
1126 flexfec_packet_history_.PutRtpPacket(std::move(packet), storage,
1127 absl::nullopt);
1128 } else {
1129 packet_history_.PutRtpPacket(std::move(packet), storage, absl::nullopt);
1130 }
1131
1132 paced_sender_->InsertPacket(PacketTypeToPriority(*packet_type), ssrc,
1133 seq_no, capture_time_ms, packet_size, false);
brandtr9dfff292016-11-14 05:14:50 -08001134 } else {
Erik Språngf6468d22019-07-05 16:53:43 +02001135 packet->set_allow_retransmission(storage ==
1136 StorageType::kAllowRetransmission);
1137 paced_sender_->EnqueuePacket(std::move(packet));
brandtr9dfff292016-11-14 05:14:50 -08001138 }
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001139
Sergey Ulanov525df3f2016-08-02 17:46:41 -07001140 return true;
stefan@webrtc.orgddfdfed2012-07-03 13:21:22 +00001141 }
Stefan Holmerf5dca482016-01-27 12:58:51 +01001142
1143 PacketOptions options;
Petter Strandmark26bc6692018-05-29 08:43:35 +02001144 options.is_retransmit = false;
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +02001145
Danil Chapovalovaf52b682018-11-27 10:48:27 +01001146 // |capture_time_ms| <= 0 is considered invalid.
1147 // TODO(holmer): This should be changed all over Video Engine so that negative
1148 // time is consider invalid, while 0 is considered a valid time.
1149 if (packet->capture_time_ms() > 0) {
1150 packet->SetExtension<TransmissionOffset>(
1151 kTimestampTicksPerMs * (now_ms - packet->capture_time_ms()));
1152
1153 if (populate_network2_timestamp_ &&
1154 packet->HasExtension<VideoTimingExtension>()) {
1155 packet->set_network2_time_ms(now_ms);
1156 }
1157 }
1158 packet->SetExtension<AbsoluteSendTime>(AbsoluteSendTime::MsTo24Bits(now_ms));
1159
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +02001160 bool has_transport_seq_num;
1161 {
1162 rtc::CritScope lock(&send_critsect_);
1163 has_transport_seq_num =
1164 UpdateTransportSequenceNumber(packet.get(), &options.packet_id);
Sebastian Jansson1bca65b2018-10-10 09:58:08 +02001165 options.included_in_allocation =
1166 has_transport_seq_num || force_part_of_allocation_;
1167 options.included_in_feedback = has_transport_seq_num;
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +02001168 }
1169 if (has_transport_seq_num) {
michaelt4da30442016-11-17 01:38:43 -08001170 AddPacketToTransportFeedback(options.packet_id, *packet.get(),
philipel8aadd502017-02-23 02:56:13 -08001171 PacedPacketInfo());
Stefan Holmerf5dca482016-01-27 12:58:51 +01001172 }
Dino Radaković1807d572018-02-22 14:18:06 +01001173 options.application_data.assign(packet->application_data().begin(),
1174 packet->application_data().end());
Stefan Holmerf5dca482016-01-27 12:58:51 +01001175
Erik Språng9c771c22019-06-17 16:31:53 +02001176 UpdateDelayStatistics(packet->capture_time_ms(), now_ms, packet->Ssrc());
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001177 UpdateOnSendPacket(options.packet_id, packet->capture_time_ms(),
1178 packet->Ssrc());
1179
philipel32d00102017-02-27 02:18:46 -08001180 bool sent = SendPacketToNetwork(*packet, options, PacedPacketInfo());
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001181
1182 if (sent) {
1183 {
1184 rtc::CritScope lock(&send_critsect_);
1185 media_has_been_sent_ = true;
1186 }
1187 UpdateRtpStats(*packet, false, false);
1188 }
sprang@webrtc.orgc957ffc2015-02-02 13:08:02 +00001189
brandtr9dfff292016-11-14 05:14:50 -08001190 // To support retransmissions, we store the media packet as sent in the
1191 // packet history (even if send failed).
1192 if (storage == kAllowRetransmission) {
Danil Chapovalov603ce982017-12-27 11:32:50 +01001193 RTC_DCHECK_EQ(ssrc, SSRC());
Erik Språnga12b1d62018-03-14 12:39:24 +01001194 packet_history_.PutRtpPacket(std::move(packet), storage, now_ms);
brandtr9dfff292016-11-14 05:14:50 -08001195 }
Peter Boströme23e7372015-10-08 11:44:14 +02001196
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001197 return sent;
stefan@webrtc.org6a4bef42011-12-22 12:52:41 +00001198}
1199
Erik Språng13eb7642019-06-24 10:58:48 +02001200bool RTPSender::SendToNetwork(std::unique_ptr<RtpPacketToSend> packet,
1201 StorageType storage,
1202 RtpPacketSender::Priority priority) {
1203 packet->set_packet_type(PacketPriorityToType(priority));
1204 return SendToNetwork(std::move(packet), storage);
1205}
1206
Johannes Kron4a8a5e72018-09-26 09:57:48 +02001207void RTPSender::RecomputeMaxSendDelay() {
1208 max_delay_it_ = send_delays_.begin();
1209 for (auto it = send_delays_.begin(); it != send_delays_.end(); ++it) {
1210 if (it->second >= max_delay_it_->second) {
1211 max_delay_it_ = it;
1212 }
1213 }
1214}
1215
Erik Språng9c771c22019-06-17 16:31:53 +02001216void RTPSender::UpdateDelayStatistics(int64_t capture_time_ms,
1217 int64_t now_ms,
1218 uint32_t ssrc) {
asapersson35151f32016-05-02 23:44:01 -07001219 if (!send_side_delay_observer_ || capture_time_ms <= 0)
Peter Boström71861a02015-05-28 14:45:36 +02001220 return;
1221
Johannes Kron4a8a5e72018-09-26 09:57:48 +02001222 int avg_delay_ms = 0;
stefan@webrtc.org168f23f2014-07-11 13:44:02 +00001223 int max_delay_ms = 0;
Henrik Boström9fe18342019-05-16 18:38:20 +02001224 uint64_t total_packet_send_delay_ms = 0;
stefan@webrtc.org168f23f2014-07-11 13:44:02 +00001225 {
danilchap7c9426c2016-04-14 03:05:31 -07001226 rtc::CritScope cs(&statistics_crit_);
Johannes Kron4a8a5e72018-09-26 09:57:48 +02001227 // Compute the max and average of the recent capture-to-send delays.
1228 // The time complexity of the current approach depends on the distribution
1229 // of the delay values. This could be done more efficiently.
1230
1231 // Remove elements older than kSendSideDelayWindowMs.
1232 auto lower_bound =
1233 send_delays_.lower_bound(now_ms - kSendSideDelayWindowMs);
1234 for (auto it = send_delays_.begin(); it != lower_bound; ++it) {
1235 if (max_delay_it_ == it) {
1236 max_delay_it_ = send_delays_.end();
1237 }
1238 sum_delays_ms_ -= it->second;
1239 }
1240 send_delays_.erase(send_delays_.begin(), lower_bound);
1241 if (max_delay_it_ == send_delays_.end()) {
1242 // Removed the previous max. Need to recompute.
1243 RecomputeMaxSendDelay();
1244 }
1245
1246 // Add the new element.
Johannes Kron965e7942018-09-13 15:36:20 +02001247 RTC_DCHECK_GE(now_ms, static_cast<int64_t>(0));
1248 RTC_DCHECK_LE(now_ms, std::numeric_limits<int64_t>::max() / 2);
1249 RTC_DCHECK_GE(capture_time_ms, static_cast<int64_t>(0));
1250 RTC_DCHECK_LE(capture_time_ms, std::numeric_limits<int64_t>::max() / 2);
1251 int64_t diff_ms = now_ms - capture_time_ms;
1252 RTC_DCHECK_GE(diff_ms, static_cast<int64_t>(0));
1253 RTC_DCHECK_LE(diff_ms,
1254 static_cast<int64_t>(std::numeric_limits<int>::max()));
Johannes Kron4a8a5e72018-09-26 09:57:48 +02001255 int new_send_delay = rtc::dchecked_cast<int>(now_ms - capture_time_ms);
1256 SendDelayMap::iterator it;
1257 bool inserted;
1258 std::tie(it, inserted) =
1259 send_delays_.insert(std::make_pair(now_ms, new_send_delay));
1260 if (!inserted) {
1261 // TODO(terelius): If we have multiple delay measurements during the same
1262 // millisecond then we keep the most recent one. It is not clear that this
1263 // is the right decision, but it preserves an earlier behavior.
1264 int previous_send_delay = it->second;
1265 sum_delays_ms_ -= previous_send_delay;
1266 it->second = new_send_delay;
1267 if (max_delay_it_ == it && new_send_delay < previous_send_delay) {
1268 RecomputeMaxSendDelay();
1269 }
Peter Boström71861a02015-05-28 14:45:36 +02001270 }
Johannes Kron4a8a5e72018-09-26 09:57:48 +02001271 if (max_delay_it_ == send_delays_.end() ||
1272 it->second >= max_delay_it_->second) {
1273 max_delay_it_ = it;
1274 }
1275 sum_delays_ms_ += new_send_delay;
Henrik Boström9fe18342019-05-16 18:38:20 +02001276 total_packet_send_delay_ms_ += new_send_delay;
1277 total_packet_send_delay_ms = total_packet_send_delay_ms_;
Johannes Kron4a8a5e72018-09-26 09:57:48 +02001278
1279 size_t num_delays = send_delays_.size();
1280 RTC_DCHECK(max_delay_it_ != send_delays_.end());
1281 max_delay_ms = rtc::dchecked_cast<int>(max_delay_it_->second);
1282 int64_t avg_ms = (sum_delays_ms_ + num_delays / 2) / num_delays;
1283 RTC_DCHECK_GE(avg_ms, static_cast<int64_t>(0));
1284 RTC_DCHECK_LE(avg_ms,
1285 static_cast<int64_t>(std::numeric_limits<int>::max()));
1286 avg_delay_ms =
1287 rtc::dchecked_cast<int>((sum_delays_ms_ + num_delays / 2) / num_delays);
stefan@webrtc.org168f23f2014-07-11 13:44:02 +00001288 }
Henrik Boström9fe18342019-05-16 18:38:20 +02001289 send_side_delay_observer_->SendSideDelayUpdated(
1290 avg_delay_ms, max_delay_ms, total_packet_send_delay_ms, ssrc);
stefan@webrtc.org0a3c1472013-12-05 14:05:07 +00001291}
1292
asapersson35151f32016-05-02 23:44:01 -07001293void RTPSender::UpdateOnSendPacket(int packet_id,
1294 int64_t capture_time_ms,
1295 uint32_t ssrc) {
1296 if (!send_packet_observer_ || capture_time_ms <= 0 || packet_id == -1)
1297 return;
1298
1299 send_packet_observer_->OnSendPacket(packet_id, capture_time_ms, ssrc);
1300}
1301
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001302void RTPSender::ProcessBitrate() {
sprangcd349d92016-07-13 09:11:28 -07001303 if (!bitrate_callback_)
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001304 return;
sprangcd349d92016-07-13 09:11:28 -07001305 int64_t now_ms = clock_->TimeInMilliseconds();
1306 uint32_t ssrc;
1307 {
1308 rtc::CritScope lock(&send_critsect_);
nisse7d59f6b2017-02-21 03:40:24 -08001309 if (!ssrc_)
1310 return;
1311 ssrc = *ssrc_;
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001312 }
sprangcd349d92016-07-13 09:11:28 -07001313
1314 rtc::CritScope lock(&statistics_crit_);
1315 bitrate_callback_->Notify(total_bitrate_sent_.Rate(now_ms).value_or(0),
1316 nack_bitrate_sent_.Rate(now_ms).value_or(0), ssrc);
niklase@google.com470e71d2011-07-07 08:21:25 +00001317}
1318
isheriff6b4b5f32016-06-08 00:24:21 -07001319size_t RTPSender::RtpHeaderLength() const {
tommiae695e92016-02-02 08:31:45 -08001320 rtc::CritScope lock(&send_critsect_);
guoweis@webrtc.org45362892015-03-04 22:55:15 +00001321 size_t rtp_header_length = kRtpHeaderLength;
pbos@webrtc.org9334ac22014-11-24 08:25:50 +00001322 rtp_header_length += sizeof(uint32_t) * csrcs_.size();
Danil Chapovalov7b189922018-10-03 10:15:36 +02001323 rtp_header_length += RtpHeaderExtensionSize(kFecOrPaddingExtensionSizes,
1324 rtp_header_extension_map_);
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001325 return rtp_header_length;
niklase@google.com470e71d2011-07-07 08:21:25 +00001326}
1327
mflodmanfcf54bd2015-04-14 21:28:08 +02001328uint16_t RTPSender::AllocateSequenceNumber(uint16_t packets_to_send) {
tommiae695e92016-02-02 08:31:45 -08001329 rtc::CritScope lock(&send_critsect_);
mflodmanfcf54bd2015-04-14 21:28:08 +02001330 uint16_t first_allocated_sequence_number = sequence_number_;
1331 sequence_number_ += packets_to_send;
1332 return first_allocated_sequence_number;
niklase@google.com470e71d2011-07-07 08:21:25 +00001333}
1334
pbos@webrtc.org2f4b14e2014-07-15 15:25:39 +00001335void RTPSender::GetDataCounters(StreamDataCounters* rtp_stats,
1336 StreamDataCounters* rtx_stats) const {
danilchap7c9426c2016-04-14 03:05:31 -07001337 rtc::CritScope lock(&statistics_crit_);
pbos@webrtc.org2f4b14e2014-07-15 15:25:39 +00001338 *rtp_stats = rtp_stats_;
1339 *rtx_stats = rtx_rtp_stats_;
niklase@google.com470e71d2011-07-07 08:21:25 +00001340}
1341
Danil Chapovalov5e57b172016-09-02 19:15:59 +02001342std::unique_ptr<RtpPacketToSend> RTPSender::AllocatePacket() const {
1343 rtc::CritScope lock(&send_critsect_);
Danil Chapovalov3b4b4f52018-10-12 12:50:43 +02001344 // TODO(danilchap): Find better motivator and value for extra capacity.
1345 // RtpPacketizer might slightly miscalulate needed size,
1346 // SRTP may benefit from extra space in the buffer and do encryption in place
1347 // saving reallocation.
1348 // While sending slightly oversized packet increase chance of dropped packet,
1349 // it is better than crash on drop packet without trying to send it.
1350 static constexpr int kExtraCapacity = 16;
1351 auto packet = absl::make_unique<RtpPacketToSend>(
1352 &rtp_header_extension_map_, max_packet_size_ + kExtraCapacity);
nisse7d59f6b2017-02-21 03:40:24 -08001353 RTC_DCHECK(ssrc_);
1354 packet->SetSsrc(*ssrc_);
Danil Chapovalov5e57b172016-09-02 19:15:59 +02001355 packet->SetCsrcs(csrcs_);
1356 // Reserve extensions, if registered, RtpSender set in SendToNetwork.
1357 packet->ReserveExtension<AbsoluteSendTime>();
1358 packet->ReserveExtension<TransmissionOffset>();
1359 packet->ReserveExtension<TransportSequenceNumber>();
Niels Möller6893f3c2019-01-31 08:56:26 +01001360
Steve Anton4af95842018-04-06 11:09:46 -07001361 if (!mid_.empty()) {
Steve Anton296a0ce2018-03-22 15:17:27 -07001362 // This is a no-op if the MID header extension is not registered.
Steve Anton4af95842018-04-06 11:09:46 -07001363 packet->SetExtension<RtpMid>(mid_);
Steve Anton296a0ce2018-03-22 15:17:27 -07001364 }
Amit Hilbuch77938e62018-12-21 09:23:38 -08001365 if (!rid_.empty()) {
1366 // This is a no-op if the RID header extension is not registered.
1367 packet->SetExtension<RtpStreamId>(rid_);
1368 }
Danil Chapovalov5e57b172016-09-02 19:15:59 +02001369 return packet;
1370}
1371
1372bool RTPSender::AssignSequenceNumber(RtpPacketToSend* packet) {
1373 rtc::CritScope lock(&send_critsect_);
1374 if (!sending_media_)
1375 return false;
nisse7d59f6b2017-02-21 03:40:24 -08001376 RTC_DCHECK(packet->Ssrc() == ssrc_);
Danil Chapovalov5e57b172016-09-02 19:15:59 +02001377 packet->SetSequenceNumber(sequence_number_++);
1378
1379 // Remember marker bit to determine if padding can be inserted with
1380 // sequence number following |packet|.
1381 last_packet_marker_bit_ = packet->Marker();
Danil Chapovalovb3179c72018-03-22 10:13:07 +01001382 // Remember payload type to use in the padding packet if rtx is disabled.
1383 last_payload_type_ = packet->PayloadType();
Danil Chapovalov5e57b172016-09-02 19:15:59 +02001384 // Save timestamps to generate timestamp field and extensions for the padding.
1385 last_rtp_timestamp_ = packet->Timestamp();
1386 last_timestamp_time_ms_ = clock_->TimeInMilliseconds();
1387 capture_time_ms_ = packet->capture_time_ms();
1388 return true;
1389}
1390
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001391bool RTPSender::UpdateTransportSequenceNumber(RtpPacketToSend* packet,
Sebastian Jansson30e2d6e2018-10-09 18:27:36 +02001392 int* packet_id) {
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001393 RTC_DCHECK(packet);
1394 RTC_DCHECK(packet_id);
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001395 if (!rtp_header_extension_map_.IsRegistered(TransportSequenceNumber::kId))
stefana23fc622016-07-28 07:56:38 -07001396 return false;
1397
asapersson35151f32016-05-02 23:44:01 -07001398 if (!transport_sequence_number_allocator_)
1399 return false;
1400
1401 *packet_id = transport_sequence_number_allocator_->AllocateSequenceNumber();
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001402
1403 if (!packet->SetExtension<TransportSequenceNumber>(*packet_id))
1404 return false;
1405
asapersson35151f32016-05-02 23:44:01 -07001406 return true;
sprang867fb522015-08-03 04:38:41 -07001407}
1408
pbos@webrtc.orgd16e8392014-12-19 13:49:55 +00001409void RTPSender::SetSendingMediaStatus(bool enabled) {
tommiae695e92016-02-02 08:31:45 -08001410 rtc::CritScope lock(&send_critsect_);
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001411 sending_media_ = enabled;
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001412}
1413
1414bool RTPSender::SendingMedia() const {
tommiae695e92016-02-02 08:31:45 -08001415 rtc::CritScope lock(&send_critsect_);
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001416 return sending_media_;
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001417}
1418
Sebastian Jansson1bca65b2018-10-10 09:58:08 +02001419void RTPSender::SetAsPartOfAllocation(bool part_of_allocation) {
1420 rtc::CritScope lock(&send_critsect_);
1421 force_part_of_allocation_ = part_of_allocation;
1422}
1423
danilchap71fead22016-08-18 02:01:49 -07001424void RTPSender::SetTimestampOffset(uint32_t timestamp) {
tommiae695e92016-02-02 08:31:45 -08001425 rtc::CritScope lock(&send_critsect_);
danilchap71fead22016-08-18 02:01:49 -07001426 timestamp_offset_ = timestamp;
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001427}
1428
danilchap71fead22016-08-18 02:01:49 -07001429uint32_t RTPSender::TimestampOffset() const {
tommiae695e92016-02-02 08:31:45 -08001430 rtc::CritScope lock(&send_critsect_);
danilchap71fead22016-08-18 02:01:49 -07001431 return timestamp_offset_;
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001432}
1433
pbos@webrtc.org2f446732013-04-08 11:08:41 +00001434void RTPSender::SetSSRC(uint32_t ssrc) {
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001435 // This is configured via the API.
tommiae695e92016-02-02 08:31:45 -08001436 rtc::CritScope lock(&send_critsect_);
niklase@google.com470e71d2011-07-07 08:21:25 +00001437
nisse7d59f6b2017-02-21 03:40:24 -08001438 if (ssrc_ == ssrc) {
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001439 return; // Since it's same ssrc, don't reset anything.
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001440 }
nisse7d59f6b2017-02-21 03:40:24 -08001441 ssrc_.emplace(ssrc);
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001442 if (!sequence_number_forced_) {
danilchap47a740b2015-12-15 00:30:07 -08001443 sequence_number_ = random_.Rand(1, kMaxInitRtpSeqNumber);
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001444 }
niklase@google.com470e71d2011-07-07 08:21:25 +00001445}
1446
pbos@webrtc.org2f446732013-04-08 11:08:41 +00001447uint32_t RTPSender::SSRC() const {
tommiae695e92016-02-02 08:31:45 -08001448 rtc::CritScope lock(&send_critsect_);
nisse7d59f6b2017-02-21 03:40:24 -08001449 RTC_DCHECK(ssrc_);
1450 return *ssrc_;
niklase@google.com470e71d2011-07-07 08:21:25 +00001451}
1452
Amit Hilbuch77938e62018-12-21 09:23:38 -08001453void RTPSender::SetRid(const std::string& rid) {
1454 // RID is used in simulcast scenario when multiple layers share the same mid.
1455 rtc::CritScope lock(&send_critsect_);
1456 RTC_DCHECK_LE(rid.length(), RtpStreamId::kMaxValueSizeBytes);
1457 rid_ = rid;
1458}
1459
Steve Anton296a0ce2018-03-22 15:17:27 -07001460void RTPSender::SetMid(const std::string& mid) {
1461 // This is configured via the API.
1462 rtc::CritScope lock(&send_critsect_);
Steve Anton4af95842018-04-06 11:09:46 -07001463 mid_ = mid;
Steve Anton296a0ce2018-03-22 15:17:27 -07001464}
1465
Danil Chapovalovd264df52018-06-14 12:59:38 +02001466absl::optional<uint32_t> RTPSender::FlexfecSsrc() const {
Niels Möller59ab1cf2019-02-06 22:48:11 +01001467 return flexfec_ssrc_;
brandtr9dfff292016-11-14 05:14:50 -08001468}
1469
pbos@webrtc.org9334ac22014-11-24 08:25:50 +00001470void RTPSender::SetCsrcs(const std::vector<uint32_t>& csrcs) {
spranga8ae6f22017-09-04 07:23:56 -07001471 RTC_DCHECK_LE(csrcs.size(), kRtpCsrcSize);
tommiae695e92016-02-02 08:31:45 -08001472 rtc::CritScope lock(&send_critsect_);
pbos@webrtc.org9334ac22014-11-24 08:25:50 +00001473 csrcs_ = csrcs;
niklase@google.com470e71d2011-07-07 08:21:25 +00001474}
1475
pbos@webrtc.org2f446732013-04-08 11:08:41 +00001476void RTPSender::SetSequenceNumber(uint16_t seq) {
tommiae695e92016-02-02 08:31:45 -08001477 rtc::CritScope lock(&send_critsect_);
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001478 sequence_number_forced_ = true;
1479 sequence_number_ = seq;
niklase@google.com470e71d2011-07-07 08:21:25 +00001480}
1481
pbos@webrtc.org2f446732013-04-08 11:08:41 +00001482uint16_t RTPSender::SequenceNumber() const {
tommiae695e92016-02-02 08:31:45 -08001483 rtc::CritScope lock(&send_critsect_);
phoglund@webrtc.org43da54a2013-01-25 10:53:38 +00001484 return sequence_number_;
niklase@google.com470e71d2011-07-07 08:21:25 +00001485}
1486
Danil Chapovalov271195f2019-02-11 11:30:03 +01001487static void CopyHeaderAndExtensionsToRtxPacket(const RtpPacketToSend& packet,
1488 RtpPacketToSend* rtx_packet) {
Amit Hilbuch77938e62018-12-21 09:23:38 -08001489 // Set the relevant fixed packet headers. The following are not set:
1490 // * Payload type - it is replaced in rtx packets.
1491 // * Sequence number - RTX has a separate sequence numbering.
1492 // * SSRC - RTX stream has its own SSRC.
1493 rtx_packet->SetMarker(packet.Marker());
1494 rtx_packet->SetTimestamp(packet.Timestamp());
1495
1496 // Set the variable fields in the packet header:
1497 // * CSRCs - must be set before header extensions.
1498 // * Header extensions - replace Rid header with RepairedRid header.
1499 const std::vector<uint32_t> csrcs = packet.Csrcs();
1500 rtx_packet->SetCsrcs(csrcs);
1501 for (int extension = kRtpExtensionNone + 1;
1502 extension < kRtpExtensionNumberOfExtensions; ++extension) {
1503 RTPExtensionType source_extension =
1504 static_cast<RTPExtensionType>(extension);
1505 // Rid header should be replaced with RepairedRid header
1506 RTPExtensionType destination_extension =
1507 source_extension == kRtpExtensionRtpStreamId
1508 ? kRtpExtensionRepairedRtpStreamId
1509 : source_extension;
1510
1511 // Empty extensions should be supported, so not checking |source.empty()|.
1512 if (!packet.HasExtension(source_extension)) {
1513 continue;
1514 }
1515
1516 rtc::ArrayView<const uint8_t> source =
1517 packet.FindExtension(source_extension);
1518
1519 rtc::ArrayView<uint8_t> destination =
1520 rtx_packet->AllocateExtension(destination_extension, source.size());
1521
1522 // Could happen if any:
1523 // 1. Extension has 0 length.
1524 // 2. Extension is not registered in destination.
1525 // 3. Allocating extension in destination failed.
1526 if (destination.empty() || source.size() != destination.size()) {
1527 continue;
1528 }
1529
1530 std::memcpy(destination.begin(), source.begin(), destination.size());
1531 }
Amit Hilbuch77938e62018-12-21 09:23:38 -08001532}
1533
1534std::unique_ptr<RtpPacketToSend> RTPSender::BuildRtxPacket(
1535 const RtpPacketToSend& packet) {
Danil Chapovalov271195f2019-02-11 11:30:03 +01001536 std::unique_ptr<RtpPacketToSend> rtx_packet;
Amit Hilbuch77938e62018-12-21 09:23:38 -08001537
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001538 // Add original RTP header.
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001539 {
1540 rtc::CritScope lock(&send_critsect_);
1541 if (!sending_media_)
1542 return nullptr;
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001543
nisse7d59f6b2017-02-21 03:40:24 -08001544 RTC_DCHECK(ssrc_rtx_);
1545
brandtre6f98c72016-11-11 03:28:30 -08001546 // Replace payload type.
1547 auto kv = rtx_payload_type_map_.find(packet.PayloadType());
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001548 if (kv == rtx_payload_type_map_.end())
brandtre6f98c72016-11-11 03:28:30 -08001549 return nullptr;
Danil Chapovalov271195f2019-02-11 11:30:03 +01001550
1551 rtx_packet = absl::make_unique<RtpPacketToSend>(&rtp_header_extension_map_,
1552 max_packet_size_);
1553
brandtre6f98c72016-11-11 03:28:30 -08001554 rtx_packet->SetPayloadType(kv->second);
mflodman@webrtc.org9f5ebb52013-04-12 14:55:46 +00001555
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001556 // Replace sequence number.
1557 rtx_packet->SetSequenceNumber(sequence_number_rtx_++);
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001558
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001559 // Replace SSRC.
nisse7d59f6b2017-02-21 03:40:24 -08001560 rtx_packet->SetSsrc(*ssrc_rtx_);
Steve Anton296a0ce2018-03-22 15:17:27 -07001561
Danil Chapovalov271195f2019-02-11 11:30:03 +01001562 CopyHeaderAndExtensionsToRtxPacket(packet, rtx_packet.get());
1563
Amit Hilbuch77938e62018-12-21 09:23:38 -08001564 // The spec indicates that it is possible for a sender to stop sending mids
1565 // once the SSRCs have been bound on the receiver. As a result the source
1566 // rtp packet might not have the MID header extension set.
1567 // However, the SSRC of the RTX stream might not have been bound on the
1568 // receiver. This means that we should include it here.
1569 // The same argument goes for the Repaired RID extension.
Steve Anton4af95842018-04-06 11:09:46 -07001570 if (!mid_.empty()) {
Steve Anton296a0ce2018-03-22 15:17:27 -07001571 // This is a no-op if the MID header extension is not registered.
Steve Anton4af95842018-04-06 11:09:46 -07001572 rtx_packet->SetExtension<RtpMid>(mid_);
Steve Anton296a0ce2018-03-22 15:17:27 -07001573 }
Amit Hilbuch77938e62018-12-21 09:23:38 -08001574 if (!rid_.empty()) {
1575 // This is a no-op if the Repaired-RID header extension is not registered.
1576 // rtx_packet->SetExtension<RepairedRtpStreamId>(rid_);
1577 }
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001578 }
Danil Chapovalov271195f2019-02-11 11:30:03 +01001579 RTC_DCHECK(rtx_packet);
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001580
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001581 uint8_t* rtx_payload =
1582 rtx_packet->AllocatePayload(packet.payload_size() + kRtxHeaderSize);
Danil Chapovalov271195f2019-02-11 11:30:03 +01001583 if (rtx_payload == nullptr)
1584 return nullptr;
1585
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001586 // Add OSN (original sequence number).
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001587 ByteWriter<uint16_t>::WriteBigEndian(rtx_payload, packet.SequenceNumber());
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001588
1589 // Add original payload data.
danilchap96c15872016-11-21 01:35:29 -08001590 auto payload = packet.payload();
1591 memcpy(rtx_payload + kRtxHeaderSize, payload.data(), payload.size());
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001592
Dino Radaković1807d572018-02-22 14:18:06 +01001593 // Add original application data.
1594 rtx_packet->set_application_data(packet.application_data());
1595
Danil Chapovalov31e4e802016-08-03 18:27:40 +02001596 return rtx_packet;
mikhal@webrtc.orgbda7f302013-03-15 23:21:52 +00001597}
1598
sprang@webrtc.orgebad7652013-12-05 14:29:02 +00001599void RTPSender::RegisterRtpStatisticsCallback(
1600 StreamDataCountersCallback* callback) {
danilchap7c9426c2016-04-14 03:05:31 -07001601 rtc::CritScope cs(&statistics_crit_);
sprang@webrtc.orgebad7652013-12-05 14:29:02 +00001602 rtp_stats_callback_ = callback;
1603}
1604
1605StreamDataCountersCallback* RTPSender::GetRtpStatisticsCallback() const {
danilchap7c9426c2016-04-14 03:05:31 -07001606 rtc::CritScope cs(&statistics_crit_);
sprang@webrtc.orgebad7652013-12-05 14:29:02 +00001607 return rtp_stats_callback_;
1608}
1609
stefan@webrtc.org0bae1fa2014-11-05 14:05:29 +00001610uint32_t RTPSender::BitrateSent() const {
sprangcd349d92016-07-13 09:11:28 -07001611 rtc::CritScope cs(&statistics_crit_);
1612 return total_bitrate_sent_.Rate(clock_->TimeInMilliseconds()).value_or(0);
sprang@webrtc.org6811b6e2013-12-13 09:46:59 +00001613}
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001614
1615void RTPSender::SetRtpState(const RtpState& rtp_state) {
tommiae695e92016-02-02 08:31:45 -08001616 rtc::CritScope lock(&send_critsect_);
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001617 sequence_number_ = rtp_state.sequence_number;
1618 sequence_number_forced_ = true;
danilchap71fead22016-08-18 02:01:49 -07001619 timestamp_offset_ = rtp_state.start_timestamp;
danilchape5b41412016-08-22 03:39:23 -07001620 last_rtp_timestamp_ = rtp_state.timestamp;
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001621 capture_time_ms_ = rtp_state.capture_time_ms;
1622 last_timestamp_time_ms_ = rtp_state.last_timestamp_time_ms;
stefan@webrtc.org8b94e3d2014-07-17 16:10:14 +00001623 media_has_been_sent_ = rtp_state.media_has_been_sent;
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001624}
1625
1626RtpState RTPSender::GetRtpState() const {
tommiae695e92016-02-02 08:31:45 -08001627 rtc::CritScope lock(&send_critsect_);
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001628
1629 RtpState state;
1630 state.sequence_number = sequence_number_;
danilchap71fead22016-08-18 02:01:49 -07001631 state.start_timestamp = timestamp_offset_;
danilchape5b41412016-08-22 03:39:23 -07001632 state.timestamp = last_rtp_timestamp_;
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001633 state.capture_time_ms = capture_time_ms_;
1634 state.last_timestamp_time_ms = last_timestamp_time_ms_;
stefan@webrtc.org8b94e3d2014-07-17 16:10:14 +00001635 state.media_has_been_sent = media_has_been_sent_;
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001636
1637 return state;
1638}
1639
1640void RTPSender::SetRtxRtpState(const RtpState& rtp_state) {
tommiae695e92016-02-02 08:31:45 -08001641 rtc::CritScope lock(&send_critsect_);
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001642 sequence_number_rtx_ = rtp_state.sequence_number;
1643}
1644
1645RtpState RTPSender::GetRtxRtpState() const {
tommiae695e92016-02-02 08:31:45 -08001646 rtc::CritScope lock(&send_critsect_);
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001647
1648 RtpState state;
1649 state.sequence_number = sequence_number_rtx_;
danilchap71fead22016-08-18 02:01:49 -07001650 state.start_timestamp = timestamp_offset_;
pbos@webrtc.org2bb1bda2014-07-07 13:06:48 +00001651
1652 return state;
1653}
1654
philipel8aadd502017-02-23 02:56:13 -08001655void RTPSender::AddPacketToTransportFeedback(
1656 uint16_t packet_id,
1657 const RtpPacketToSend& packet,
1658 const PacedPacketInfo& pacing_info) {
michaelt4da30442016-11-17 01:38:43 -08001659 if (transport_feedback_observer_) {
Erik Språng30a276b2019-04-23 12:00:11 +02001660 size_t packet_size = packet.payload_size() + packet.padding_size();
1661 if (send_side_bwe_with_overhead_) {
1662 packet_size = packet.size();
1663 }
1664
1665 RtpPacketSendInfo packet_info;
1666 packet_info.ssrc = SSRC();
1667 packet_info.transport_sequence_number = packet_id;
Erik Språng490d76c2019-05-07 09:29:15 -07001668 packet_info.has_rtp_sequence_number = true;
Erik Språng30a276b2019-04-23 12:00:11 +02001669 packet_info.rtp_sequence_number = packet.SequenceNumber();
1670 packet_info.length = packet_size;
1671 packet_info.pacing_info = pacing_info;
1672 transport_feedback_observer_->OnAddPacket(packet_info);
michaelt4da30442016-11-17 01:38:43 -08001673 }
1674}
1675
1676void RTPSender::UpdateRtpOverhead(const RtpPacketToSend& packet) {
1677 if (!overhead_observer_)
1678 return;
nisse284542b2017-01-10 08:58:32 -08001679 size_t overhead_bytes_per_packet;
michaelt4da30442016-11-17 01:38:43 -08001680 {
1681 rtc::CritScope lock(&send_critsect_);
1682 if (rtp_overhead_bytes_per_packet_ == packet.headers_size()) {
1683 return;
1684 }
1685 rtp_overhead_bytes_per_packet_ = packet.headers_size();
nisse284542b2017-01-10 08:58:32 -08001686 overhead_bytes_per_packet = rtp_overhead_bytes_per_packet_;
michaelt4da30442016-11-17 01:38:43 -08001687 }
1688 overhead_observer_->OnOverheadChanged(overhead_bytes_per_packet);
1689}
1690
sprang168794c2017-07-06 04:38:06 -07001691int64_t RTPSender::LastTimestampTimeMs() const {
1692 rtc::CritScope lock(&send_critsect_);
1693 return last_timestamp_time_ms_;
1694}
1695
Erik Språng8b101922018-01-18 11:58:05 -08001696void RTPSender::SetRtt(int64_t rtt_ms) {
1697 packet_history_.SetRtt(rtt_ms);
1698 flexfec_packet_history_.SetRtt(rtt_ms);
1699}
Erik Språng490d76c2019-05-07 09:29:15 -07001700
1701void RTPSender::OnPacketsAcknowledged(
1702 rtc::ArrayView<const uint16_t> sequence_numbers) {
1703 packet_history_.CullAcknowledgedPackets(sequence_numbers);
1704}
pwestin@webrtc.orgc66e8b32012-11-07 17:01:04 +00001705} // namespace webrtc