blob: f57858c344a85f5d069a806015e55c7371f883d8 [file] [log] [blame]
Niels Möller530ead42018-10-04 14:28:39 +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 "audio/channel_send.h"
12
13#include <algorithm>
14#include <map>
15#include <memory>
16#include <string>
17#include <utility>
18#include <vector>
19
20#include "absl/memory/memory.h"
21#include "api/array_view.h"
Niels Möllerdced9f62018-11-19 10:27:07 +010022#include "api/call/transport.h"
Steve Anton10542f22019-01-11 09:11:00 -080023#include "api/crypto/frame_encryptor_interface.h"
Danil Chapovalov83bbe912019-08-07 12:24:53 +020024#include "api/rtc_event_log/rtc_event_log.h"
Niels Möller530ead42018-10-04 14:28:39 +020025#include "audio/utility/audio_frame_operations.h"
26#include "call/rtp_transport_controller_send_interface.h"
27#include "logging/rtc_event_log/events/rtc_event_audio_playout.h"
Niels Möller530ead42018-10-04 14:28:39 +020028#include "modules/audio_coding/audio_network_adaptor/include/audio_network_adaptor_config.h"
Niels Möllerdced9f62018-11-19 10:27:07 +010029#include "modules/audio_coding/include/audio_coding_module.h"
30#include "modules/audio_processing/rms_level.h"
Niels Möller530ead42018-10-04 14:28:39 +020031#include "modules/pacing/packet_router.h"
32#include "modules/utility/include/process_thread.h"
33#include "rtc_base/checks.h"
Yves Gerey2e00abc2018-10-05 15:39:24 +020034#include "rtc_base/event.h"
Niels Möller530ead42018-10-04 14:28:39 +020035#include "rtc_base/format_macros.h"
36#include "rtc_base/location.h"
37#include "rtc_base/logging.h"
Niels Möller26815232018-11-16 09:32:40 +010038#include "rtc_base/numerics/safe_conversions.h"
Niels Möllerdced9f62018-11-19 10:27:07 +010039#include "rtc_base/race_checker.h"
Niels Möller530ead42018-10-04 14:28:39 +020040#include "rtc_base/rate_limiter.h"
41#include "rtc_base/task_queue.h"
42#include "rtc_base/thread_checker.h"
Steve Anton10542f22019-01-11 09:11:00 -080043#include "rtc_base/time_utils.h"
Sebastian Jansson977b3352019-03-04 17:43:34 +010044#include "system_wrappers/include/clock.h"
Niels Möller530ead42018-10-04 14:28:39 +020045#include "system_wrappers/include/field_trial.h"
46#include "system_wrappers/include/metrics.h"
47
48namespace webrtc {
49namespace voe {
50
51namespace {
52
53constexpr int64_t kMaxRetransmissionWindowMs = 1000;
54constexpr int64_t kMinRetransmissionWindowMs = 30;
55
Bjorn A Mellemda4f0932019-07-30 08:34:03 -070056// Field trial which controls whether to report standard-compliant bytes
57// sent/received per stream. If enabled, padding and headers are not included
58// in bytes sent or received.
59constexpr char kUseStandardBytesStats[] = "WebRTC-UseStandardBytesStats";
60
Niels Möller7d76a312018-10-26 12:57:07 +020061MediaTransportEncodedAudioFrame::FrameType
Niels Möller87e2d782019-03-07 10:18:23 +010062MediaTransportFrameTypeForWebrtcFrameType(webrtc::AudioFrameType frame_type) {
Niels Möller7d76a312018-10-26 12:57:07 +020063 switch (frame_type) {
Niels Möllerc936cb62019-03-19 14:10:16 +010064 case AudioFrameType::kAudioFrameSpeech:
Niels Möller7d76a312018-10-26 12:57:07 +020065 return MediaTransportEncodedAudioFrame::FrameType::kSpeech;
66 break;
67
Niels Möllerc936cb62019-03-19 14:10:16 +010068 case AudioFrameType::kAudioFrameCN:
Niels Möller7d76a312018-10-26 12:57:07 +020069 return MediaTransportEncodedAudioFrame::FrameType::
70 kDiscontinuousTransmission;
71 break;
72
73 default:
Niels Möllerc936cb62019-03-19 14:10:16 +010074 RTC_CHECK(false) << "Unexpected frame type="
75 << static_cast<int>(frame_type);
Niels Möller7d76a312018-10-26 12:57:07 +020076 break;
77 }
78}
79
Niels Möllerdced9f62018-11-19 10:27:07 +010080class RtpPacketSenderProxy;
81class TransportFeedbackProxy;
82class TransportSequenceNumberProxy;
83class VoERtcpObserver;
84
Benjamin Wright17b050f2019-03-13 17:35:46 -070085class ChannelSend : public ChannelSendInterface,
86 public AudioPacketizationCallback, // receive encoded
87 // packets from the ACM
88 public TargetTransferRateObserver {
Niels Möllerdced9f62018-11-19 10:27:07 +010089 public:
90 // TODO(nisse): Make OnUplinkPacketLossRate public, and delete friend
91 // declaration.
92 friend class VoERtcpObserver;
93
Sebastian Jansson977b3352019-03-04 17:43:34 +010094 ChannelSend(Clock* clock,
Sebastian Jansson44dd9f22019-03-08 14:50:30 +010095 TaskQueueFactory* task_queue_factory,
Niels Möllerdced9f62018-11-19 10:27:07 +010096 ProcessThread* module_process_thread,
Anton Sukhanov4f08faa2019-05-21 11:12:57 -070097 const MediaTransportConfig& media_transport_config,
Anton Sukhanov626015d2019-02-04 15:16:06 -080098 OverheadObserver* overhead_observer,
Niels Möllere9771992018-11-26 10:55:07 +010099 Transport* rtp_transport,
Niels Möllerdced9f62018-11-19 10:27:07 +0100100 RtcpRttStats* rtcp_rtt_stats,
101 RtcEventLog* rtc_event_log,
102 FrameEncryptorInterface* frame_encryptor,
103 const webrtc::CryptoOptions& crypto_options,
104 bool extmap_allow_mixed,
Erik Språng4c2c4122019-07-11 15:20:15 +0200105 int rtcp_report_interval_ms,
106 uint32_t ssrc);
Niels Möllerdced9f62018-11-19 10:27:07 +0100107
108 ~ChannelSend() override;
109
110 // Send using this encoder, with this payload type.
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100111 void SetEncoder(int payload_type,
Niels Möllerdced9f62018-11-19 10:27:07 +0100112 std::unique_ptr<AudioEncoder> encoder) override;
113 void ModifyEncoder(rtc::FunctionView<void(std::unique_ptr<AudioEncoder>*)>
114 modifier) override;
Sebastian Jansson14a7cf92019-02-13 15:11:42 +0100115 void CallEncoder(rtc::FunctionView<void(AudioEncoder*)> modifier) override;
Niels Möllerdced9f62018-11-19 10:27:07 +0100116
117 // API methods
Niels Möllerdced9f62018-11-19 10:27:07 +0100118 void StartSend() override;
119 void StopSend() override;
120
121 // Codecs
Sebastian Jansson254d8692018-11-21 19:19:00 +0100122 void OnBitrateAllocation(BitrateAllocationUpdate update) override;
Niels Möllerdced9f62018-11-19 10:27:07 +0100123 int GetBitrate() const override;
124
125 // Network
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100126 void ReceivedRTCPPacket(const uint8_t* data, size_t length) override;
Niels Möllerdced9f62018-11-19 10:27:07 +0100127
128 // Muting, Volume and Level.
129 void SetInputMute(bool enable) override;
130
131 // Stats.
132 ANAStats GetANAStatistics() const override;
133
134 // Used by AudioSendStream.
135 RtpRtcp* GetRtpRtcp() const override;
136
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100137 void RegisterCngPayloadType(int payload_type, int payload_frequency) override;
138
Niels Möllerdced9f62018-11-19 10:27:07 +0100139 // DTMF.
140 bool SendTelephoneEventOutband(int event, int duration_ms) override;
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100141 void SetSendTelephoneEventPayloadType(int payload_type,
Niels Möllerdced9f62018-11-19 10:27:07 +0100142 int payload_frequency) override;
143
144 // RTP+RTCP
Amit Hilbuch77938e62018-12-21 09:23:38 -0800145 void SetRid(const std::string& rid,
146 int extension_id,
147 int repaired_extension_id) override;
Niels Möllerdced9f62018-11-19 10:27:07 +0100148 void SetMid(const std::string& mid, int extension_id) override;
149 void SetExtmapAllowMixed(bool extmap_allow_mixed) override;
150 void SetSendAudioLevelIndicationStatus(bool enable, int id) override;
151 void EnableSendTransportSequenceNumber(int id) override;
152
153 void RegisterSenderCongestionControlObjects(
154 RtpTransportControllerSendInterface* transport,
155 RtcpBandwidthObserver* bandwidth_observer) override;
156 void ResetSenderCongestionControlObjects() override;
157 void SetRTCP_CNAME(absl::string_view c_name) override;
158 std::vector<ReportBlock> GetRemoteRTCPReportBlocks() const override;
159 CallSendStatistics GetRTCPStatistics() const override;
Niels Möllerdced9f62018-11-19 10:27:07 +0100160
161 // ProcessAndEncodeAudio() posts a task on the shared encoder task queue,
162 // which in turn calls (on the queue) ProcessAndEncodeAudioOnTaskQueue() where
163 // the actual processing of the audio takes place. The processing mainly
164 // consists of encoding and preparing the result for sending by adding it to a
165 // send queue.
166 // The main reason for using a task queue here is to release the native,
167 // OS-specific, audio capture thread as soon as possible to ensure that it
168 // can go back to sleep and be prepared to deliver an new captured audio
169 // packet.
170 void ProcessAndEncodeAudio(std::unique_ptr<AudioFrame> audio_frame) override;
171
Niels Möllerdced9f62018-11-19 10:27:07 +0100172 // The existence of this function alongside OnUplinkPacketLossRate is
173 // a compromise. We want the encoder to be agnostic of the PLR source, but
174 // we also don't want it to receive conflicting information from TWCC and
175 // from RTCP-XR.
176 void OnTwccBasedUplinkPacketLossRate(float packet_loss_rate) override;
177
178 void OnRecoverableUplinkPacketLossRate(
179 float recoverable_packet_loss_rate) override;
180
181 int64_t GetRTT() const override;
182
183 // E2EE Custom Audio Frame Encryption
184 void SetFrameEncryptor(
185 rtc::scoped_refptr<FrameEncryptorInterface> frame_encryptor) override;
186
187 private:
Niels Möllerdced9f62018-11-19 10:27:07 +0100188 // From AudioPacketizationCallback in the ACM
Niels Möller87e2d782019-03-07 10:18:23 +0100189 int32_t SendData(AudioFrameType frameType,
Niels Möllerdced9f62018-11-19 10:27:07 +0100190 uint8_t payloadType,
191 uint32_t timeStamp,
192 const uint8_t* payloadData,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200193 size_t payloadSize) override;
Niels Möllerdced9f62018-11-19 10:27:07 +0100194
Niels Möllerdced9f62018-11-19 10:27:07 +0100195 void OnUplinkPacketLossRate(float packet_loss_rate);
196 bool InputMute() const;
197
Niels Möllerdced9f62018-11-19 10:27:07 +0100198 int SetSendRtpHeaderExtension(bool enable, RTPExtensionType type, int id);
199
Niels Möller87e2d782019-03-07 10:18:23 +0100200 int32_t SendRtpAudio(AudioFrameType frameType,
Niels Möllerdced9f62018-11-19 10:27:07 +0100201 uint8_t payloadType,
202 uint32_t timeStamp,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200203 rtc::ArrayView<const uint8_t> payload)
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100204 RTC_RUN_ON(encoder_queue_);
Niels Möllerdced9f62018-11-19 10:27:07 +0100205
Niels Möller87e2d782019-03-07 10:18:23 +0100206 int32_t SendMediaTransportAudio(AudioFrameType frameType,
Niels Möllerdced9f62018-11-19 10:27:07 +0100207 uint8_t payloadType,
208 uint32_t timeStamp,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200209 rtc::ArrayView<const uint8_t> payload)
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100210 RTC_RUN_ON(encoder_queue_);
Niels Möllerdced9f62018-11-19 10:27:07 +0100211
212 // Return media transport or nullptr if using RTP.
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700213 MediaTransportInterface* media_transport() {
214 return media_transport_config_.media_transport;
215 }
Niels Möllerdced9f62018-11-19 10:27:07 +0100216
217 // Called on the encoder task queue when a new input audio frame is ready
218 // for encoding.
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100219 void ProcessAndEncodeAudioOnTaskQueue(AudioFrame* audio_input)
220 RTC_RUN_ON(encoder_queue_);
Niels Möllerdced9f62018-11-19 10:27:07 +0100221
222 void OnReceivedRtt(int64_t rtt_ms);
223
224 void OnTargetTransferRate(TargetTransferRate) override;
225
226 // Thread checkers document and lock usage of some methods on voe::Channel to
227 // specific threads we know about. The goal is to eventually split up
228 // voe::Channel into parts with single-threaded semantics, and thereby reduce
229 // the need for locks.
230 rtc::ThreadChecker worker_thread_checker_;
231 rtc::ThreadChecker module_process_thread_checker_;
232 // Methods accessed from audio and video threads are checked for sequential-
233 // only access. We don't necessarily own and control these threads, so thread
234 // checkers cannot be used. E.g. Chromium may transfer "ownership" from one
235 // audio thread to another, but access is still sequential.
236 rtc::RaceChecker audio_thread_race_checker_;
237
Niels Möllerdced9f62018-11-19 10:27:07 +0100238 rtc::CriticalSection volume_settings_critsect_;
239
Niels Möller26e88b02018-11-19 15:08:13 +0100240 bool sending_ RTC_GUARDED_BY(&worker_thread_checker_) = false;
Niels Möllerdced9f62018-11-19 10:27:07 +0100241
242 RtcEventLog* const event_log_;
243
244 std::unique_ptr<RtpRtcp> _rtpRtcpModule;
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100245 std::unique_ptr<RTPSenderAudio> rtp_sender_audio_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100246
247 std::unique_ptr<AudioCodingModule> audio_coding_;
248 uint32_t _timeStamp RTC_GUARDED_BY(encoder_queue_);
249
Niels Möllerdced9f62018-11-19 10:27:07 +0100250 // uses
Niels Möller985a1f32018-11-19 16:08:42 +0100251 ProcessThread* const _moduleProcessThreadPtr;
Niels Möllerdced9f62018-11-19 10:27:07 +0100252 RmsLevel rms_level_ RTC_GUARDED_BY(encoder_queue_);
253 bool input_mute_ RTC_GUARDED_BY(volume_settings_critsect_);
254 bool previous_frame_muted_ RTC_GUARDED_BY(encoder_queue_);
255 // VoeRTP_RTCP
256 // TODO(henrika): can today be accessed on the main thread and on the
257 // task queue; hence potential race.
258 bool _includeAudioLevelIndication;
Anton Sukhanov626015d2019-02-04 15:16:06 -0800259
Niels Möllerdced9f62018-11-19 10:27:07 +0100260 // RtcpBandwidthObserver
Niels Möller985a1f32018-11-19 16:08:42 +0100261 const std::unique_ptr<VoERtcpObserver> rtcp_observer_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100262
Niels Möller985a1f32018-11-19 16:08:42 +0100263 PacketRouter* packet_router_ RTC_GUARDED_BY(&worker_thread_checker_) =
264 nullptr;
265 const std::unique_ptr<TransportFeedbackProxy> feedback_observer_proxy_;
266 const std::unique_ptr<TransportSequenceNumberProxy> seq_num_allocator_proxy_;
Erik Språng59b86542019-06-23 18:24:46 +0200267 const std::unique_ptr<RtpPacketSenderProxy> rtp_packet_pacer_proxy_;
Niels Möller985a1f32018-11-19 16:08:42 +0100268 const std::unique_ptr<RateLimiter> retransmission_rate_limiter_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100269
270 rtc::ThreadChecker construction_thread_;
271
272 const bool use_twcc_plr_for_ana_;
Bjorn A Mellemda4f0932019-07-30 08:34:03 -0700273 const bool use_standard_bytes_stats_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100274
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100275 bool encoder_queue_is_active_ RTC_GUARDED_BY(encoder_queue_) = false;
Niels Möllerdced9f62018-11-19 10:27:07 +0100276
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700277 MediaTransportConfig media_transport_config_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100278 int media_transport_sequence_number_ RTC_GUARDED_BY(encoder_queue_) = 0;
279
280 rtc::CriticalSection media_transport_lock_;
Erik Språng70efdde2019-08-21 13:36:20 +0200281 // Currently set to local SSRC at construction.
Niels Möllerdced9f62018-11-19 10:27:07 +0100282 uint64_t media_transport_channel_id_ RTC_GUARDED_BY(&media_transport_lock_) =
283 0;
284 // Cache payload type and sampling frequency from most recent call to
285 // SetEncoder. Needed to set MediaTransportEncodedAudioFrame metadata, and
286 // invalidate on encoder change.
287 int media_transport_payload_type_ RTC_GUARDED_BY(&media_transport_lock_);
288 int media_transport_sampling_frequency_
289 RTC_GUARDED_BY(&media_transport_lock_);
290
291 // E2EE Audio Frame Encryption
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100292 rtc::scoped_refptr<FrameEncryptorInterface> frame_encryptor_
293 RTC_GUARDED_BY(encoder_queue_);
Niels Möllerdced9f62018-11-19 10:27:07 +0100294 // E2EE Frame Encryption Options
Niels Möller985a1f32018-11-19 16:08:42 +0100295 const webrtc::CryptoOptions crypto_options_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100296
297 rtc::CriticalSection bitrate_crit_section_;
298 int configured_bitrate_bps_ RTC_GUARDED_BY(bitrate_crit_section_) = 0;
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100299
300 // Defined last to ensure that there are no running tasks when the other
301 // members are destroyed.
302 rtc::TaskQueue encoder_queue_;
Niels Möllerdced9f62018-11-19 10:27:07 +0100303};
Niels Möller530ead42018-10-04 14:28:39 +0200304
305const int kTelephoneEventAttenuationdB = 10;
306
307class TransportFeedbackProxy : public TransportFeedbackObserver {
308 public:
309 TransportFeedbackProxy() : feedback_observer_(nullptr) {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200310 pacer_thread_.Detach();
311 network_thread_.Detach();
Niels Möller530ead42018-10-04 14:28:39 +0200312 }
313
314 void SetTransportFeedbackObserver(
315 TransportFeedbackObserver* feedback_observer) {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200316 RTC_DCHECK(thread_checker_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200317 rtc::CritScope lock(&crit_);
318 feedback_observer_ = feedback_observer;
319 }
320
321 // Implements TransportFeedbackObserver.
Erik Språng30a276b2019-04-23 12:00:11 +0200322 void OnAddPacket(const RtpPacketSendInfo& packet_info) override {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200323 RTC_DCHECK(pacer_thread_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200324 rtc::CritScope lock(&crit_);
325 if (feedback_observer_)
Erik Språng30a276b2019-04-23 12:00:11 +0200326 feedback_observer_->OnAddPacket(packet_info);
Niels Möller530ead42018-10-04 14:28:39 +0200327 }
328
329 void OnTransportFeedback(const rtcp::TransportFeedback& feedback) override {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200330 RTC_DCHECK(network_thread_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200331 rtc::CritScope lock(&crit_);
332 if (feedback_observer_)
333 feedback_observer_->OnTransportFeedback(feedback);
334 }
335
336 private:
337 rtc::CriticalSection crit_;
338 rtc::ThreadChecker thread_checker_;
339 rtc::ThreadChecker pacer_thread_;
340 rtc::ThreadChecker network_thread_;
341 TransportFeedbackObserver* feedback_observer_ RTC_GUARDED_BY(&crit_);
342};
343
344class TransportSequenceNumberProxy : public TransportSequenceNumberAllocator {
345 public:
346 TransportSequenceNumberProxy() : seq_num_allocator_(nullptr) {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200347 pacer_thread_.Detach();
Niels Möller530ead42018-10-04 14:28:39 +0200348 }
349
350 void SetSequenceNumberAllocator(
351 TransportSequenceNumberAllocator* seq_num_allocator) {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200352 RTC_DCHECK(thread_checker_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200353 rtc::CritScope lock(&crit_);
354 seq_num_allocator_ = seq_num_allocator;
355 }
356
357 // Implements TransportSequenceNumberAllocator.
358 uint16_t AllocateSequenceNumber() override {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200359 RTC_DCHECK(pacer_thread_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200360 rtc::CritScope lock(&crit_);
361 if (!seq_num_allocator_)
362 return 0;
363 return seq_num_allocator_->AllocateSequenceNumber();
364 }
365
366 private:
367 rtc::CriticalSection crit_;
368 rtc::ThreadChecker thread_checker_;
369 rtc::ThreadChecker pacer_thread_;
370 TransportSequenceNumberAllocator* seq_num_allocator_ RTC_GUARDED_BY(&crit_);
371};
372
Erik Språngaa59eca2019-07-24 14:52:55 +0200373class RtpPacketSenderProxy : public RtpPacketSender {
Niels Möller530ead42018-10-04 14:28:39 +0200374 public:
Erik Språng59b86542019-06-23 18:24:46 +0200375 RtpPacketSenderProxy() : rtp_packet_pacer_(nullptr) {}
Niels Möller530ead42018-10-04 14:28:39 +0200376
Erik Språngaa59eca2019-07-24 14:52:55 +0200377 void SetPacketPacer(RtpPacketSender* rtp_packet_pacer) {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200378 RTC_DCHECK(thread_checker_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200379 rtc::CritScope lock(&crit_);
Erik Språng59b86542019-06-23 18:24:46 +0200380 rtp_packet_pacer_ = rtp_packet_pacer;
381 }
382
383 void EnqueuePacket(std::unique_ptr<RtpPacketToSend> packet) override {
384 rtc::CritScope lock(&crit_);
385 rtp_packet_pacer_->EnqueuePacket(std::move(packet));
Niels Möller530ead42018-10-04 14:28:39 +0200386 }
387
388 // Implements RtpPacketSender.
389 void InsertPacket(Priority priority,
390 uint32_t ssrc,
391 uint16_t sequence_number,
392 int64_t capture_time_ms,
393 size_t bytes,
394 bool retransmission) override {
395 rtc::CritScope lock(&crit_);
Erik Språng59b86542019-06-23 18:24:46 +0200396 if (rtp_packet_pacer_) {
397 rtp_packet_pacer_->InsertPacket(priority, ssrc, sequence_number,
398 capture_time_ms, bytes, retransmission);
Niels Möller530ead42018-10-04 14:28:39 +0200399 }
400 }
401
Niels Möller530ead42018-10-04 14:28:39 +0200402 private:
403 rtc::ThreadChecker thread_checker_;
404 rtc::CriticalSection crit_;
Erik Språngaa59eca2019-07-24 14:52:55 +0200405 RtpPacketSender* rtp_packet_pacer_ RTC_GUARDED_BY(&crit_);
Niels Möller530ead42018-10-04 14:28:39 +0200406};
407
408class VoERtcpObserver : public RtcpBandwidthObserver {
409 public:
410 explicit VoERtcpObserver(ChannelSend* owner)
411 : owner_(owner), bandwidth_observer_(nullptr) {}
Mirko Bonadeife055c12019-01-29 22:53:28 +0100412 ~VoERtcpObserver() override {}
Niels Möller530ead42018-10-04 14:28:39 +0200413
414 void SetBandwidthObserver(RtcpBandwidthObserver* bandwidth_observer) {
415 rtc::CritScope lock(&crit_);
416 bandwidth_observer_ = bandwidth_observer;
417 }
418
419 void OnReceivedEstimatedBitrate(uint32_t bitrate) override {
420 rtc::CritScope lock(&crit_);
421 if (bandwidth_observer_) {
422 bandwidth_observer_->OnReceivedEstimatedBitrate(bitrate);
423 }
424 }
425
426 void OnReceivedRtcpReceiverReport(const ReportBlockList& report_blocks,
427 int64_t rtt,
428 int64_t now_ms) override {
429 {
430 rtc::CritScope lock(&crit_);
431 if (bandwidth_observer_) {
432 bandwidth_observer_->OnReceivedRtcpReceiverReport(report_blocks, rtt,
433 now_ms);
434 }
435 }
436 // TODO(mflodman): Do we need to aggregate reports here or can we jut send
437 // what we get? I.e. do we ever get multiple reports bundled into one RTCP
438 // report for VoiceEngine?
439 if (report_blocks.empty())
440 return;
441
442 int fraction_lost_aggregate = 0;
443 int total_number_of_packets = 0;
444
445 // If receiving multiple report blocks, calculate the weighted average based
446 // on the number of packets a report refers to.
447 for (ReportBlockList::const_iterator block_it = report_blocks.begin();
448 block_it != report_blocks.end(); ++block_it) {
449 // Find the previous extended high sequence number for this remote SSRC,
450 // to calculate the number of RTP packets this report refers to. Ignore if
451 // we haven't seen this SSRC before.
452 std::map<uint32_t, uint32_t>::iterator seq_num_it =
453 extended_max_sequence_number_.find(block_it->source_ssrc);
454 int number_of_packets = 0;
455 if (seq_num_it != extended_max_sequence_number_.end()) {
456 number_of_packets =
457 block_it->extended_highest_sequence_number - seq_num_it->second;
458 }
459 fraction_lost_aggregate += number_of_packets * block_it->fraction_lost;
460 total_number_of_packets += number_of_packets;
461
462 extended_max_sequence_number_[block_it->source_ssrc] =
463 block_it->extended_highest_sequence_number;
464 }
465 int weighted_fraction_lost = 0;
466 if (total_number_of_packets > 0) {
467 weighted_fraction_lost =
468 (fraction_lost_aggregate + total_number_of_packets / 2) /
469 total_number_of_packets;
470 }
471 owner_->OnUplinkPacketLossRate(weighted_fraction_lost / 255.0f);
472 }
473
474 private:
475 ChannelSend* owner_;
476 // Maps remote side ssrc to extended highest sequence number received.
477 std::map<uint32_t, uint32_t> extended_max_sequence_number_;
478 rtc::CriticalSection crit_;
479 RtcpBandwidthObserver* bandwidth_observer_ RTC_GUARDED_BY(crit_);
480};
481
Niels Möller87e2d782019-03-07 10:18:23 +0100482int32_t ChannelSend::SendData(AudioFrameType frameType,
Niels Möller530ead42018-10-04 14:28:39 +0200483 uint8_t payloadType,
484 uint32_t timeStamp,
485 const uint8_t* payloadData,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200486 size_t payloadSize) {
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100487 RTC_DCHECK_RUN_ON(&encoder_queue_);
Niels Möller7d76a312018-10-26 12:57:07 +0200488 rtc::ArrayView<const uint8_t> payload(payloadData, payloadSize);
489
490 if (media_transport() != nullptr) {
Niels Möllerc936cb62019-03-19 14:10:16 +0100491 if (frameType == AudioFrameType::kEmptyFrame) {
Piotr (Peter) Slatala3cdd4d52019-02-28 07:10:56 -0800492 // TODO(bugs.webrtc.org/9719): Media transport Send doesn't support
493 // sending empty frames.
494 return 0;
495 }
496
Niels Möllerc35b6e62019-04-25 16:31:18 +0200497 return SendMediaTransportAudio(frameType, payloadType, timeStamp, payload);
Niels Möller7d76a312018-10-26 12:57:07 +0200498 } else {
Niels Möllerc35b6e62019-04-25 16:31:18 +0200499 return SendRtpAudio(frameType, payloadType, timeStamp, payload);
Niels Möller7d76a312018-10-26 12:57:07 +0200500 }
501}
502
Niels Möller87e2d782019-03-07 10:18:23 +0100503int32_t ChannelSend::SendRtpAudio(AudioFrameType frameType,
Niels Möller7d76a312018-10-26 12:57:07 +0200504 uint8_t payloadType,
505 uint32_t timeStamp,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200506 rtc::ArrayView<const uint8_t> payload) {
Niels Möller530ead42018-10-04 14:28:39 +0200507 if (_includeAudioLevelIndication) {
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100508 // Store current audio level in the RTP sender.
Niels Möller530ead42018-10-04 14:28:39 +0200509 // The level will be used in combination with voice-activity state
510 // (frameType) to add an RTP header extension
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100511 rtp_sender_audio_->SetAudioLevel(rms_level_.Average());
Niels Möller530ead42018-10-04 14:28:39 +0200512 }
513
Benjamin Wright84583f62018-10-04 14:22:34 -0700514 // E2EE Custom Audio Frame Encryption (This is optional).
515 // Keep this buffer around for the lifetime of the send call.
516 rtc::Buffer encrypted_audio_payload;
Minyue Li9ab520e2019-05-28 13:27:40 +0200517 // We don't invoke encryptor if payload is empty, which means we are to send
518 // DTMF, or the encoder entered DTX.
519 // TODO(minyue): see whether DTMF packets should be encrypted or not. In
520 // current implementation, they are not.
Minyue Lif48bca72019-06-20 23:37:02 +0200521 if (!payload.empty()) {
522 if (frame_encryptor_ != nullptr) {
523 // TODO(benwright@webrtc.org) - Allocate enough to always encrypt inline.
524 // Allocate a buffer to hold the maximum possible encrypted payload.
525 size_t max_ciphertext_size = frame_encryptor_->GetMaxCiphertextByteSize(
526 cricket::MEDIA_TYPE_AUDIO, payload.size());
527 encrypted_audio_payload.SetSize(max_ciphertext_size);
Benjamin Wright84583f62018-10-04 14:22:34 -0700528
Minyue Lif48bca72019-06-20 23:37:02 +0200529 // Encrypt the audio payload into the buffer.
530 size_t bytes_written = 0;
531 int encrypt_status = frame_encryptor_->Encrypt(
532 cricket::MEDIA_TYPE_AUDIO, _rtpRtcpModule->SSRC(),
533 /*additional_data=*/nullptr, payload, encrypted_audio_payload,
534 &bytes_written);
535 if (encrypt_status != 0) {
536 RTC_DLOG(LS_ERROR)
537 << "Channel::SendData() failed encrypt audio payload: "
538 << encrypt_status;
539 return -1;
540 }
541 // Resize the buffer to the exact number of bytes actually used.
542 encrypted_audio_payload.SetSize(bytes_written);
543 // Rewrite the payloadData and size to the new encrypted payload.
544 payload = encrypted_audio_payload;
545 } else if (crypto_options_.sframe.require_frame_encryption) {
546 RTC_DLOG(LS_ERROR) << "Channel::SendData() failed sending audio payload: "
547 << "A frame encryptor is required but one is not set.";
Benjamin Wright84583f62018-10-04 14:22:34 -0700548 return -1;
549 }
Benjamin Wright84583f62018-10-04 14:22:34 -0700550 }
551
Niels Möller530ead42018-10-04 14:28:39 +0200552 // Push data from ACM to RTP/RTCP-module to deliver audio frame for
553 // packetization.
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100554 if (!_rtpRtcpModule->OnSendingRtpFrame(timeStamp,
555 // Leaving the time when this frame was
556 // received from the capture device as
557 // undefined for voice for now.
558 -1, payloadType,
559 /*force_sender_report=*/false)) {
560 return false;
561 }
562
563 // RTCPSender has it's own copy of the timestamp offset, added in
564 // RTCPSender::BuildSR, hence we must not add the in the offset for the above
565 // call.
566 // TODO(nisse): Delete RTCPSender:timestamp_offset_, and see if we can confine
567 // knowledge of the offset to a single place.
568 const uint32_t rtp_timestamp = timeStamp + _rtpRtcpModule->StartTimestamp();
Niels Möller530ead42018-10-04 14:28:39 +0200569 // This call will trigger Transport::SendPacket() from the RTP/RTCP module.
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100570 if (!rtp_sender_audio_->SendAudio(frameType, payloadType, rtp_timestamp,
571 payload.data(), payload.size())) {
Niels Möller530ead42018-10-04 14:28:39 +0200572 RTC_DLOG(LS_ERROR)
573 << "ChannelSend::SendData() failed to send data to RTP/RTCP module";
574 return -1;
575 }
576
577 return 0;
578}
579
Niels Möller7d76a312018-10-26 12:57:07 +0200580int32_t ChannelSend::SendMediaTransportAudio(
Niels Möller87e2d782019-03-07 10:18:23 +0100581 AudioFrameType frameType,
Niels Möller7d76a312018-10-26 12:57:07 +0200582 uint8_t payloadType,
583 uint32_t timeStamp,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200584 rtc::ArrayView<const uint8_t> payload) {
Niels Möller7d76a312018-10-26 12:57:07 +0200585 // TODO(nisse): Use null _transportPtr for MediaTransport.
586 // RTC_DCHECK(_transportPtr == nullptr);
587 uint64_t channel_id;
588 int sampling_rate_hz;
589 {
590 rtc::CritScope cs(&media_transport_lock_);
591 if (media_transport_payload_type_ != payloadType) {
592 // Payload type is being changed, media_transport_sampling_frequency_,
593 // no longer current.
594 return -1;
595 }
596 sampling_rate_hz = media_transport_sampling_frequency_;
597 channel_id = media_transport_channel_id_;
598 }
Mirko Bonadei1c546052019-02-04 14:50:38 +0100599 MediaTransportEncodedAudioFrame frame(
Niels Möller7d76a312018-10-26 12:57:07 +0200600 /*sampling_rate_hz=*/sampling_rate_hz,
601
602 // TODO(nisse): Timestamp and sample index are the same for all supported
603 // audio codecs except G722. Refactor audio coding module to only use
604 // sample index, and leave translation to RTP time, when needed, for
605 // RTP-specific code.
606 /*starting_sample_index=*/timeStamp,
607
608 // Sample count isn't conveniently available from the AudioCodingModule,
609 // and needs some refactoring to wire up in a good way. For now, left as
610 // zero.
Benjamin Wright17b050f2019-03-13 17:35:46 -0700611 /*samples_per_channel=*/0,
Niels Möller7d76a312018-10-26 12:57:07 +0200612
613 /*sequence_number=*/media_transport_sequence_number_,
614 MediaTransportFrameTypeForWebrtcFrameType(frameType), payloadType,
615 std::vector<uint8_t>(payload.begin(), payload.end()));
616
617 // TODO(nisse): Introduce a MediaTransportSender object bound to a specific
618 // channel id.
619 RTCError rtc_error =
620 media_transport()->SendAudioFrame(channel_id, std::move(frame));
621
622 if (!rtc_error.ok()) {
623 RTC_LOG(LS_ERROR) << "Failed to send frame, rtc_error="
624 << ToString(rtc_error.type()) << ", "
625 << rtc_error.message();
626 return -1;
627 }
628
629 ++media_transport_sequence_number_;
630
631 return 0;
632}
633
Sebastian Jansson977b3352019-03-04 17:43:34 +0100634ChannelSend::ChannelSend(Clock* clock,
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100635 TaskQueueFactory* task_queue_factory,
Niels Möller530ead42018-10-04 14:28:39 +0200636 ProcessThread* module_process_thread,
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700637 const MediaTransportConfig& media_transport_config,
Anton Sukhanov626015d2019-02-04 15:16:06 -0800638 OverheadObserver* overhead_observer,
Niels Möllere9771992018-11-26 10:55:07 +0100639 Transport* rtp_transport,
Niels Möller530ead42018-10-04 14:28:39 +0200640 RtcpRttStats* rtcp_rtt_stats,
Benjamin Wright84583f62018-10-04 14:22:34 -0700641 RtcEventLog* rtc_event_log,
Benjamin Wrightbfb444c2018-10-15 10:20:24 -0700642 FrameEncryptorInterface* frame_encryptor,
Johannes Kron9190b822018-10-29 11:22:05 +0100643 const webrtc::CryptoOptions& crypto_options,
Jiawei Ou55718122018-11-09 13:17:39 -0800644 bool extmap_allow_mixed,
Erik Språng4c2c4122019-07-11 15:20:15 +0200645 int rtcp_report_interval_ms,
646 uint32_t ssrc)
Niels Möller530ead42018-10-04 14:28:39 +0200647 : event_log_(rtc_event_log),
648 _timeStamp(0), // This is just an offset, RTP module will add it's own
649 // random offset
Niels Möller530ead42018-10-04 14:28:39 +0200650 _moduleProcessThreadPtr(module_process_thread),
Niels Möller530ead42018-10-04 14:28:39 +0200651 input_mute_(false),
652 previous_frame_muted_(false),
653 _includeAudioLevelIndication(false),
Niels Möller530ead42018-10-04 14:28:39 +0200654 rtcp_observer_(new VoERtcpObserver(this)),
655 feedback_observer_proxy_(new TransportFeedbackProxy()),
656 seq_num_allocator_proxy_(new TransportSequenceNumberProxy()),
Erik Språng59b86542019-06-23 18:24:46 +0200657 rtp_packet_pacer_proxy_(new RtpPacketSenderProxy()),
Sebastian Jansson977b3352019-03-04 17:43:34 +0100658 retransmission_rate_limiter_(
659 new RateLimiter(clock, kMaxRetransmissionWindowMs)),
Niels Möller530ead42018-10-04 14:28:39 +0200660 use_twcc_plr_for_ana_(
661 webrtc::field_trial::FindFullName("UseTwccPlrForAna") == "Enabled"),
Bjorn A Mellemda4f0932019-07-30 08:34:03 -0700662 use_standard_bytes_stats_(
663 webrtc::field_trial::IsEnabled(kUseStandardBytesStats)),
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700664 media_transport_config_(media_transport_config),
Benjamin Wrightbfb444c2018-10-15 10:20:24 -0700665 frame_encryptor_(frame_encryptor),
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100666 crypto_options_(crypto_options),
667 encoder_queue_(task_queue_factory->CreateTaskQueue(
668 "AudioEncoder",
669 TaskQueueFactory::Priority::NORMAL)) {
Niels Möller530ead42018-10-04 14:28:39 +0200670 RTC_DCHECK(module_process_thread);
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200671 module_process_thread_checker_.Detach();
Niels Möllerdced9f62018-11-19 10:27:07 +0100672
Niels Möller530ead42018-10-04 14:28:39 +0200673 audio_coding_.reset(AudioCodingModule::Create(AudioCodingModule::Config()));
674
675 RtpRtcp::Configuration configuration;
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800676
677 // We gradually remove codepaths that depend on RTP when using media
678 // transport. All of this logic should be moved to the future
679 // RTPMediaTransport. In this case it means that overhead and bandwidth
680 // observers should not be called when using media transport.
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700681 if (!media_transport_config.media_transport) {
Anton Sukhanov626015d2019-02-04 15:16:06 -0800682 configuration.overhead_observer = overhead_observer;
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800683 configuration.bandwidth_callback = rtcp_observer_.get();
684 configuration.transport_feedback_callback = feedback_observer_proxy_.get();
685 }
686
Sebastian Jansson977b3352019-03-04 17:43:34 +0100687 configuration.clock = clock;
Niels Möller530ead42018-10-04 14:28:39 +0200688 configuration.audio = true;
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100689 configuration.clock = Clock::GetRealTimeClock();
Fredrik Solenberg3d2ed192018-12-18 09:18:33 +0100690 configuration.outgoing_transport = rtp_transport;
Niels Möller530ead42018-10-04 14:28:39 +0200691
Erik Språng59b86542019-06-23 18:24:46 +0200692 configuration.paced_sender = rtp_packet_pacer_proxy_.get();
Niels Möller530ead42018-10-04 14:28:39 +0200693 configuration.transport_sequence_number_allocator =
694 seq_num_allocator_proxy_.get();
Niels Möller530ead42018-10-04 14:28:39 +0200695
696 configuration.event_log = event_log_;
697 configuration.rtt_stats = rtcp_rtt_stats;
698 configuration.retransmission_rate_limiter =
699 retransmission_rate_limiter_.get();
Johannes Kron9190b822018-10-29 11:22:05 +0100700 configuration.extmap_allow_mixed = extmap_allow_mixed;
Jiawei Ou8b5d9d82018-11-15 16:44:37 -0800701 configuration.rtcp_report_interval_ms = rtcp_report_interval_ms;
Niels Möller530ead42018-10-04 14:28:39 +0200702
Erik Språng54d5d2c2019-08-20 17:22:36 +0200703 configuration.local_media_ssrc = ssrc;
Erik Språng70efdde2019-08-21 13:36:20 +0200704 if (media_transport_config_.media_transport) {
705 rtc::CritScope cs(&media_transport_lock_);
706 media_transport_channel_id_ = ssrc;
707 }
Erik Språng4c2c4122019-07-11 15:20:15 +0200708
Danil Chapovalovc44f6cc2019-03-06 11:31:09 +0100709 _rtpRtcpModule = RtpRtcp::Create(configuration);
Niels Möller530ead42018-10-04 14:28:39 +0200710 _rtpRtcpModule->SetSendingMediaStatus(false);
Niels Möller530ead42018-10-04 14:28:39 +0200711
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100712 rtp_sender_audio_ = absl::make_unique<RTPSenderAudio>(
713 configuration.clock, _rtpRtcpModule->RtpSender());
714
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800715 // We want to invoke the 'TargetRateObserver' and |OnOverheadChanged|
716 // callbacks after the audio_coding_ is fully initialized.
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700717 if (media_transport_config.media_transport) {
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800718 RTC_DLOG(LS_INFO) << "Setting media_transport_ rate observers.";
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700719 media_transport_config.media_transport->AddTargetTransferRateObserver(this);
720 media_transport_config.media_transport->SetAudioOverheadObserver(
721 overhead_observer);
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800722 } else {
723 RTC_DLOG(LS_INFO) << "Not setting media_transport_ rate observers.";
724 }
725
Niels Möller530ead42018-10-04 14:28:39 +0200726 _moduleProcessThreadPtr->RegisterModule(_rtpRtcpModule.get(), RTC_FROM_HERE);
727
Niels Möller530ead42018-10-04 14:28:39 +0200728 // Ensure that RTCP is enabled by default for the created channel.
729 // Note that, the module will keep generating RTCP until it is explicitly
730 // disabled by the user.
731 // After StopListen (when no sockets exists), RTCP packets will no longer
732 // be transmitted since the Transport object will then be invalid.
733 // RTCP is enabled by default.
734 _rtpRtcpModule->SetRTCPStatus(RtcpMode::kCompound);
735
Fredrik Solenbergeb134842018-11-19 14:13:15 +0100736 int error = audio_coding_->RegisterTransportCallback(this);
Niels Möller530ead42018-10-04 14:28:39 +0200737 RTC_DCHECK_EQ(0, error);
738}
739
Fredrik Solenberg645a3af2018-11-16 12:51:15 +0100740ChannelSend::~ChannelSend() {
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200741 RTC_DCHECK(construction_thread_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +0200742
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700743 if (media_transport_config_.media_transport) {
744 media_transport_config_.media_transport->RemoveTargetTransferRateObserver(
745 this);
746 media_transport_config_.media_transport->SetAudioOverheadObserver(nullptr);
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800747 }
748
Niels Möller530ead42018-10-04 14:28:39 +0200749 StopSend();
Niels Möller530ead42018-10-04 14:28:39 +0200750 int error = audio_coding_->RegisterTransportCallback(NULL);
751 RTC_DCHECK_EQ(0, error);
752
Niels Möller530ead42018-10-04 14:28:39 +0200753 if (_moduleProcessThreadPtr)
754 _moduleProcessThreadPtr->DeRegisterModule(_rtpRtcpModule.get());
Niels Möller530ead42018-10-04 14:28:39 +0200755}
756
Niels Möller26815232018-11-16 09:32:40 +0100757void ChannelSend::StartSend() {
Niels Möller26e88b02018-11-19 15:08:13 +0100758 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Fredrik Solenbergeb134842018-11-19 14:13:15 +0100759 RTC_DCHECK(!sending_);
760 sending_ = true;
Niels Möller530ead42018-10-04 14:28:39 +0200761
Niels Möller530ead42018-10-04 14:28:39 +0200762 _rtpRtcpModule->SetSendingMediaStatus(true);
Niels Möller26815232018-11-16 09:32:40 +0100763 int ret = _rtpRtcpModule->SetSendingStatus(true);
764 RTC_DCHECK_EQ(0, ret);
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100765 // It is now OK to start processing on the encoder task queue.
766 encoder_queue_.PostTask([this] {
767 RTC_DCHECK_RUN_ON(&encoder_queue_);
Niels Möller530ead42018-10-04 14:28:39 +0200768 encoder_queue_is_active_ = true;
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100769 });
Niels Möller530ead42018-10-04 14:28:39 +0200770}
771
772void ChannelSend::StopSend() {
Niels Möller26e88b02018-11-19 15:08:13 +0100773 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Fredrik Solenbergeb134842018-11-19 14:13:15 +0100774 if (!sending_) {
Niels Möller530ead42018-10-04 14:28:39 +0200775 return;
776 }
Fredrik Solenbergeb134842018-11-19 14:13:15 +0100777 sending_ = false;
Niels Möller530ead42018-10-04 14:28:39 +0200778
Niels Möllerc572ff32018-11-07 08:43:50 +0100779 rtc::Event flush;
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100780 encoder_queue_.PostTask([this, &flush]() {
781 RTC_DCHECK_RUN_ON(&encoder_queue_);
Niels Möller530ead42018-10-04 14:28:39 +0200782 encoder_queue_is_active_ = false;
Sebastian Jansson44dd9f22019-03-08 14:50:30 +0100783 flush.Set();
784 });
Niels Möller530ead42018-10-04 14:28:39 +0200785 flush.Wait(rtc::Event::kForever);
786
Niels Möller530ead42018-10-04 14:28:39 +0200787 // Reset sending SSRC and sequence number and triggers direct transmission
788 // of RTCP BYE
789 if (_rtpRtcpModule->SetSendingStatus(false) == -1) {
790 RTC_DLOG(LS_ERROR) << "StartSend() RTP/RTCP failed to stop sending";
791 }
792 _rtpRtcpModule->SetSendingMediaStatus(false);
793}
794
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100795void ChannelSend::SetEncoder(int payload_type,
Niels Möller530ead42018-10-04 14:28:39 +0200796 std::unique_ptr<AudioEncoder> encoder) {
Niels Möller26e88b02018-11-19 15:08:13 +0100797 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200798 RTC_DCHECK_GE(payload_type, 0);
799 RTC_DCHECK_LE(payload_type, 127);
Niels Möller530ead42018-10-04 14:28:39 +0200800
801 // The RTP/RTCP module needs to know the RTP timestamp rate (i.e. clockrate)
802 // as well as some other things, so we collect this info and send it along.
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100803 _rtpRtcpModule->RegisterSendPayloadFrequency(payload_type,
804 encoder->RtpTimestampRateHz());
805 rtp_sender_audio_->RegisterAudioPayload("audio", payload_type,
806 encoder->RtpTimestampRateHz(),
807 encoder->NumChannels(), 0);
Niels Möller530ead42018-10-04 14:28:39 +0200808
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700809 if (media_transport_config_.media_transport) {
Niels Möller7d76a312018-10-26 12:57:07 +0200810 rtc::CritScope cs(&media_transport_lock_);
811 media_transport_payload_type_ = payload_type;
812 // TODO(nisse): Currently broken for G722, since timestamps passed through
813 // encoder use RTP clock rather than sample count, and they differ for G722.
814 media_transport_sampling_frequency_ = encoder->RtpTimestampRateHz();
815 }
Niels Möller530ead42018-10-04 14:28:39 +0200816 audio_coding_->SetEncoder(std::move(encoder));
Niels Möller530ead42018-10-04 14:28:39 +0200817}
818
819void ChannelSend::ModifyEncoder(
820 rtc::FunctionView<void(std::unique_ptr<AudioEncoder>*)> modifier) {
Anton Sukhanov626015d2019-02-04 15:16:06 -0800821 // This method can be called on the worker thread, module process thread
822 // or network thread. Audio coding is thread safe, so we do not need to
823 // enforce the calling thread.
Niels Möller530ead42018-10-04 14:28:39 +0200824 audio_coding_->ModifyEncoder(modifier);
825}
826
Sebastian Jansson14a7cf92019-02-13 15:11:42 +0100827void ChannelSend::CallEncoder(rtc::FunctionView<void(AudioEncoder*)> modifier) {
828 ModifyEncoder([modifier](std::unique_ptr<AudioEncoder>* encoder_ptr) {
829 if (*encoder_ptr) {
830 modifier(encoder_ptr->get());
831 } else {
832 RTC_DLOG(LS_WARNING) << "Trying to call unset encoder.";
833 }
834 });
835}
836
Sebastian Jansson254d8692018-11-21 19:19:00 +0100837void ChannelSend::OnBitrateAllocation(BitrateAllocationUpdate update) {
Niels Möllerdced9f62018-11-19 10:27:07 +0100838 // This method can be called on the worker thread, module process thread
839 // or on a TaskQueue via VideoSendStreamImpl::OnEncoderConfigurationChanged.
840 // TODO(solenberg): Figure out a good way to check this or enforce calling
841 // rules.
Sebastian Janssonc01367d2019-04-08 15:20:44 +0200842 // RTC_DCHECK(worker_thread_checker_.IsCurrent() ||
843 // module_process_thread_checker_.IsCurrent());
Piotr (Peter) Slatala1eebec92018-11-16 09:03:35 -0800844 rtc::CritScope lock(&bitrate_crit_section_);
Niels Möllerdced9f62018-11-19 10:27:07 +0100845
Sebastian Jansson14a7cf92019-02-13 15:11:42 +0100846 CallEncoder([&](AudioEncoder* encoder) {
847 encoder->OnReceivedUplinkAllocation(update);
Niels Möller530ead42018-10-04 14:28:39 +0200848 });
Sebastian Jansson254d8692018-11-21 19:19:00 +0100849 retransmission_rate_limiter_->SetMaxRate(update.target_bitrate.bps());
850 configured_bitrate_bps_ = update.target_bitrate.bps();
Sebastian Jansson359d60a2018-10-25 16:22:02 +0200851}
852
Niels Möllerdced9f62018-11-19 10:27:07 +0100853int ChannelSend::GetBitrate() const {
Piotr (Peter) Slatala1eebec92018-11-16 09:03:35 -0800854 rtc::CritScope lock(&bitrate_crit_section_);
Sebastian Jansson359d60a2018-10-25 16:22:02 +0200855 return configured_bitrate_bps_;
Niels Möller530ead42018-10-04 14:28:39 +0200856}
857
858void ChannelSend::OnTwccBasedUplinkPacketLossRate(float packet_loss_rate) {
Niels Möller26e88b02018-11-19 15:08:13 +0100859 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200860 if (!use_twcc_plr_for_ana_)
861 return;
Sebastian Jansson14a7cf92019-02-13 15:11:42 +0100862 CallEncoder([&](AudioEncoder* encoder) {
863 encoder->OnReceivedUplinkPacketLossFraction(packet_loss_rate);
Niels Möller530ead42018-10-04 14:28:39 +0200864 });
865}
866
867void ChannelSend::OnRecoverableUplinkPacketLossRate(
868 float recoverable_packet_loss_rate) {
Niels Möller26e88b02018-11-19 15:08:13 +0100869 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Sebastian Jansson14a7cf92019-02-13 15:11:42 +0100870 CallEncoder([&](AudioEncoder* encoder) {
871 encoder->OnReceivedUplinkRecoverablePacketLossFraction(
872 recoverable_packet_loss_rate);
Niels Möller530ead42018-10-04 14:28:39 +0200873 });
874}
875
876void ChannelSend::OnUplinkPacketLossRate(float packet_loss_rate) {
877 if (use_twcc_plr_for_ana_)
878 return;
Sebastian Jansson14a7cf92019-02-13 15:11:42 +0100879 CallEncoder([&](AudioEncoder* encoder) {
880 encoder->OnReceivedUplinkPacketLossFraction(packet_loss_rate);
Niels Möller530ead42018-10-04 14:28:39 +0200881 });
882}
883
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100884void ChannelSend::ReceivedRTCPPacket(const uint8_t* data, size_t length) {
Niels Möllerdced9f62018-11-19 10:27:07 +0100885 // May be called on either worker thread or network thread.
Anton Sukhanov4f08faa2019-05-21 11:12:57 -0700886 if (media_transport_config_.media_transport) {
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800887 // Ignore RTCP packets while media transport is used.
888 // Those packets should not arrive, but we are seeing occasional packets.
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100889 return;
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800890 }
891
Niels Möller530ead42018-10-04 14:28:39 +0200892 // Deliver RTCP packet to RTP/RTCP module for parsing
893 _rtpRtcpModule->IncomingRtcpPacket(data, length);
894
895 int64_t rtt = GetRTT();
896 if (rtt == 0) {
897 // Waiting for valid RTT.
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100898 return;
Niels Möller530ead42018-10-04 14:28:39 +0200899 }
900
901 int64_t nack_window_ms = rtt;
902 if (nack_window_ms < kMinRetransmissionWindowMs) {
903 nack_window_ms = kMinRetransmissionWindowMs;
904 } else if (nack_window_ms > kMaxRetransmissionWindowMs) {
905 nack_window_ms = kMaxRetransmissionWindowMs;
906 }
907 retransmission_rate_limiter_->SetWindowSize(nack_window_ms);
908
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -0800909 OnReceivedRtt(rtt);
Niels Möller530ead42018-10-04 14:28:39 +0200910}
911
912void ChannelSend::SetInputMute(bool enable) {
Niels Möller26e88b02018-11-19 15:08:13 +0100913 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200914 rtc::CritScope cs(&volume_settings_critsect_);
915 input_mute_ = enable;
916}
917
918bool ChannelSend::InputMute() const {
919 rtc::CritScope cs(&volume_settings_critsect_);
920 return input_mute_;
921}
922
Niels Möller26815232018-11-16 09:32:40 +0100923bool ChannelSend::SendTelephoneEventOutband(int event, int duration_ms) {
Niels Möller26e88b02018-11-19 15:08:13 +0100924 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200925 RTC_DCHECK_LE(0, event);
926 RTC_DCHECK_GE(255, event);
927 RTC_DCHECK_LE(0, duration_ms);
928 RTC_DCHECK_GE(65535, duration_ms);
Fredrik Solenbergeb134842018-11-19 14:13:15 +0100929 if (!sending_) {
Niels Möller26815232018-11-16 09:32:40 +0100930 return false;
Niels Möller530ead42018-10-04 14:28:39 +0200931 }
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100932 if (rtp_sender_audio_->SendTelephoneEvent(
Niels Möller530ead42018-10-04 14:28:39 +0200933 event, duration_ms, kTelephoneEventAttenuationdB) != 0) {
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100934 RTC_DLOG(LS_ERROR) << "SendTelephoneEvent() failed to send event";
Niels Möller26815232018-11-16 09:32:40 +0100935 return false;
Niels Möller530ead42018-10-04 14:28:39 +0200936 }
Niels Möller26815232018-11-16 09:32:40 +0100937 return true;
Niels Möller530ead42018-10-04 14:28:39 +0200938}
939
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100940void ChannelSend::RegisterCngPayloadType(int payload_type,
941 int payload_frequency) {
942 _rtpRtcpModule->RegisterSendPayloadFrequency(payload_type, payload_frequency);
943 rtp_sender_audio_->RegisterAudioPayload("CN", payload_type, payload_frequency,
944 1, 0);
945}
946
Niels Möller8fb1a6a2019-03-05 14:29:42 +0100947void ChannelSend::SetSendTelephoneEventPayloadType(int payload_type,
Niels Möller26815232018-11-16 09:32:40 +0100948 int payload_frequency) {
Niels Möller26e88b02018-11-19 15:08:13 +0100949 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200950 RTC_DCHECK_LE(0, payload_type);
951 RTC_DCHECK_GE(127, payload_type);
Niels Mölleree5ccbc2019-03-06 16:47:29 +0100952 _rtpRtcpModule->RegisterSendPayloadFrequency(payload_type, payload_frequency);
953 rtp_sender_audio_->RegisterAudioPayload("telephone-event", payload_type,
954 payload_frequency, 0, 0);
Niels Möller530ead42018-10-04 14:28:39 +0200955}
956
Amit Hilbuch77938e62018-12-21 09:23:38 -0800957void ChannelSend::SetRid(const std::string& rid,
958 int extension_id,
959 int repaired_extension_id) {
960 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
961 if (extension_id != 0) {
962 int ret = SetSendRtpHeaderExtension(!rid.empty(), kRtpExtensionRtpStreamId,
963 extension_id);
964 RTC_DCHECK_EQ(0, ret);
965 }
966 if (repaired_extension_id != 0) {
967 int ret = SetSendRtpHeaderExtension(!rid.empty(), kRtpExtensionRtpStreamId,
968 repaired_extension_id);
969 RTC_DCHECK_EQ(0, ret);
970 }
971 _rtpRtcpModule->SetRid(rid);
972}
973
Niels Möller530ead42018-10-04 14:28:39 +0200974void ChannelSend::SetMid(const std::string& mid, int extension_id) {
Niels Möller26e88b02018-11-19 15:08:13 +0100975 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200976 int ret = SetSendRtpHeaderExtension(true, kRtpExtensionMid, extension_id);
977 RTC_DCHECK_EQ(0, ret);
978 _rtpRtcpModule->SetMid(mid);
979}
980
Johannes Kron9190b822018-10-29 11:22:05 +0100981void ChannelSend::SetExtmapAllowMixed(bool extmap_allow_mixed) {
Niels Möller26e88b02018-11-19 15:08:13 +0100982 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Johannes Kron9190b822018-10-29 11:22:05 +0100983 _rtpRtcpModule->SetExtmapAllowMixed(extmap_allow_mixed);
984}
985
Niels Möller26815232018-11-16 09:32:40 +0100986void ChannelSend::SetSendAudioLevelIndicationStatus(bool enable, int id) {
Niels Möller26e88b02018-11-19 15:08:13 +0100987 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200988 _includeAudioLevelIndication = enable;
Niels Möller26815232018-11-16 09:32:40 +0100989 int ret = SetSendRtpHeaderExtension(enable, kRtpExtensionAudioLevel, id);
990 RTC_DCHECK_EQ(0, ret);
Niels Möller530ead42018-10-04 14:28:39 +0200991}
992
993void ChannelSend::EnableSendTransportSequenceNumber(int id) {
Niels Möller26e88b02018-11-19 15:08:13 +0100994 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +0200995 int ret =
996 SetSendRtpHeaderExtension(true, kRtpExtensionTransportSequenceNumber, id);
997 RTC_DCHECK_EQ(0, ret);
998}
999
1000void ChannelSend::RegisterSenderCongestionControlObjects(
1001 RtpTransportControllerSendInterface* transport,
1002 RtcpBandwidthObserver* bandwidth_observer) {
Niels Möller26e88b02018-11-19 15:08:13 +01001003 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Erik Språngaa59eca2019-07-24 14:52:55 +02001004 RtpPacketSender* rtp_packet_pacer = transport->packet_sender();
Niels Möller530ead42018-10-04 14:28:39 +02001005 TransportFeedbackObserver* transport_feedback_observer =
1006 transport->transport_feedback_observer();
1007 PacketRouter* packet_router = transport->packet_router();
1008
Erik Språng59b86542019-06-23 18:24:46 +02001009 RTC_DCHECK(rtp_packet_pacer);
Niels Möller530ead42018-10-04 14:28:39 +02001010 RTC_DCHECK(transport_feedback_observer);
1011 RTC_DCHECK(packet_router);
1012 RTC_DCHECK(!packet_router_);
1013 rtcp_observer_->SetBandwidthObserver(bandwidth_observer);
1014 feedback_observer_proxy_->SetTransportFeedbackObserver(
1015 transport_feedback_observer);
1016 seq_num_allocator_proxy_->SetSequenceNumberAllocator(packet_router);
Erik Språng59b86542019-06-23 18:24:46 +02001017 rtp_packet_pacer_proxy_->SetPacketPacer(rtp_packet_pacer);
Niels Möller530ead42018-10-04 14:28:39 +02001018 _rtpRtcpModule->SetStorePacketsStatus(true, 600);
1019 constexpr bool remb_candidate = false;
1020 packet_router->AddSendRtpModule(_rtpRtcpModule.get(), remb_candidate);
1021 packet_router_ = packet_router;
1022}
1023
1024void ChannelSend::ResetSenderCongestionControlObjects() {
Niels Möller26e88b02018-11-19 15:08:13 +01001025 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +02001026 RTC_DCHECK(packet_router_);
1027 _rtpRtcpModule->SetStorePacketsStatus(false, 600);
1028 rtcp_observer_->SetBandwidthObserver(nullptr);
1029 feedback_observer_proxy_->SetTransportFeedbackObserver(nullptr);
1030 seq_num_allocator_proxy_->SetSequenceNumberAllocator(nullptr);
1031 packet_router_->RemoveSendRtpModule(_rtpRtcpModule.get());
1032 packet_router_ = nullptr;
Erik Språng59b86542019-06-23 18:24:46 +02001033 rtp_packet_pacer_proxy_->SetPacketPacer(nullptr);
Niels Möller530ead42018-10-04 14:28:39 +02001034}
1035
Niels Möller26815232018-11-16 09:32:40 +01001036void ChannelSend::SetRTCP_CNAME(absl::string_view c_name) {
Niels Möller26e88b02018-11-19 15:08:13 +01001037 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller26815232018-11-16 09:32:40 +01001038 // Note: SetCNAME() accepts a c string of length at most 255.
1039 const std::string c_name_limited(c_name.substr(0, 255));
1040 int ret = _rtpRtcpModule->SetCNAME(c_name_limited.c_str()) != 0;
1041 RTC_DCHECK_EQ(0, ret) << "SetRTCP_CNAME() failed to set RTCP CNAME";
Niels Möller530ead42018-10-04 14:28:39 +02001042}
1043
Niels Möller26815232018-11-16 09:32:40 +01001044std::vector<ReportBlock> ChannelSend::GetRemoteRTCPReportBlocks() const {
Niels Möller26e88b02018-11-19 15:08:13 +01001045 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +02001046 // Get the report blocks from the latest received RTCP Sender or Receiver
1047 // Report. Each element in the vector contains the sender's SSRC and a
1048 // report block according to RFC 3550.
1049 std::vector<RTCPReportBlock> rtcp_report_blocks;
Niels Möller530ead42018-10-04 14:28:39 +02001050
Niels Möller26815232018-11-16 09:32:40 +01001051 int ret = _rtpRtcpModule->RemoteRTCPStat(&rtcp_report_blocks);
1052 RTC_DCHECK_EQ(0, ret);
1053
1054 std::vector<ReportBlock> report_blocks;
Niels Möller530ead42018-10-04 14:28:39 +02001055
1056 std::vector<RTCPReportBlock>::const_iterator it = rtcp_report_blocks.begin();
1057 for (; it != rtcp_report_blocks.end(); ++it) {
1058 ReportBlock report_block;
1059 report_block.sender_SSRC = it->sender_ssrc;
1060 report_block.source_SSRC = it->source_ssrc;
1061 report_block.fraction_lost = it->fraction_lost;
1062 report_block.cumulative_num_packets_lost = it->packets_lost;
1063 report_block.extended_highest_sequence_number =
1064 it->extended_highest_sequence_number;
1065 report_block.interarrival_jitter = it->jitter;
1066 report_block.last_SR_timestamp = it->last_sender_report_timestamp;
1067 report_block.delay_since_last_SR = it->delay_since_last_sender_report;
Niels Möller26815232018-11-16 09:32:40 +01001068 report_blocks.push_back(report_block);
Niels Möller530ead42018-10-04 14:28:39 +02001069 }
Niels Möller26815232018-11-16 09:32:40 +01001070 return report_blocks;
Niels Möller530ead42018-10-04 14:28:39 +02001071}
1072
Niels Möller26815232018-11-16 09:32:40 +01001073CallSendStatistics ChannelSend::GetRTCPStatistics() const {
Niels Möller26e88b02018-11-19 15:08:13 +01001074 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller26815232018-11-16 09:32:40 +01001075 CallSendStatistics stats = {0};
Niels Möller530ead42018-10-04 14:28:39 +02001076 stats.rttMs = GetRTT();
1077
Henrik Boströmcf96e0f2019-04-17 13:51:53 +02001078 StreamDataCounters rtp_stats;
1079 StreamDataCounters rtx_stats;
1080 _rtpRtcpModule->GetSendStreamDataCounters(&rtp_stats, &rtx_stats);
Bjorn A Mellemda4f0932019-07-30 08:34:03 -07001081 if (use_standard_bytes_stats_) {
1082 stats.bytesSent = rtp_stats.transmitted.payload_bytes +
1083 rtx_stats.transmitted.payload_bytes;
1084 } else {
1085 stats.bytesSent = rtp_stats.transmitted.payload_bytes +
1086 rtp_stats.transmitted.padding_bytes +
1087 rtp_stats.transmitted.header_bytes +
1088 rtx_stats.transmitted.payload_bytes +
1089 rtx_stats.transmitted.padding_bytes +
1090 rtx_stats.transmitted.header_bytes;
1091 }
Henrik Boströmcf96e0f2019-04-17 13:51:53 +02001092 // TODO(https://crbug.com/webrtc/10555): RTX retransmissions should show up in
1093 // separate outbound-rtp stream objects.
1094 stats.retransmitted_bytes_sent = rtp_stats.retransmitted.payload_bytes;
1095 stats.packetsSent =
1096 rtp_stats.transmitted.packets + rtx_stats.transmitted.packets;
1097 stats.retransmitted_packets_sent = rtp_stats.retransmitted.packets;
Henrik Boström6e436d12019-05-27 12:19:33 +02001098 stats.report_block_datas = _rtpRtcpModule->GetLatestReportBlockData();
Niels Möller530ead42018-10-04 14:28:39 +02001099
Niels Möller26815232018-11-16 09:32:40 +01001100 return stats;
Niels Möller530ead42018-10-04 14:28:39 +02001101}
1102
Niels Möller530ead42018-10-04 14:28:39 +02001103void ChannelSend::ProcessAndEncodeAudio(
1104 std::unique_ptr<AudioFrame> audio_frame) {
Niels Möllerdced9f62018-11-19 10:27:07 +01001105 RTC_DCHECK_RUNS_SERIALIZED(&audio_thread_race_checker_);
Sebastian Jansson44dd9f22019-03-08 14:50:30 +01001106 struct ProcessAndEncodeAudio {
1107 void operator()() {
1108 RTC_DCHECK_RUN_ON(&channel->encoder_queue_);
1109 if (!channel->encoder_queue_is_active_) {
1110 return;
1111 }
1112 channel->ProcessAndEncodeAudioOnTaskQueue(audio_frame.get());
1113 }
1114 std::unique_ptr<AudioFrame> audio_frame;
1115 ChannelSend* const channel;
1116 };
Niels Möller530ead42018-10-04 14:28:39 +02001117 // Profile time between when the audio frame is added to the task queue and
1118 // when the task is actually executed.
1119 audio_frame->UpdateProfileTimeStamp();
Sebastian Jansson44dd9f22019-03-08 14:50:30 +01001120 encoder_queue_.PostTask(ProcessAndEncodeAudio{std::move(audio_frame), this});
Niels Möller530ead42018-10-04 14:28:39 +02001121}
1122
1123void ChannelSend::ProcessAndEncodeAudioOnTaskQueue(AudioFrame* audio_input) {
Niels Möller530ead42018-10-04 14:28:39 +02001124 RTC_DCHECK_GT(audio_input->samples_per_channel_, 0);
henrikad0679bd2019-07-09 15:37:45 +02001125 RTC_DCHECK_LE(audio_input->num_channels_, 8);
Niels Möller530ead42018-10-04 14:28:39 +02001126
1127 // Measure time between when the audio frame is added to the task queue and
1128 // when the task is actually executed. Goal is to keep track of unwanted
1129 // extra latency added by the task queue.
1130 RTC_HISTOGRAM_COUNTS_10000("WebRTC.Audio.EncodingTaskQueueLatencyMs",
1131 audio_input->ElapsedProfileTimeMs());
1132
1133 bool is_muted = InputMute();
1134 AudioFrameOperations::Mute(audio_input, previous_frame_muted_, is_muted);
1135
1136 if (_includeAudioLevelIndication) {
1137 size_t length =
1138 audio_input->samples_per_channel_ * audio_input->num_channels_;
1139 RTC_CHECK_LE(length, AudioFrame::kMaxDataSizeBytes);
1140 if (is_muted && previous_frame_muted_) {
1141 rms_level_.AnalyzeMuted(length);
1142 } else {
1143 rms_level_.Analyze(
1144 rtc::ArrayView<const int16_t>(audio_input->data(), length));
1145 }
1146 }
1147 previous_frame_muted_ = is_muted;
1148
1149 // Add 10ms of raw (PCM) audio data to the encoder @ 32kHz.
1150
1151 // The ACM resamples internally.
1152 audio_input->timestamp_ = _timeStamp;
1153 // This call will trigger AudioPacketizationCallback::SendData if encoding
1154 // is done and payload is ready for packetization and transmission.
1155 // Otherwise, it will return without invoking the callback.
1156 if (audio_coding_->Add10MsData(*audio_input) < 0) {
1157 RTC_DLOG(LS_ERROR) << "ACM::Add10MsData() failed.";
1158 return;
1159 }
1160
1161 _timeStamp += static_cast<uint32_t>(audio_input->samples_per_channel_);
1162}
1163
Niels Möller530ead42018-10-04 14:28:39 +02001164ANAStats ChannelSend::GetANAStatistics() const {
Niels Möller26e88b02018-11-19 15:08:13 +01001165 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Niels Möller530ead42018-10-04 14:28:39 +02001166 return audio_coding_->GetANAStats();
1167}
1168
1169RtpRtcp* ChannelSend::GetRtpRtcp() const {
Sebastian Janssonc01367d2019-04-08 15:20:44 +02001170 RTC_DCHECK(module_process_thread_checker_.IsCurrent());
Niels Möller530ead42018-10-04 14:28:39 +02001171 return _rtpRtcpModule.get();
1172}
1173
1174int ChannelSend::SetSendRtpHeaderExtension(bool enable,
1175 RTPExtensionType type,
Niels Möller26815232018-11-16 09:32:40 +01001176 int id) {
Niels Möller530ead42018-10-04 14:28:39 +02001177 int error = 0;
1178 _rtpRtcpModule->DeregisterSendRtpHeaderExtension(type);
1179 if (enable) {
Niels Möller26815232018-11-16 09:32:40 +01001180 // TODO(nisse): RtpRtcp::RegisterSendRtpHeaderExtension to take an int
1181 // argument. Currently it wants an uint8_t.
1182 error = _rtpRtcpModule->RegisterSendRtpHeaderExtension(
1183 type, rtc::dchecked_cast<uint8_t>(id));
Niels Möller530ead42018-10-04 14:28:39 +02001184 }
1185 return error;
1186}
1187
Niels Möller530ead42018-10-04 14:28:39 +02001188int64_t ChannelSend::GetRTT() const {
Anton Sukhanov4f08faa2019-05-21 11:12:57 -07001189 if (media_transport_config_.media_transport) {
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -08001190 // GetRTT is generally used in the RTCP codepath, where media transport is
1191 // not present and so it shouldn't be needed. But it's also invoked in
1192 // 'GetStats' method, and for now returning media transport RTT here gives
1193 // us "free" rtt stats for media transport.
Anton Sukhanov4f08faa2019-05-21 11:12:57 -07001194 auto target_rate =
1195 media_transport_config_.media_transport->GetLatestTargetTransferRate();
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -08001196 if (target_rate.has_value()) {
1197 return target_rate.value().network_estimate.round_trip_time.ms();
1198 }
1199
1200 return 0;
1201 }
Niels Möller530ead42018-10-04 14:28:39 +02001202 RtcpMode method = _rtpRtcpModule->RTCP();
1203 if (method == RtcpMode::kOff) {
1204 return 0;
1205 }
1206 std::vector<RTCPReportBlock> report_blocks;
1207 _rtpRtcpModule->RemoteRTCPStat(&report_blocks);
1208
1209 if (report_blocks.empty()) {
1210 return 0;
1211 }
1212
1213 int64_t rtt = 0;
1214 int64_t avg_rtt = 0;
1215 int64_t max_rtt = 0;
1216 int64_t min_rtt = 0;
1217 // We don't know in advance the remote ssrc used by the other end's receiver
1218 // reports, so use the SSRC of the first report block for calculating the RTT.
1219 if (_rtpRtcpModule->RTT(report_blocks[0].sender_ssrc, &rtt, &avg_rtt,
1220 &min_rtt, &max_rtt) != 0) {
1221 return 0;
1222 }
1223 return rtt;
1224}
1225
Benjamin Wright78410ad2018-10-25 09:52:57 -07001226void ChannelSend::SetFrameEncryptor(
1227 rtc::scoped_refptr<FrameEncryptorInterface> frame_encryptor) {
Niels Möller26e88b02018-11-19 15:08:13 +01001228 RTC_DCHECK_RUN_ON(&worker_thread_checker_);
Sebastian Jansson44dd9f22019-03-08 14:50:30 +01001229 encoder_queue_.PostTask([this, frame_encryptor]() mutable {
1230 RTC_DCHECK_RUN_ON(&encoder_queue_);
Sebastian Jansson7949f212019-03-05 13:41:48 +00001231 frame_encryptor_ = std::move(frame_encryptor);
Sebastian Jansson44dd9f22019-03-08 14:50:30 +01001232 });
Benjamin Wright84583f62018-10-04 14:22:34 -07001233}
1234
Anton Sukhanov626015d2019-02-04 15:16:06 -08001235// TODO(sukhanov): Consider moving TargetTransferRate observer to
1236// AudioSendStream. Since AudioSendStream owns encoder and configures ANA, it
1237// makes sense to consolidate all rate (and overhead) calculation there.
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -08001238void ChannelSend::OnTargetTransferRate(TargetTransferRate rate) {
Anton Sukhanov4f08faa2019-05-21 11:12:57 -07001239 RTC_DCHECK(media_transport_config_.media_transport);
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -08001240 OnReceivedRtt(rate.network_estimate.round_trip_time.ms());
1241}
1242
1243void ChannelSend::OnReceivedRtt(int64_t rtt_ms) {
1244 // Invoke audio encoders OnReceivedRtt().
Sebastian Jansson14a7cf92019-02-13 15:11:42 +01001245 CallEncoder(
1246 [rtt_ms](AudioEncoder* encoder) { encoder->OnReceivedRtt(rtt_ms); });
Piotr (Peter) Slatala179a3922018-11-16 09:57:58 -08001247}
1248
Niels Möllerdced9f62018-11-19 10:27:07 +01001249} // namespace
1250
1251std::unique_ptr<ChannelSendInterface> CreateChannelSend(
Sebastian Jansson977b3352019-03-04 17:43:34 +01001252 Clock* clock,
Sebastian Jansson44dd9f22019-03-08 14:50:30 +01001253 TaskQueueFactory* task_queue_factory,
Niels Möllerdced9f62018-11-19 10:27:07 +01001254 ProcessThread* module_process_thread,
Anton Sukhanov4f08faa2019-05-21 11:12:57 -07001255 const MediaTransportConfig& media_transport_config,
Anton Sukhanov626015d2019-02-04 15:16:06 -08001256 OverheadObserver* overhead_observer,
Niels Möllere9771992018-11-26 10:55:07 +01001257 Transport* rtp_transport,
Niels Möllerdced9f62018-11-19 10:27:07 +01001258 RtcpRttStats* rtcp_rtt_stats,
1259 RtcEventLog* rtc_event_log,
1260 FrameEncryptorInterface* frame_encryptor,
1261 const webrtc::CryptoOptions& crypto_options,
1262 bool extmap_allow_mixed,
Erik Språng4c2c4122019-07-11 15:20:15 +02001263 int rtcp_report_interval_ms,
1264 uint32_t ssrc) {
Niels Möllerdced9f62018-11-19 10:27:07 +01001265 return absl::make_unique<ChannelSend>(
Anton Sukhanov4f08faa2019-05-21 11:12:57 -07001266 clock, task_queue_factory, module_process_thread, media_transport_config,
Sebastian Jansson977b3352019-03-04 17:43:34 +01001267 overhead_observer, rtp_transport, rtcp_rtt_stats, rtc_event_log,
1268 frame_encryptor, crypto_options, extmap_allow_mixed,
Erik Språng4c2c4122019-07-11 15:20:15 +02001269 rtcp_report_interval_ms, ssrc);
Niels Möllerdced9f62018-11-19 10:27:07 +01001270}
1271
Niels Möller530ead42018-10-04 14:28:39 +02001272} // namespace voe
1273} // namespace webrtc