blob: 5de079bb18c489f6ba6675d89b8ce4dafd4ea8bf [file] [log] [blame]
solenbergc7a8b082015-10-16 14:35:07 -07001/*
2 * Copyright (c) 2015 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
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "audio/audio_send_stream.h"
solenbergc7a8b082015-10-16 14:35:07 -070012
13#include <string>
ossu20a4b3f2017-04-27 02:08:52 -070014#include <utility>
15#include <vector>
solenbergc7a8b082015-10-16 14:35:07 -070016
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020017#include "audio/audio_state.h"
Fredrik Solenberga8b7c7f2018-01-17 11:18:31 +010018#include "audio/channel_proxy.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020019#include "audio/conversion.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020020#include "call/rtp_transport_controller_send_interface.h"
21#include "modules/audio_coding/codecs/cng/audio_encoder_cng.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020022#include "modules/pacing/paced_sender.h"
23#include "rtc_base/checks.h"
24#include "rtc_base/event.h"
25#include "rtc_base/function_view.h"
26#include "rtc_base/logging.h"
27#include "rtc_base/task_queue.h"
28#include "rtc_base/timeutils.h"
Alex Narestcedd3512017-12-07 20:54:55 +010029#include "system_wrappers/include/field_trial.h"
solenbergc7a8b082015-10-16 14:35:07 -070030
31namespace webrtc {
solenbergc7a8b082015-10-16 14:35:07 -070032namespace internal {
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +010033namespace {
eladalonedd6eea2017-05-25 00:15:35 -070034// TODO(eladalon): Subsequent CL will make these values experiment-dependent.
elad.alond12a8e12017-03-23 11:04:48 -070035constexpr size_t kPacketLossTrackerMaxWindowSizeMs = 15000;
36constexpr size_t kPacketLossRateMinNumAckedPackets = 50;
37constexpr size_t kRecoverablePacketLossRateMinNumAckedPairs = 40;
38
ossu20a4b3f2017-04-27 02:08:52 -070039void CallEncoder(const std::unique_ptr<voe::ChannelProxy>& channel_proxy,
40 rtc::FunctionView<void(AudioEncoder*)> lambda) {
41 channel_proxy->ModifyEncoder([&](std::unique_ptr<AudioEncoder>* encoder_ptr) {
42 RTC_DCHECK(encoder_ptr);
43 lambda(encoder_ptr->get());
44 });
45}
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +010046
47std::unique_ptr<voe::ChannelProxy> CreateChannelAndProxy(
48 webrtc::AudioState* audio_state,
49 rtc::TaskQueue* worker_queue,
50 ProcessThread* module_process_thread) {
51 RTC_DCHECK(audio_state);
52 internal::AudioState* internal_audio_state =
53 static_cast<internal::AudioState*>(audio_state);
54 return std::unique_ptr<voe::ChannelProxy>(new voe::ChannelProxy(
55 std::unique_ptr<voe::Channel>(new voe::Channel(
56 worker_queue,
57 module_process_thread,
58 internal_audio_state->audio_device_module()))));
59}
ossu20a4b3f2017-04-27 02:08:52 -070060} // namespace
61
Sam Zackrisson06953ba2018-02-01 16:53:16 +010062// Helper class to track the actively sending lifetime of this stream.
sazac58f8c02017-07-19 00:39:19 -070063class AudioSendStream::TimedTransport : public Transport {
64 public:
65 TimedTransport(Transport* transport, TimeInterval* time_interval)
66 : transport_(transport), lifetime_(time_interval) {}
67 bool SendRtp(const uint8_t* packet,
68 size_t length,
69 const PacketOptions& options) {
70 if (lifetime_) {
71 lifetime_->Extend();
72 }
73 return transport_->SendRtp(packet, length, options);
74 }
75 bool SendRtcp(const uint8_t* packet, size_t length) {
76 return transport_->SendRtcp(packet, length);
77 }
78 ~TimedTransport() {}
79
80 private:
81 Transport* transport_;
82 TimeInterval* lifetime_;
83};
84
solenberg566ef242015-11-06 15:34:49 -080085AudioSendStream::AudioSendStream(
86 const webrtc::AudioSendStream::Config& config,
Stefan Holmerb86d4e42015-12-07 10:26:18 +010087 const rtc::scoped_refptr<webrtc::AudioState>& audio_state,
perkj26091b12016-09-01 01:17:40 -070088 rtc::TaskQueue* worker_queue,
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +010089 ProcessThread* module_process_thread,
nisseb8f9a322017-03-27 05:36:15 -070090 RtpTransportControllerSendInterface* transport,
tereliuse035e2d2016-09-21 06:51:47 -070091 BitrateAllocator* bitrate_allocator,
michaelt9332b7d2016-11-30 07:51:13 -080092 RtcEventLog* event_log,
ossuc3d4b482017-05-23 06:07:11 -070093 RtcpRttStats* rtcp_rtt_stats,
Sam Zackrisson06953ba2018-02-01 16:53:16 +010094 const rtc::Optional<RtpState>& suspended_rtp_state,
95 TimeInterval* overall_call_lifetime)
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +010096 : AudioSendStream(config,
97 audio_state,
98 worker_queue,
99 transport,
100 bitrate_allocator,
101 event_log,
102 rtcp_rtt_stats,
103 suspended_rtp_state,
Sam Zackrisson06953ba2018-02-01 16:53:16 +0100104 overall_call_lifetime,
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +0100105 CreateChannelAndProxy(audio_state.get(),
106 worker_queue,
107 module_process_thread)) {}
108
109AudioSendStream::AudioSendStream(
110 const webrtc::AudioSendStream::Config& config,
111 const rtc::scoped_refptr<webrtc::AudioState>& audio_state,
112 rtc::TaskQueue* worker_queue,
113 RtpTransportControllerSendInterface* transport,
114 BitrateAllocator* bitrate_allocator,
115 RtcEventLog* event_log,
116 RtcpRttStats* rtcp_rtt_stats,
117 const rtc::Optional<RtpState>& suspended_rtp_state,
Sam Zackrisson06953ba2018-02-01 16:53:16 +0100118 TimeInterval* overall_call_lifetime,
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +0100119 std::unique_ptr<voe::ChannelProxy> channel_proxy)
perkj26091b12016-09-01 01:17:40 -0700120 : worker_queue_(worker_queue),
ossu20a4b3f2017-04-27 02:08:52 -0700121 config_(Config(nullptr)),
mflodman86cc6ff2016-07-26 04:44:06 -0700122 audio_state_(audio_state),
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +0100123 channel_proxy_(std::move(channel_proxy)),
ossu20a4b3f2017-04-27 02:08:52 -0700124 event_log_(event_log),
michaeltf4caaab2017-01-16 23:55:07 -0800125 bitrate_allocator_(bitrate_allocator),
nisseb8f9a322017-03-27 05:36:15 -0700126 transport_(transport),
elad.alond12a8e12017-03-23 11:04:48 -0700127 packet_loss_tracker_(kPacketLossTrackerMaxWindowSizeMs,
128 kPacketLossRateMinNumAckedPackets,
ossuc3d4b482017-05-23 06:07:11 -0700129 kRecoverablePacketLossRateMinNumAckedPairs),
130 rtp_rtcp_module_(nullptr),
Sam Zackrisson06953ba2018-02-01 16:53:16 +0100131 suspended_rtp_state_(suspended_rtp_state),
132 overall_call_lifetime_(overall_call_lifetime) {
Jonas Olsson24ea8222018-01-25 10:14:29 +0100133 RTC_LOG(LS_INFO) << "AudioSendStream: " << config.rtp.ssrc;
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +0100134 RTC_DCHECK(worker_queue_);
135 RTC_DCHECK(audio_state_);
136 RTC_DCHECK(channel_proxy_);
137 RTC_DCHECK(bitrate_allocator_);
nisseb8f9a322017-03-27 05:36:15 -0700138 RTC_DCHECK(transport);
Sam Zackrisson06953ba2018-02-01 16:53:16 +0100139 RTC_DCHECK(overall_call_lifetime_);
solenberg3a941542015-11-16 07:34:50 -0800140
ossu20a4b3f2017-04-27 02:08:52 -0700141 channel_proxy_->SetRtcEventLog(event_log_);
michaelt9332b7d2016-11-30 07:51:13 -0800142 channel_proxy_->SetRtcpRttStats(rtcp_rtt_stats);
solenberg13725082015-11-25 08:16:52 -0800143 channel_proxy_->SetRTCPStatus(true);
ossuc3d4b482017-05-23 06:07:11 -0700144 RtpReceiver* rtpReceiver = nullptr; // Unused, but required for call.
145 channel_proxy_->GetRtpRtcp(&rtp_rtcp_module_, &rtpReceiver);
146 RTC_DCHECK(rtp_rtcp_module_);
mflodman3d7db262016-04-29 00:57:13 -0700147
ossu20a4b3f2017-04-27 02:08:52 -0700148 ConfigureStream(this, config, true);
elad.alond12a8e12017-03-23 11:04:48 -0700149
150 pacer_thread_checker_.DetachFromThread();
Danil Chapovalov90e1f532017-10-03 14:59:27 +0200151 // Signal congestion controller this object is ready for OnPacket* callbacks.
Sebastian Janssone4be6da2018-02-15 16:51:41 +0100152 transport_->RegisterPacketFeedbackObserver(this);
solenbergc7a8b082015-10-16 14:35:07 -0700153}
154
155AudioSendStream::~AudioSendStream() {
elad.alond12a8e12017-03-23 11:04:48 -0700156 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Jonas Olsson24ea8222018-01-25 10:14:29 +0100157 RTC_LOG(LS_INFO) << "~AudioSendStream: " << config_.rtp.ssrc;
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100158 RTC_DCHECK(!sending_);
Sebastian Janssone4be6da2018-02-15 16:51:41 +0100159 transport_->DeRegisterPacketFeedbackObserver(this);
solenberg1c239d42017-09-29 06:00:28 -0700160 channel_proxy_->RegisterTransport(nullptr);
nissefdbfdc92017-03-31 05:44:52 -0700161 channel_proxy_->ResetSenderCongestionControlObjects();
tereliuse035e2d2016-09-21 06:51:47 -0700162 channel_proxy_->SetRtcEventLog(nullptr);
michaelt9332b7d2016-11-30 07:51:13 -0800163 channel_proxy_->SetRtcpRttStats(nullptr);
Sam Zackrisson06953ba2018-02-01 16:53:16 +0100164 // Lifetime can only be updated after deregistering
165 // |timed_send_transport_adapter_| in the underlying channel object to avoid
166 // data races in |active_lifetime_|.
167 overall_call_lifetime_->Extend(active_lifetime_);
solenbergc7a8b082015-10-16 14:35:07 -0700168}
169
eladalonabbc4302017-07-26 02:09:44 -0700170const webrtc::AudioSendStream::Config& AudioSendStream::GetConfig() const {
171 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
172 return config_;
173}
174
ossu20a4b3f2017-04-27 02:08:52 -0700175void AudioSendStream::Reconfigure(
176 const webrtc::AudioSendStream::Config& new_config) {
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100177 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
ossu20a4b3f2017-04-27 02:08:52 -0700178 ConfigureStream(this, new_config, false);
179}
180
Alex Narestcedd3512017-12-07 20:54:55 +0100181AudioSendStream::ExtensionIds AudioSendStream::FindExtensionIds(
182 const std::vector<RtpExtension>& extensions) {
183 ExtensionIds ids;
184 for (const auto& extension : extensions) {
185 if (extension.uri == RtpExtension::kAudioLevelUri) {
186 ids.audio_level = extension.id;
187 } else if (extension.uri == RtpExtension::kTransportSequenceNumberUri) {
188 ids.transport_sequence_number = extension.id;
189 }
190 }
191 return ids;
192}
193
ossu20a4b3f2017-04-27 02:08:52 -0700194void AudioSendStream::ConfigureStream(
195 webrtc::internal::AudioSendStream* stream,
196 const webrtc::AudioSendStream::Config& new_config,
197 bool first_time) {
Jonas Olsson24ea8222018-01-25 10:14:29 +0100198 RTC_LOG(LS_INFO) << "AudioSendStream::ConfigureStream: "
199 << new_config.ToString();
ossu20a4b3f2017-04-27 02:08:52 -0700200 const auto& channel_proxy = stream->channel_proxy_;
201 const auto& old_config = stream->config_;
202
203 if (first_time || old_config.rtp.ssrc != new_config.rtp.ssrc) {
204 channel_proxy->SetLocalSSRC(new_config.rtp.ssrc);
ossuc3d4b482017-05-23 06:07:11 -0700205 if (stream->suspended_rtp_state_) {
206 stream->rtp_rtcp_module_->SetRtpState(*stream->suspended_rtp_state_);
207 }
ossu20a4b3f2017-04-27 02:08:52 -0700208 }
209 if (first_time || old_config.rtp.c_name != new_config.rtp.c_name) {
210 channel_proxy->SetRTCP_CNAME(new_config.rtp.c_name);
211 }
212 // TODO(solenberg): Config NACK history window (which is a packet count),
213 // using the actual packet size for the configured codec.
214 if (first_time || old_config.rtp.nack.rtp_history_ms !=
215 new_config.rtp.nack.rtp_history_ms) {
216 channel_proxy->SetNACKStatus(new_config.rtp.nack.rtp_history_ms != 0,
217 new_config.rtp.nack.rtp_history_ms / 20);
218 }
219
220 if (first_time ||
221 new_config.send_transport != old_config.send_transport) {
222 if (old_config.send_transport) {
solenberg1c239d42017-09-29 06:00:28 -0700223 channel_proxy->RegisterTransport(nullptr);
ossu20a4b3f2017-04-27 02:08:52 -0700224 }
sazac58f8c02017-07-19 00:39:19 -0700225 if (new_config.send_transport) {
226 stream->timed_send_transport_adapter_.reset(new TimedTransport(
227 new_config.send_transport, &stream->active_lifetime_));
228 } else {
229 stream->timed_send_transport_adapter_.reset(nullptr);
230 }
solenberg1c239d42017-09-29 06:00:28 -0700231 channel_proxy->RegisterTransport(
sazac58f8c02017-07-19 00:39:19 -0700232 stream->timed_send_transport_adapter_.get());
ossu20a4b3f2017-04-27 02:08:52 -0700233 }
234
Alex Narestcedd3512017-12-07 20:54:55 +0100235 const ExtensionIds old_ids = FindExtensionIds(old_config.rtp.extensions);
236 const ExtensionIds new_ids = FindExtensionIds(new_config.rtp.extensions);
ossu20a4b3f2017-04-27 02:08:52 -0700237 // Audio level indication
238 if (first_time || new_ids.audio_level != old_ids.audio_level) {
239 channel_proxy->SetSendAudioLevelIndicationStatus(new_ids.audio_level != 0,
240 new_ids.audio_level);
241 }
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100242 bool transport_seq_num_id_changed =
243 new_ids.transport_sequence_number != old_ids.transport_sequence_number;
244 if (first_time || transport_seq_num_id_changed) {
ossu1129df22017-06-30 01:38:56 -0700245 if (!first_time) {
ossu20a4b3f2017-04-27 02:08:52 -0700246 channel_proxy->ResetSenderCongestionControlObjects();
ossu20a4b3f2017-04-27 02:08:52 -0700247 }
248
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100249 RtcpBandwidthObserver* bandwidth_observer = nullptr;
250 bool has_transport_sequence_number = new_ids.transport_sequence_number != 0;
251 if (has_transport_sequence_number) {
ossu20a4b3f2017-04-27 02:08:52 -0700252 channel_proxy->EnableSendTransportSequenceNumber(
253 new_ids.transport_sequence_number);
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100254 // Probing in application limited region is only used in combination with
255 // send side congestion control, wich depends on feedback packets which
256 // requires transport sequence numbers to be enabled.
Sebastian Janssone4be6da2018-02-15 16:51:41 +0100257 stream->transport_->EnablePeriodicAlrProbing(true);
258 bandwidth_observer = stream->transport_->GetBandwidthObserver();
ossu20a4b3f2017-04-27 02:08:52 -0700259 }
260
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100261 channel_proxy->RegisterSenderCongestionControlObjects(stream->transport_,
262 bandwidth_observer);
ossu20a4b3f2017-04-27 02:08:52 -0700263 }
264
265 if (!ReconfigureSendCodec(stream, new_config)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100266 RTC_LOG(LS_ERROR) << "Failed to set up send codec state.";
ossu20a4b3f2017-04-27 02:08:52 -0700267 }
268
Oskar Sundbomf85e31b2017-12-20 16:38:09 +0100269 if (stream->sending_) {
270 ReconfigureBitrateObserver(stream, new_config);
271 }
ossu20a4b3f2017-04-27 02:08:52 -0700272 stream->config_ = new_config;
273}
274
solenberg3a941542015-11-16 07:34:50 -0800275void AudioSendStream::Start() {
elad.alond12a8e12017-03-23 11:04:48 -0700276 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100277 if (sending_) {
278 return;
279 }
280
Alex Narestcedd3512017-12-07 20:54:55 +0100281 if (config_.min_bitrate_bps != -1 && config_.max_bitrate_bps != -1 &&
282 (FindExtensionIds(config_.rtp.extensions).transport_sequence_number !=
283 0 ||
284 !webrtc::field_trial::IsEnabled("WebRTC-Audio-SendSideBwe"))) {
Alex Narest78609d52017-10-20 10:37:47 +0200285 // Audio BWE is enabled.
286 transport_->packet_sender()->SetAccountForAudioPackets(true);
Seth Hampson24722b32017-12-22 09:36:42 -0800287 ConfigureBitrateObserver(config_.min_bitrate_bps, config_.max_bitrate_bps,
288 config_.bitrate_priority);
mflodman86cc6ff2016-07-26 04:44:06 -0700289 }
Fredrik Solenbergaaedf752017-12-18 13:09:12 +0100290 channel_proxy_->StartSend();
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100291 sending_ = true;
292 audio_state()->AddSendingStream(this, encoder_sample_rate_hz_,
293 encoder_num_channels_);
solenberg3a941542015-11-16 07:34:50 -0800294}
295
296void AudioSendStream::Stop() {
elad.alond12a8e12017-03-23 11:04:48 -0700297 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100298 if (!sending_) {
299 return;
300 }
301
ossu20a4b3f2017-04-27 02:08:52 -0700302 RemoveBitrateObserver();
Fredrik Solenbergaaedf752017-12-18 13:09:12 +0100303 channel_proxy_->StopSend();
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100304 sending_ = false;
305 audio_state()->RemoveSendingStream(this);
306}
307
308void AudioSendStream::SendAudioData(std::unique_ptr<AudioFrame> audio_frame) {
309 RTC_CHECK_RUNS_SERIALIZED(&audio_capture_race_checker_);
310 channel_proxy_->ProcessAndEncodeAudio(std::move(audio_frame));
solenberg3a941542015-11-16 07:34:50 -0800311}
312
solenbergffbbcac2016-11-17 05:25:37 -0800313bool AudioSendStream::SendTelephoneEvent(int payload_type,
314 int payload_frequency, int event,
solenberg8842c3e2016-03-11 03:06:41 -0800315 int duration_ms) {
elad.alond12a8e12017-03-23 11:04:48 -0700316 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
solenbergffbbcac2016-11-17 05:25:37 -0800317 return channel_proxy_->SetSendTelephoneEventPayloadType(payload_type,
318 payload_frequency) &&
Fredrik Solenbergb5727682015-12-04 15:22:19 +0100319 channel_proxy_->SendTelephoneEventOutband(event, duration_ms);
320}
321
solenberg94218532016-06-16 10:53:22 -0700322void AudioSendStream::SetMuted(bool muted) {
elad.alond12a8e12017-03-23 11:04:48 -0700323 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
solenberg94218532016-06-16 10:53:22 -0700324 channel_proxy_->SetInputMute(muted);
325}
326
solenbergc7a8b082015-10-16 14:35:07 -0700327webrtc::AudioSendStream::Stats AudioSendStream::GetStats() const {
Ivo Creusen56d46092017-11-24 17:29:59 +0100328 return GetStats(true);
329}
330
331webrtc::AudioSendStream::Stats AudioSendStream::GetStats(
332 bool has_remote_tracks) const {
elad.alond12a8e12017-03-23 11:04:48 -0700333 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
solenberg85a04962015-10-27 03:35:21 -0700334 webrtc::AudioSendStream::Stats stats;
335 stats.local_ssrc = config_.rtp.ssrc;
solenberg85a04962015-10-27 03:35:21 -0700336
solenberg358057b2015-11-27 10:46:42 -0800337 webrtc::CallStatistics call_stats = channel_proxy_->GetRTCPStatistics();
solenberg85a04962015-10-27 03:35:21 -0700338 stats.bytes_sent = call_stats.bytesSent;
339 stats.packets_sent = call_stats.packetsSent;
solenberg8b85de22015-11-16 09:48:04 -0800340 // RTT isn't known until a RTCP report is received. Until then, VoiceEngine
341 // returns 0 to indicate an error value.
342 if (call_stats.rttMs > 0) {
343 stats.rtt_ms = call_stats.rttMs;
344 }
ossu20a4b3f2017-04-27 02:08:52 -0700345 if (config_.send_codec_spec) {
346 const auto& spec = *config_.send_codec_spec;
347 stats.codec_name = spec.format.name;
Oskar Sundbom2707fb22017-11-16 10:57:35 +0100348 stats.codec_payload_type = spec.payload_type;
solenberg85a04962015-10-27 03:35:21 -0700349
350 // Get data from the last remote RTCP report.
solenberg358057b2015-11-27 10:46:42 -0800351 for (const auto& block : channel_proxy_->GetRemoteRTCPReportBlocks()) {
solenberg8b85de22015-11-16 09:48:04 -0800352 // Lookup report for send ssrc only.
353 if (block.source_SSRC == stats.local_ssrc) {
354 stats.packets_lost = block.cumulative_num_packets_lost;
355 stats.fraction_lost = Q8ToFloat(block.fraction_lost);
356 stats.ext_seqnum = block.extended_highest_sequence_number;
ossu20a4b3f2017-04-27 02:08:52 -0700357 // Convert timestamps to milliseconds.
358 if (spec.format.clockrate_hz / 1000 > 0) {
solenberg8b85de22015-11-16 09:48:04 -0800359 stats.jitter_ms =
ossu20a4b3f2017-04-27 02:08:52 -0700360 block.interarrival_jitter / (spec.format.clockrate_hz / 1000);
solenberg85a04962015-10-27 03:35:21 -0700361 }
solenberg8b85de22015-11-16 09:48:04 -0800362 break;
solenberg85a04962015-10-27 03:35:21 -0700363 }
364 }
365 }
366
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100367 AudioState::Stats input_stats = audio_state()->GetAudioInputStats();
368 stats.audio_level = input_stats.audio_level;
369 stats.total_input_energy = input_stats.total_energy;
370 stats.total_input_duration = input_stats.total_duration;
solenberg796b8f92017-03-01 17:02:23 -0800371
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100372 stats.typing_noise_detected = audio_state()->typing_noise_detected();
ivoce1198e02017-09-08 08:13:19 -0700373 stats.ana_statistics = channel_proxy_->GetANAStatistics();
Ivo Creusen56d46092017-11-24 17:29:59 +0100374 RTC_DCHECK(audio_state_->audio_processing());
375 stats.apm_statistics =
376 audio_state_->audio_processing()->GetStatistics(has_remote_tracks);
solenberg85a04962015-10-27 03:35:21 -0700377
378 return stats;
379}
380
pbos1ba8d392016-05-01 20:18:34 -0700381void AudioSendStream::SignalNetworkState(NetworkState state) {
elad.alond12a8e12017-03-23 11:04:48 -0700382 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
pbos1ba8d392016-05-01 20:18:34 -0700383}
384
385bool AudioSendStream::DeliverRtcp(const uint8_t* packet, size_t length) {
386 // TODO(solenberg): Tests call this function on a network thread, libjingle
387 // calls on the worker thread. We should move towards always using a network
388 // thread. Then this check can be enabled.
elad.alond12a8e12017-03-23 11:04:48 -0700389 // RTC_DCHECK(!worker_thread_checker_.CalledOnValidThread());
pbos1ba8d392016-05-01 20:18:34 -0700390 return channel_proxy_->ReceivedRTCPPacket(packet, length);
391}
392
mflodman86cc6ff2016-07-26 04:44:06 -0700393uint32_t AudioSendStream::OnBitrateUpdated(uint32_t bitrate_bps,
394 uint8_t fraction_loss,
minyue78b4d562016-11-30 04:47:39 -0800395 int64_t rtt,
minyue93e45222017-05-18 14:32:41 -0700396 int64_t bwe_period_ms) {
stefanfca900a2017-04-10 03:53:00 -0700397 // A send stream may be allocated a bitrate of zero if the allocator decides
398 // to disable it. For now we ignore this decision and keep sending on min
399 // bitrate.
400 if (bitrate_bps == 0) {
401 bitrate_bps = config_.min_bitrate_bps;
402 }
mflodman86cc6ff2016-07-26 04:44:06 -0700403 RTC_DCHECK_GE(bitrate_bps,
minyue10cbb462016-11-07 09:29:22 -0800404 static_cast<uint32_t>(config_.min_bitrate_bps));
mflodman86cc6ff2016-07-26 04:44:06 -0700405 // The bitrate allocator might allocate an higher than max configured bitrate
406 // if there is room, to allow for, as example, extra FEC. Ignore that for now.
minyue10cbb462016-11-07 09:29:22 -0800407 const uint32_t max_bitrate_bps = config_.max_bitrate_bps;
mflodman86cc6ff2016-07-26 04:44:06 -0700408 if (bitrate_bps > max_bitrate_bps)
409 bitrate_bps = max_bitrate_bps;
410
minyue93e45222017-05-18 14:32:41 -0700411 channel_proxy_->SetBitrate(bitrate_bps, bwe_period_ms);
mflodman86cc6ff2016-07-26 04:44:06 -0700412
413 // The amount of audio protection is not exposed by the encoder, hence
414 // always returning 0.
415 return 0;
416}
417
elad.alond12a8e12017-03-23 11:04:48 -0700418void AudioSendStream::OnPacketAdded(uint32_t ssrc, uint16_t seq_num) {
419 RTC_DCHECK(pacer_thread_checker_.CalledOnValidThread());
420 // Only packets that belong to this stream are of interest.
421 if (ssrc == config_.rtp.ssrc) {
422 rtc::CritScope lock(&packet_loss_tracker_cs_);
eladalonedd6eea2017-05-25 00:15:35 -0700423 // TODO(eladalon): This function call could potentially reset the window,
elad.alond12a8e12017-03-23 11:04:48 -0700424 // setting both PLR and RPLR to unknown. Consider (during upcoming
425 // refactoring) passing an indication of such an event.
426 packet_loss_tracker_.OnPacketAdded(seq_num, rtc::TimeMillis());
427 }
428}
429
430void AudioSendStream::OnPacketFeedbackVector(
431 const std::vector<PacketFeedback>& packet_feedback_vector) {
eladalon3651fdd2017-08-24 07:26:25 -0700432 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
elad.alond12a8e12017-03-23 11:04:48 -0700433 rtc::Optional<float> plr;
elad.alondadb4dc2017-03-23 15:29:50 -0700434 rtc::Optional<float> rplr;
elad.alond12a8e12017-03-23 11:04:48 -0700435 {
436 rtc::CritScope lock(&packet_loss_tracker_cs_);
437 packet_loss_tracker_.OnPacketFeedbackVector(packet_feedback_vector);
438 plr = packet_loss_tracker_.GetPacketLossRate();
elad.alondadb4dc2017-03-23 15:29:50 -0700439 rplr = packet_loss_tracker_.GetRecoverablePacketLossRate();
elad.alond12a8e12017-03-23 11:04:48 -0700440 }
eladalonedd6eea2017-05-25 00:15:35 -0700441 // TODO(eladalon): If R/PLR go back to unknown, no indication is given that
elad.alond12a8e12017-03-23 11:04:48 -0700442 // the previously sent value is no longer relevant. This will be taken care
443 // of with some refactoring which is now being done.
444 if (plr) {
445 channel_proxy_->OnTwccBasedUplinkPacketLossRate(*plr);
446 }
elad.alondadb4dc2017-03-23 15:29:50 -0700447 if (rplr) {
448 channel_proxy_->OnRecoverableUplinkPacketLossRate(*rplr);
449 }
elad.alond12a8e12017-03-23 11:04:48 -0700450}
451
michaelt79e05882016-11-08 02:50:09 -0800452void AudioSendStream::SetTransportOverhead(int transport_overhead_per_packet) {
elad.alond12a8e12017-03-23 11:04:48 -0700453 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Sebastian Janssone4be6da2018-02-15 16:51:41 +0100454 transport_->SetTransportOverhead(transport_overhead_per_packet);
michaelt79e05882016-11-08 02:50:09 -0800455 channel_proxy_->SetTransportOverhead(transport_overhead_per_packet);
456}
457
ossuc3d4b482017-05-23 06:07:11 -0700458RtpState AudioSendStream::GetRtpState() const {
459 return rtp_rtcp_module_->GetRtpState();
460}
461
Fredrik Solenberg8f5787a2018-01-11 13:52:30 +0100462const voe::ChannelProxy& AudioSendStream::GetChannelProxy() const {
463 RTC_DCHECK(channel_proxy_.get());
464 return *channel_proxy_.get();
465}
466
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100467internal::AudioState* AudioSendStream::audio_state() {
468 internal::AudioState* audio_state =
469 static_cast<internal::AudioState*>(audio_state_.get());
470 RTC_DCHECK(audio_state);
471 return audio_state;
472}
473
474const internal::AudioState* AudioSendStream::audio_state() const {
475 internal::AudioState* audio_state =
476 static_cast<internal::AudioState*>(audio_state_.get());
477 RTC_DCHECK(audio_state);
478 return audio_state;
479}
480
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100481void AudioSendStream::StoreEncoderProperties(int sample_rate_hz,
482 size_t num_channels) {
483 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
484 encoder_sample_rate_hz_ = sample_rate_hz;
485 encoder_num_channels_ = num_channels;
486 if (sending_) {
487 // Update AudioState's information about the stream.
488 audio_state()->AddSendingStream(this, sample_rate_hz, num_channels);
489 }
490}
491
minyue7a973442016-10-20 03:27:12 -0700492// Apply current codec settings to a single voe::Channel used for sending.
ossu20a4b3f2017-04-27 02:08:52 -0700493bool AudioSendStream::SetupSendCodec(AudioSendStream* stream,
494 const Config& new_config) {
495 RTC_DCHECK(new_config.send_codec_spec);
496 const auto& spec = *new_config.send_codec_spec;
minyue48368ad2017-05-10 04:06:11 -0700497
498 RTC_DCHECK(new_config.encoder_factory);
ossu20a4b3f2017-04-27 02:08:52 -0700499 std::unique_ptr<AudioEncoder> encoder =
500 new_config.encoder_factory->MakeAudioEncoder(spec.payload_type,
501 spec.format);
minyue7a973442016-10-20 03:27:12 -0700502
ossu20a4b3f2017-04-27 02:08:52 -0700503 if (!encoder) {
Jonas Olsson24ea8222018-01-25 10:14:29 +0100504 RTC_DLOG(LS_ERROR) << "Unable to create encoder for " << spec.format;
ossu20a4b3f2017-04-27 02:08:52 -0700505 return false;
506 }
507 // If a bitrate has been specified for the codec, use it over the
508 // codec's default.
509 if (spec.target_bitrate_bps) {
510 encoder->OnReceivedTargetAudioBitrate(*spec.target_bitrate_bps);
minyue7a973442016-10-20 03:27:12 -0700511 }
512
ossu20a4b3f2017-04-27 02:08:52 -0700513 // Enable ANA if configured (currently only used by Opus).
514 if (new_config.audio_network_adaptor_config) {
515 if (encoder->EnableAudioNetworkAdaptor(
516 *new_config.audio_network_adaptor_config, stream->event_log_)) {
Jonas Olsson24ea8222018-01-25 10:14:29 +0100517 RTC_DLOG(LS_INFO) << "Audio network adaptor enabled on SSRC "
518 << new_config.rtp.ssrc;
ossu20a4b3f2017-04-27 02:08:52 -0700519 } else {
520 RTC_NOTREACHED();
minyue6b825df2016-10-31 04:08:32 -0700521 }
minyue7a973442016-10-20 03:27:12 -0700522 }
523
ossu20a4b3f2017-04-27 02:08:52 -0700524 // Wrap the encoder in a an AudioEncoderCNG, if VAD is enabled.
525 if (spec.cng_payload_type) {
526 AudioEncoderCng::Config cng_config;
527 cng_config.num_channels = encoder->NumChannels();
528 cng_config.payload_type = *spec.cng_payload_type;
529 cng_config.speech_encoder = std::move(encoder);
530 cng_config.vad_mode = Vad::kVadNormal;
531 encoder.reset(new AudioEncoderCng(std::move(cng_config)));
ossu3b9ff382017-04-27 08:03:42 -0700532
533 stream->RegisterCngPayloadType(
534 *spec.cng_payload_type,
535 new_config.send_codec_spec->format.clockrate_hz);
minyue7a973442016-10-20 03:27:12 -0700536 }
ossu20a4b3f2017-04-27 02:08:52 -0700537
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100538 stream->StoreEncoderProperties(encoder->SampleRateHz(),
539 encoder->NumChannels());
ossu20a4b3f2017-04-27 02:08:52 -0700540 stream->channel_proxy_->SetEncoder(new_config.send_codec_spec->payload_type,
541 std::move(encoder));
minyue7a973442016-10-20 03:27:12 -0700542 return true;
543}
544
ossu20a4b3f2017-04-27 02:08:52 -0700545bool AudioSendStream::ReconfigureSendCodec(AudioSendStream* stream,
546 const Config& new_config) {
547 const auto& old_config = stream->config_;
minyue-webrtc8de18262017-07-26 14:18:40 +0200548
549 if (!new_config.send_codec_spec) {
550 // We cannot de-configure a send codec. So we will do nothing.
551 // By design, the send codec should have not been configured.
552 RTC_DCHECK(!old_config.send_codec_spec);
553 return true;
554 }
555
556 if (new_config.send_codec_spec == old_config.send_codec_spec &&
557 new_config.audio_network_adaptor_config ==
558 old_config.audio_network_adaptor_config) {
ossu20a4b3f2017-04-27 02:08:52 -0700559 return true;
560 }
561
562 // If we have no encoder, or the format or payload type's changed, create a
563 // new encoder.
564 if (!old_config.send_codec_spec ||
565 new_config.send_codec_spec->format !=
566 old_config.send_codec_spec->format ||
567 new_config.send_codec_spec->payload_type !=
568 old_config.send_codec_spec->payload_type) {
569 return SetupSendCodec(stream, new_config);
570 }
571
ossu20a4b3f2017-04-27 02:08:52 -0700572 const rtc::Optional<int>& new_target_bitrate_bps =
573 new_config.send_codec_spec->target_bitrate_bps;
574 // If a bitrate has been specified for the codec, use it over the
575 // codec's default.
576 if (new_target_bitrate_bps &&
577 new_target_bitrate_bps !=
578 old_config.send_codec_spec->target_bitrate_bps) {
579 CallEncoder(stream->channel_proxy_, [&](AudioEncoder* encoder) {
580 encoder->OnReceivedTargetAudioBitrate(*new_target_bitrate_bps);
581 });
582 }
583
584 ReconfigureANA(stream, new_config);
585 ReconfigureCNG(stream, new_config);
586
587 return true;
588}
589
590void AudioSendStream::ReconfigureANA(AudioSendStream* stream,
591 const Config& new_config) {
592 if (new_config.audio_network_adaptor_config ==
593 stream->config_.audio_network_adaptor_config) {
594 return;
595 }
596 if (new_config.audio_network_adaptor_config) {
597 CallEncoder(stream->channel_proxy_, [&](AudioEncoder* encoder) {
598 if (encoder->EnableAudioNetworkAdaptor(
599 *new_config.audio_network_adaptor_config, stream->event_log_)) {
Jonas Olsson24ea8222018-01-25 10:14:29 +0100600 RTC_DLOG(LS_INFO) << "Audio network adaptor enabled on SSRC "
601 << new_config.rtp.ssrc;
ossu20a4b3f2017-04-27 02:08:52 -0700602 } else {
603 RTC_NOTREACHED();
604 }
605 });
606 } else {
607 CallEncoder(stream->channel_proxy_, [&](AudioEncoder* encoder) {
608 encoder->DisableAudioNetworkAdaptor();
609 });
Jonas Olsson24ea8222018-01-25 10:14:29 +0100610 RTC_DLOG(LS_INFO) << "Audio network adaptor disabled on SSRC "
611 << new_config.rtp.ssrc;
ossu20a4b3f2017-04-27 02:08:52 -0700612 }
613}
614
615void AudioSendStream::ReconfigureCNG(AudioSendStream* stream,
616 const Config& new_config) {
617 if (new_config.send_codec_spec->cng_payload_type ==
618 stream->config_.send_codec_spec->cng_payload_type) {
619 return;
620 }
621
ossu3b9ff382017-04-27 08:03:42 -0700622 // Register the CNG payload type if it's been added, don't do anything if CNG
623 // is removed. Payload types must not be redefined.
624 if (new_config.send_codec_spec->cng_payload_type) {
625 stream->RegisterCngPayloadType(
626 *new_config.send_codec_spec->cng_payload_type,
627 new_config.send_codec_spec->format.clockrate_hz);
628 }
629
ossu20a4b3f2017-04-27 02:08:52 -0700630 // Wrap or unwrap the encoder in an AudioEncoderCNG.
631 stream->channel_proxy_->ModifyEncoder(
632 [&](std::unique_ptr<AudioEncoder>* encoder_ptr) {
633 std::unique_ptr<AudioEncoder> old_encoder(std::move(*encoder_ptr));
634 auto sub_encoders = old_encoder->ReclaimContainedEncoders();
635 if (!sub_encoders.empty()) {
636 // Replace enc with its sub encoder. We need to put the sub
637 // encoder in a temporary first, since otherwise the old value
638 // of enc would be destroyed before the new value got assigned,
639 // which would be bad since the new value is a part of the old
640 // value.
641 auto tmp = std::move(sub_encoders[0]);
642 old_encoder = std::move(tmp);
643 }
644 if (new_config.send_codec_spec->cng_payload_type) {
645 AudioEncoderCng::Config config;
646 config.speech_encoder = std::move(old_encoder);
647 config.num_channels = config.speech_encoder->NumChannels();
648 config.payload_type = *new_config.send_codec_spec->cng_payload_type;
649 config.vad_mode = Vad::kVadNormal;
650 encoder_ptr->reset(new AudioEncoderCng(std::move(config)));
651 } else {
652 *encoder_ptr = std::move(old_encoder);
653 }
654 });
655}
656
657void AudioSendStream::ReconfigureBitrateObserver(
658 AudioSendStream* stream,
659 const webrtc::AudioSendStream::Config& new_config) {
660 // Since the Config's default is for both of these to be -1, this test will
661 // allow us to configure the bitrate observer if the new config has bitrate
662 // limits set, but would only have us call RemoveBitrateObserver if we were
663 // previously configured with bitrate limits.
Alex Narestcedd3512017-12-07 20:54:55 +0100664 int new_transport_seq_num_id =
665 FindExtensionIds(new_config.rtp.extensions).transport_sequence_number;
ossu20a4b3f2017-04-27 02:08:52 -0700666 if (stream->config_.min_bitrate_bps == new_config.min_bitrate_bps &&
Alex Narestcedd3512017-12-07 20:54:55 +0100667 stream->config_.max_bitrate_bps == new_config.max_bitrate_bps &&
Seth Hampson24722b32017-12-22 09:36:42 -0800668 stream->config_.bitrate_priority == new_config.bitrate_priority &&
Alex Narestcedd3512017-12-07 20:54:55 +0100669 (FindExtensionIds(stream->config_.rtp.extensions)
670 .transport_sequence_number == new_transport_seq_num_id ||
671 !webrtc::field_trial::IsEnabled("WebRTC-Audio-SendSideBwe"))) {
ossu20a4b3f2017-04-27 02:08:52 -0700672 return;
673 }
674
Alex Narestcedd3512017-12-07 20:54:55 +0100675 if (new_config.min_bitrate_bps != -1 && new_config.max_bitrate_bps != -1 &&
676 (new_transport_seq_num_id != 0 ||
677 !webrtc::field_trial::IsEnabled("WebRTC-Audio-SendSideBwe"))) {
ossu20a4b3f2017-04-27 02:08:52 -0700678 stream->ConfigureBitrateObserver(new_config.min_bitrate_bps,
Seth Hampson24722b32017-12-22 09:36:42 -0800679 new_config.max_bitrate_bps,
680 new_config.bitrate_priority);
ossu20a4b3f2017-04-27 02:08:52 -0700681 } else {
682 stream->RemoveBitrateObserver();
683 }
684}
685
686void AudioSendStream::ConfigureBitrateObserver(int min_bitrate_bps,
Seth Hampson24722b32017-12-22 09:36:42 -0800687 int max_bitrate_bps,
688 double bitrate_priority) {
ossu20a4b3f2017-04-27 02:08:52 -0700689 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
690 RTC_DCHECK_GE(max_bitrate_bps, min_bitrate_bps);
691 rtc::Event thread_sync_event(false /* manual_reset */, false);
692 worker_queue_->PostTask([&] {
693 // We may get a callback immediately as the observer is registered, so make
694 // sure the bitrate limits in config_ are up-to-date.
695 config_.min_bitrate_bps = min_bitrate_bps;
696 config_.max_bitrate_bps = max_bitrate_bps;
Seth Hampson24722b32017-12-22 09:36:42 -0800697 config_.bitrate_priority = bitrate_priority;
698 // This either updates the current observer or adds a new observer.
ossu20a4b3f2017-04-27 02:08:52 -0700699 bitrate_allocator_->AddObserver(this, min_bitrate_bps, max_bitrate_bps, 0,
Seth Hampson24722b32017-12-22 09:36:42 -0800700 true, config_.track_id, bitrate_priority);
ossu20a4b3f2017-04-27 02:08:52 -0700701 thread_sync_event.Set();
702 });
703 thread_sync_event.Wait(rtc::Event::kForever);
704}
705
706void AudioSendStream::RemoveBitrateObserver() {
707 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
708 rtc::Event thread_sync_event(false /* manual_reset */, false);
709 worker_queue_->PostTask([this, &thread_sync_event] {
710 bitrate_allocator_->RemoveObserver(this);
711 thread_sync_event.Set();
712 });
713 thread_sync_event.Wait(rtc::Event::kForever);
714}
715
ossu3b9ff382017-04-27 08:03:42 -0700716void AudioSendStream::RegisterCngPayloadType(int payload_type,
717 int clockrate_hz) {
ossu3b9ff382017-04-27 08:03:42 -0700718 const CodecInst codec = {payload_type, "CN", clockrate_hz, 0, 1, 0};
ossuc3d4b482017-05-23 06:07:11 -0700719 if (rtp_rtcp_module_->RegisterSendPayload(codec) != 0) {
720 rtp_rtcp_module_->DeRegisterSendPayload(codec.pltype);
721 if (rtp_rtcp_module_->RegisterSendPayload(codec) != 0) {
Jonas Olsson24ea8222018-01-25 10:14:29 +0100722 RTC_DLOG(LS_ERROR) << "RegisterCngPayloadType() failed to register CN to "
723 "RTP/RTCP module";
ossu3b9ff382017-04-27 08:03:42 -0700724 }
725 }
726}
solenbergc7a8b082015-10-16 14:35:07 -0700727} // namespace internal
728} // namespace webrtc