blob: f0d13e3ee4d5c0a9012260b146a7e377e7c033e8 [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"
18#include "audio/conversion.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020019#include "call/rtp_transport_controller_send_interface.h"
20#include "modules/audio_coding/codecs/cng/audio_encoder_cng.h"
21#include "modules/bitrate_controller/include/bitrate_controller.h"
22#include "modules/congestion_controller/include/send_side_congestion_controller.h"
23#include "modules/pacing/paced_sender.h"
24#include "rtc_base/checks.h"
25#include "rtc_base/event.h"
26#include "rtc_base/function_view.h"
27#include "rtc_base/logging.h"
28#include "rtc_base/task_queue.h"
29#include "rtc_base/timeutils.h"
Alex Narestcedd3512017-12-07 20:54:55 +010030#include "system_wrappers/include/field_trial.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020031#include "voice_engine/channel_proxy.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020032#include "voice_engine/voice_engine_impl.h"
solenbergc7a8b082015-10-16 14:35:07 -070033
34namespace webrtc {
minyue7a973442016-10-20 03:27:12 -070035
solenbergc7a8b082015-10-16 14:35:07 -070036namespace internal {
eladalonedd6eea2017-05-25 00:15:35 -070037// TODO(eladalon): Subsequent CL will make these values experiment-dependent.
elad.alond12a8e12017-03-23 11:04:48 -070038constexpr size_t kPacketLossTrackerMaxWindowSizeMs = 15000;
39constexpr size_t kPacketLossRateMinNumAckedPackets = 50;
40constexpr size_t kRecoverablePacketLossRateMinNumAckedPairs = 40;
41
ossu20a4b3f2017-04-27 02:08:52 -070042namespace {
43void CallEncoder(const std::unique_ptr<voe::ChannelProxy>& channel_proxy,
44 rtc::FunctionView<void(AudioEncoder*)> lambda) {
45 channel_proxy->ModifyEncoder([&](std::unique_ptr<AudioEncoder>* encoder_ptr) {
46 RTC_DCHECK(encoder_ptr);
47 lambda(encoder_ptr->get());
48 });
49}
50} // namespace
51
sazac58f8c02017-07-19 00:39:19 -070052// TODO(saza): Move this declaration further down when we can use
53// std::make_unique.
54class AudioSendStream::TimedTransport : public Transport {
55 public:
56 TimedTransport(Transport* transport, TimeInterval* time_interval)
57 : transport_(transport), lifetime_(time_interval) {}
58 bool SendRtp(const uint8_t* packet,
59 size_t length,
60 const PacketOptions& options) {
61 if (lifetime_) {
62 lifetime_->Extend();
63 }
64 return transport_->SendRtp(packet, length, options);
65 }
66 bool SendRtcp(const uint8_t* packet, size_t length) {
67 return transport_->SendRtcp(packet, length);
68 }
69 ~TimedTransport() {}
70
71 private:
72 Transport* transport_;
73 TimeInterval* lifetime_;
74};
75
solenberg566ef242015-11-06 15:34:49 -080076AudioSendStream::AudioSendStream(
77 const webrtc::AudioSendStream::Config& config,
Stefan Holmerb86d4e42015-12-07 10:26:18 +010078 const rtc::scoped_refptr<webrtc::AudioState>& audio_state,
perkj26091b12016-09-01 01:17:40 -070079 rtc::TaskQueue* worker_queue,
nisseb8f9a322017-03-27 05:36:15 -070080 RtpTransportControllerSendInterface* transport,
tereliuse035e2d2016-09-21 06:51:47 -070081 BitrateAllocator* bitrate_allocator,
michaelt9332b7d2016-11-30 07:51:13 -080082 RtcEventLog* event_log,
ossuc3d4b482017-05-23 06:07:11 -070083 RtcpRttStats* rtcp_rtt_stats,
84 const rtc::Optional<RtpState>& suspended_rtp_state)
perkj26091b12016-09-01 01:17:40 -070085 : worker_queue_(worker_queue),
ossu20a4b3f2017-04-27 02:08:52 -070086 config_(Config(nullptr)),
mflodman86cc6ff2016-07-26 04:44:06 -070087 audio_state_(audio_state),
ossu20a4b3f2017-04-27 02:08:52 -070088 event_log_(event_log),
michaeltf4caaab2017-01-16 23:55:07 -080089 bitrate_allocator_(bitrate_allocator),
nisseb8f9a322017-03-27 05:36:15 -070090 transport_(transport),
elad.alond12a8e12017-03-23 11:04:48 -070091 packet_loss_tracker_(kPacketLossTrackerMaxWindowSizeMs,
92 kPacketLossRateMinNumAckedPackets,
ossuc3d4b482017-05-23 06:07:11 -070093 kRecoverablePacketLossRateMinNumAckedPairs),
94 rtp_rtcp_module_(nullptr),
95 suspended_rtp_state_(suspended_rtp_state) {
Mirko Bonadei675513b2017-11-09 11:09:25 +010096 RTC_LOG(LS_INFO) << "AudioSendStream: " << config.ToString();
ossu20a4b3f2017-04-27 02:08:52 -070097 RTC_DCHECK_NE(config.voe_channel_id, -1);
solenberg566ef242015-11-06 15:34:49 -080098 RTC_DCHECK(audio_state_.get());
nisseb8f9a322017-03-27 05:36:15 -070099 RTC_DCHECK(transport);
100 RTC_DCHECK(transport->send_side_cc());
solenberg3a941542015-11-16 07:34:50 -0800101
solenberg13725082015-11-25 08:16:52 -0800102 VoiceEngineImpl* voe_impl = static_cast<VoiceEngineImpl*>(voice_engine());
ossu20a4b3f2017-04-27 02:08:52 -0700103 channel_proxy_ = voe_impl->GetChannelProxy(config.voe_channel_id);
104 channel_proxy_->SetRtcEventLog(event_log_);
michaelt9332b7d2016-11-30 07:51:13 -0800105 channel_proxy_->SetRtcpRttStats(rtcp_rtt_stats);
solenberg13725082015-11-25 08:16:52 -0800106 channel_proxy_->SetRTCPStatus(true);
ossuc3d4b482017-05-23 06:07:11 -0700107 RtpReceiver* rtpReceiver = nullptr; // Unused, but required for call.
108 channel_proxy_->GetRtpRtcp(&rtp_rtcp_module_, &rtpReceiver);
109 RTC_DCHECK(rtp_rtcp_module_);
mflodman3d7db262016-04-29 00:57:13 -0700110
ossu20a4b3f2017-04-27 02:08:52 -0700111 ConfigureStream(this, config, true);
elad.alond12a8e12017-03-23 11:04:48 -0700112
113 pacer_thread_checker_.DetachFromThread();
Danil Chapovalov90e1f532017-10-03 14:59:27 +0200114 // Signal congestion controller this object is ready for OnPacket* callbacks.
115 transport_->send_side_cc()->RegisterPacketFeedbackObserver(this);
solenbergc7a8b082015-10-16 14:35:07 -0700116}
117
118AudioSendStream::~AudioSendStream() {
elad.alond12a8e12017-03-23 11:04:48 -0700119 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Mirko Bonadei675513b2017-11-09 11:09:25 +0100120 RTC_LOG(LS_INFO) << "~AudioSendStream: " << config_.ToString();
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100121 RTC_DCHECK(!sending_);
nisseb8f9a322017-03-27 05:36:15 -0700122 transport_->send_side_cc()->DeRegisterPacketFeedbackObserver(this);
solenberg1c239d42017-09-29 06:00:28 -0700123 channel_proxy_->RegisterTransport(nullptr);
nissefdbfdc92017-03-31 05:44:52 -0700124 channel_proxy_->ResetSenderCongestionControlObjects();
tereliuse035e2d2016-09-21 06:51:47 -0700125 channel_proxy_->SetRtcEventLog(nullptr);
michaelt9332b7d2016-11-30 07:51:13 -0800126 channel_proxy_->SetRtcpRttStats(nullptr);
solenbergc7a8b082015-10-16 14:35:07 -0700127}
128
eladalonabbc4302017-07-26 02:09:44 -0700129const webrtc::AudioSendStream::Config& AudioSendStream::GetConfig() const {
130 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
131 return config_;
132}
133
ossu20a4b3f2017-04-27 02:08:52 -0700134void AudioSendStream::Reconfigure(
135 const webrtc::AudioSendStream::Config& new_config) {
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100136 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
ossu20a4b3f2017-04-27 02:08:52 -0700137 ConfigureStream(this, new_config, false);
138}
139
Alex Narestcedd3512017-12-07 20:54:55 +0100140AudioSendStream::ExtensionIds AudioSendStream::FindExtensionIds(
141 const std::vector<RtpExtension>& extensions) {
142 ExtensionIds ids;
143 for (const auto& extension : extensions) {
144 if (extension.uri == RtpExtension::kAudioLevelUri) {
145 ids.audio_level = extension.id;
146 } else if (extension.uri == RtpExtension::kTransportSequenceNumberUri) {
147 ids.transport_sequence_number = extension.id;
148 }
149 }
150 return ids;
151}
152
ossu20a4b3f2017-04-27 02:08:52 -0700153void AudioSendStream::ConfigureStream(
154 webrtc::internal::AudioSendStream* stream,
155 const webrtc::AudioSendStream::Config& new_config,
156 bool first_time) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100157 RTC_LOG(LS_INFO) << "AudioSendStream::Configuring: " << new_config.ToString();
ossu20a4b3f2017-04-27 02:08:52 -0700158 const auto& channel_proxy = stream->channel_proxy_;
159 const auto& old_config = stream->config_;
160
161 if (first_time || old_config.rtp.ssrc != new_config.rtp.ssrc) {
162 channel_proxy->SetLocalSSRC(new_config.rtp.ssrc);
ossuc3d4b482017-05-23 06:07:11 -0700163 if (stream->suspended_rtp_state_) {
164 stream->rtp_rtcp_module_->SetRtpState(*stream->suspended_rtp_state_);
165 }
ossu20a4b3f2017-04-27 02:08:52 -0700166 }
167 if (first_time || old_config.rtp.c_name != new_config.rtp.c_name) {
168 channel_proxy->SetRTCP_CNAME(new_config.rtp.c_name);
169 }
170 // TODO(solenberg): Config NACK history window (which is a packet count),
171 // using the actual packet size for the configured codec.
172 if (first_time || old_config.rtp.nack.rtp_history_ms !=
173 new_config.rtp.nack.rtp_history_ms) {
174 channel_proxy->SetNACKStatus(new_config.rtp.nack.rtp_history_ms != 0,
175 new_config.rtp.nack.rtp_history_ms / 20);
176 }
177
178 if (first_time ||
179 new_config.send_transport != old_config.send_transport) {
180 if (old_config.send_transport) {
solenberg1c239d42017-09-29 06:00:28 -0700181 channel_proxy->RegisterTransport(nullptr);
ossu20a4b3f2017-04-27 02:08:52 -0700182 }
sazac58f8c02017-07-19 00:39:19 -0700183 if (new_config.send_transport) {
184 stream->timed_send_transport_adapter_.reset(new TimedTransport(
185 new_config.send_transport, &stream->active_lifetime_));
186 } else {
187 stream->timed_send_transport_adapter_.reset(nullptr);
188 }
solenberg1c239d42017-09-29 06:00:28 -0700189 channel_proxy->RegisterTransport(
sazac58f8c02017-07-19 00:39:19 -0700190 stream->timed_send_transport_adapter_.get());
ossu20a4b3f2017-04-27 02:08:52 -0700191 }
192
Alex Narestcedd3512017-12-07 20:54:55 +0100193 const ExtensionIds old_ids = FindExtensionIds(old_config.rtp.extensions);
194 const ExtensionIds new_ids = FindExtensionIds(new_config.rtp.extensions);
ossu20a4b3f2017-04-27 02:08:52 -0700195 // Audio level indication
196 if (first_time || new_ids.audio_level != old_ids.audio_level) {
197 channel_proxy->SetSendAudioLevelIndicationStatus(new_ids.audio_level != 0,
198 new_ids.audio_level);
199 }
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100200 bool transport_seq_num_id_changed =
201 new_ids.transport_sequence_number != old_ids.transport_sequence_number;
202 if (first_time || transport_seq_num_id_changed) {
ossu1129df22017-06-30 01:38:56 -0700203 if (!first_time) {
ossu20a4b3f2017-04-27 02:08:52 -0700204 channel_proxy->ResetSenderCongestionControlObjects();
ossu20a4b3f2017-04-27 02:08:52 -0700205 }
206
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100207 RtcpBandwidthObserver* bandwidth_observer = nullptr;
208 bool has_transport_sequence_number = new_ids.transport_sequence_number != 0;
209 if (has_transport_sequence_number) {
ossu20a4b3f2017-04-27 02:08:52 -0700210 channel_proxy->EnableSendTransportSequenceNumber(
211 new_ids.transport_sequence_number);
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100212 // Probing in application limited region is only used in combination with
213 // send side congestion control, wich depends on feedback packets which
214 // requires transport sequence numbers to be enabled.
ossu20a4b3f2017-04-27 02:08:52 -0700215 stream->transport_->send_side_cc()->EnablePeriodicAlrProbing(true);
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100216 bandwidth_observer =
217 stream->transport_->send_side_cc()->GetBandwidthObserver();
ossu20a4b3f2017-04-27 02:08:52 -0700218 }
219
Sebastian Jansson8d9c5402017-11-15 17:22:16 +0100220 channel_proxy->RegisterSenderCongestionControlObjects(stream->transport_,
221 bandwidth_observer);
ossu20a4b3f2017-04-27 02:08:52 -0700222 }
223
224 if (!ReconfigureSendCodec(stream, new_config)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100225 RTC_LOG(LS_ERROR) << "Failed to set up send codec state.";
ossu20a4b3f2017-04-27 02:08:52 -0700226 }
227
228 ReconfigureBitrateObserver(stream, new_config);
229 stream->config_ = new_config;
230}
231
solenberg3a941542015-11-16 07:34:50 -0800232void AudioSendStream::Start() {
elad.alond12a8e12017-03-23 11:04:48 -0700233 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100234 if (sending_) {
235 return;
236 }
237
Alex Narestcedd3512017-12-07 20:54:55 +0100238 if (config_.min_bitrate_bps != -1 && config_.max_bitrate_bps != -1 &&
239 (FindExtensionIds(config_.rtp.extensions).transport_sequence_number !=
240 0 ||
241 !webrtc::field_trial::IsEnabled("WebRTC-Audio-SendSideBwe"))) {
Alex Narest78609d52017-10-20 10:37:47 +0200242 // Audio BWE is enabled.
243 transport_->packet_sender()->SetAccountForAudioPackets(true);
ossu20a4b3f2017-04-27 02:08:52 -0700244 ConfigureBitrateObserver(config_.min_bitrate_bps, config_.max_bitrate_bps);
mflodman86cc6ff2016-07-26 04:44:06 -0700245 }
Fredrik Solenbergaaedf752017-12-18 13:09:12 +0100246 channel_proxy_->StartSend();
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100247 sending_ = true;
248 audio_state()->AddSendingStream(this, encoder_sample_rate_hz_,
249 encoder_num_channels_);
solenberg3a941542015-11-16 07:34:50 -0800250}
251
252void AudioSendStream::Stop() {
elad.alond12a8e12017-03-23 11:04:48 -0700253 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100254 if (!sending_) {
255 return;
256 }
257
ossu20a4b3f2017-04-27 02:08:52 -0700258 RemoveBitrateObserver();
Fredrik Solenbergaaedf752017-12-18 13:09:12 +0100259 channel_proxy_->StopSend();
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100260 sending_ = false;
261 audio_state()->RemoveSendingStream(this);
262}
263
264void AudioSendStream::SendAudioData(std::unique_ptr<AudioFrame> audio_frame) {
265 RTC_CHECK_RUNS_SERIALIZED(&audio_capture_race_checker_);
266 channel_proxy_->ProcessAndEncodeAudio(std::move(audio_frame));
solenberg3a941542015-11-16 07:34:50 -0800267}
268
solenbergffbbcac2016-11-17 05:25:37 -0800269bool AudioSendStream::SendTelephoneEvent(int payload_type,
270 int payload_frequency, int event,
solenberg8842c3e2016-03-11 03:06:41 -0800271 int duration_ms) {
elad.alond12a8e12017-03-23 11:04:48 -0700272 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
solenbergffbbcac2016-11-17 05:25:37 -0800273 return channel_proxy_->SetSendTelephoneEventPayloadType(payload_type,
274 payload_frequency) &&
Fredrik Solenbergb5727682015-12-04 15:22:19 +0100275 channel_proxy_->SendTelephoneEventOutband(event, duration_ms);
276}
277
solenberg94218532016-06-16 10:53:22 -0700278void AudioSendStream::SetMuted(bool muted) {
elad.alond12a8e12017-03-23 11:04:48 -0700279 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
solenberg94218532016-06-16 10:53:22 -0700280 channel_proxy_->SetInputMute(muted);
281}
282
solenbergc7a8b082015-10-16 14:35:07 -0700283webrtc::AudioSendStream::Stats AudioSendStream::GetStats() const {
Ivo Creusen56d46092017-11-24 17:29:59 +0100284 return GetStats(true);
285}
286
287webrtc::AudioSendStream::Stats AudioSendStream::GetStats(
288 bool has_remote_tracks) const {
elad.alond12a8e12017-03-23 11:04:48 -0700289 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
solenberg85a04962015-10-27 03:35:21 -0700290 webrtc::AudioSendStream::Stats stats;
291 stats.local_ssrc = config_.rtp.ssrc;
solenberg85a04962015-10-27 03:35:21 -0700292
solenberg358057b2015-11-27 10:46:42 -0800293 webrtc::CallStatistics call_stats = channel_proxy_->GetRTCPStatistics();
solenberg85a04962015-10-27 03:35:21 -0700294 stats.bytes_sent = call_stats.bytesSent;
295 stats.packets_sent = call_stats.packetsSent;
solenberg8b85de22015-11-16 09:48:04 -0800296 // RTT isn't known until a RTCP report is received. Until then, VoiceEngine
297 // returns 0 to indicate an error value.
298 if (call_stats.rttMs > 0) {
299 stats.rtt_ms = call_stats.rttMs;
300 }
ossu20a4b3f2017-04-27 02:08:52 -0700301 if (config_.send_codec_spec) {
302 const auto& spec = *config_.send_codec_spec;
303 stats.codec_name = spec.format.name;
Oskar Sundbom2707fb22017-11-16 10:57:35 +0100304 stats.codec_payload_type = spec.payload_type;
solenberg85a04962015-10-27 03:35:21 -0700305
306 // Get data from the last remote RTCP report.
solenberg358057b2015-11-27 10:46:42 -0800307 for (const auto& block : channel_proxy_->GetRemoteRTCPReportBlocks()) {
solenberg8b85de22015-11-16 09:48:04 -0800308 // Lookup report for send ssrc only.
309 if (block.source_SSRC == stats.local_ssrc) {
310 stats.packets_lost = block.cumulative_num_packets_lost;
311 stats.fraction_lost = Q8ToFloat(block.fraction_lost);
312 stats.ext_seqnum = block.extended_highest_sequence_number;
ossu20a4b3f2017-04-27 02:08:52 -0700313 // Convert timestamps to milliseconds.
314 if (spec.format.clockrate_hz / 1000 > 0) {
solenberg8b85de22015-11-16 09:48:04 -0800315 stats.jitter_ms =
ossu20a4b3f2017-04-27 02:08:52 -0700316 block.interarrival_jitter / (spec.format.clockrate_hz / 1000);
solenberg85a04962015-10-27 03:35:21 -0700317 }
solenberg8b85de22015-11-16 09:48:04 -0800318 break;
solenberg85a04962015-10-27 03:35:21 -0700319 }
320 }
321 }
322
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100323 AudioState::Stats input_stats = audio_state()->GetAudioInputStats();
324 stats.audio_level = input_stats.audio_level;
325 stats.total_input_energy = input_stats.total_energy;
326 stats.total_input_duration = input_stats.total_duration;
solenberg796b8f92017-03-01 17:02:23 -0800327
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100328 stats.typing_noise_detected = audio_state()->typing_noise_detected();
ivoce1198e02017-09-08 08:13:19 -0700329 stats.ana_statistics = channel_proxy_->GetANAStatistics();
Ivo Creusen56d46092017-11-24 17:29:59 +0100330 RTC_DCHECK(audio_state_->audio_processing());
331 stats.apm_statistics =
332 audio_state_->audio_processing()->GetStatistics(has_remote_tracks);
solenberg85a04962015-10-27 03:35:21 -0700333
334 return stats;
335}
336
pbos1ba8d392016-05-01 20:18:34 -0700337void AudioSendStream::SignalNetworkState(NetworkState state) {
elad.alond12a8e12017-03-23 11:04:48 -0700338 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
pbos1ba8d392016-05-01 20:18:34 -0700339}
340
341bool AudioSendStream::DeliverRtcp(const uint8_t* packet, size_t length) {
342 // TODO(solenberg): Tests call this function on a network thread, libjingle
343 // calls on the worker thread. We should move towards always using a network
344 // thread. Then this check can be enabled.
elad.alond12a8e12017-03-23 11:04:48 -0700345 // RTC_DCHECK(!worker_thread_checker_.CalledOnValidThread());
pbos1ba8d392016-05-01 20:18:34 -0700346 return channel_proxy_->ReceivedRTCPPacket(packet, length);
347}
348
mflodman86cc6ff2016-07-26 04:44:06 -0700349uint32_t AudioSendStream::OnBitrateUpdated(uint32_t bitrate_bps,
350 uint8_t fraction_loss,
minyue78b4d562016-11-30 04:47:39 -0800351 int64_t rtt,
minyue93e45222017-05-18 14:32:41 -0700352 int64_t bwe_period_ms) {
stefanfca900a2017-04-10 03:53:00 -0700353 // A send stream may be allocated a bitrate of zero if the allocator decides
354 // to disable it. For now we ignore this decision and keep sending on min
355 // bitrate.
356 if (bitrate_bps == 0) {
357 bitrate_bps = config_.min_bitrate_bps;
358 }
mflodman86cc6ff2016-07-26 04:44:06 -0700359 RTC_DCHECK_GE(bitrate_bps,
minyue10cbb462016-11-07 09:29:22 -0800360 static_cast<uint32_t>(config_.min_bitrate_bps));
mflodman86cc6ff2016-07-26 04:44:06 -0700361 // The bitrate allocator might allocate an higher than max configured bitrate
362 // if there is room, to allow for, as example, extra FEC. Ignore that for now.
minyue10cbb462016-11-07 09:29:22 -0800363 const uint32_t max_bitrate_bps = config_.max_bitrate_bps;
mflodman86cc6ff2016-07-26 04:44:06 -0700364 if (bitrate_bps > max_bitrate_bps)
365 bitrate_bps = max_bitrate_bps;
366
minyue93e45222017-05-18 14:32:41 -0700367 channel_proxy_->SetBitrate(bitrate_bps, bwe_period_ms);
mflodman86cc6ff2016-07-26 04:44:06 -0700368
369 // The amount of audio protection is not exposed by the encoder, hence
370 // always returning 0.
371 return 0;
372}
373
elad.alond12a8e12017-03-23 11:04:48 -0700374void AudioSendStream::OnPacketAdded(uint32_t ssrc, uint16_t seq_num) {
375 RTC_DCHECK(pacer_thread_checker_.CalledOnValidThread());
376 // Only packets that belong to this stream are of interest.
377 if (ssrc == config_.rtp.ssrc) {
378 rtc::CritScope lock(&packet_loss_tracker_cs_);
eladalonedd6eea2017-05-25 00:15:35 -0700379 // TODO(eladalon): This function call could potentially reset the window,
elad.alond12a8e12017-03-23 11:04:48 -0700380 // setting both PLR and RPLR to unknown. Consider (during upcoming
381 // refactoring) passing an indication of such an event.
382 packet_loss_tracker_.OnPacketAdded(seq_num, rtc::TimeMillis());
383 }
384}
385
386void AudioSendStream::OnPacketFeedbackVector(
387 const std::vector<PacketFeedback>& packet_feedback_vector) {
eladalon3651fdd2017-08-24 07:26:25 -0700388 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
elad.alond12a8e12017-03-23 11:04:48 -0700389 rtc::Optional<float> plr;
elad.alondadb4dc2017-03-23 15:29:50 -0700390 rtc::Optional<float> rplr;
elad.alond12a8e12017-03-23 11:04:48 -0700391 {
392 rtc::CritScope lock(&packet_loss_tracker_cs_);
393 packet_loss_tracker_.OnPacketFeedbackVector(packet_feedback_vector);
394 plr = packet_loss_tracker_.GetPacketLossRate();
elad.alondadb4dc2017-03-23 15:29:50 -0700395 rplr = packet_loss_tracker_.GetRecoverablePacketLossRate();
elad.alond12a8e12017-03-23 11:04:48 -0700396 }
eladalonedd6eea2017-05-25 00:15:35 -0700397 // TODO(eladalon): If R/PLR go back to unknown, no indication is given that
elad.alond12a8e12017-03-23 11:04:48 -0700398 // the previously sent value is no longer relevant. This will be taken care
399 // of with some refactoring which is now being done.
400 if (plr) {
401 channel_proxy_->OnTwccBasedUplinkPacketLossRate(*plr);
402 }
elad.alondadb4dc2017-03-23 15:29:50 -0700403 if (rplr) {
404 channel_proxy_->OnRecoverableUplinkPacketLossRate(*rplr);
405 }
elad.alond12a8e12017-03-23 11:04:48 -0700406}
407
michaelt79e05882016-11-08 02:50:09 -0800408void AudioSendStream::SetTransportOverhead(int transport_overhead_per_packet) {
elad.alond12a8e12017-03-23 11:04:48 -0700409 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
nisseb8f9a322017-03-27 05:36:15 -0700410 transport_->send_side_cc()->SetTransportOverhead(
411 transport_overhead_per_packet);
michaelt79e05882016-11-08 02:50:09 -0800412 channel_proxy_->SetTransportOverhead(transport_overhead_per_packet);
413}
414
ossuc3d4b482017-05-23 06:07:11 -0700415RtpState AudioSendStream::GetRtpState() const {
416 return rtp_rtcp_module_->GetRtpState();
417}
418
sazac58f8c02017-07-19 00:39:19 -0700419const TimeInterval& AudioSendStream::GetActiveLifetime() const {
420 return active_lifetime_;
421}
422
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100423internal::AudioState* AudioSendStream::audio_state() {
424 internal::AudioState* audio_state =
425 static_cast<internal::AudioState*>(audio_state_.get());
426 RTC_DCHECK(audio_state);
427 return audio_state;
428}
429
430const internal::AudioState* AudioSendStream::audio_state() const {
431 internal::AudioState* audio_state =
432 static_cast<internal::AudioState*>(audio_state_.get());
433 RTC_DCHECK(audio_state);
434 return audio_state;
435}
436
solenberg3a941542015-11-16 07:34:50 -0800437VoiceEngine* AudioSendStream::voice_engine() const {
438 internal::AudioState* audio_state =
439 static_cast<internal::AudioState*>(audio_state_.get());
440 VoiceEngine* voice_engine = audio_state->voice_engine();
441 RTC_DCHECK(voice_engine);
442 return voice_engine;
solenbergc7a8b082015-10-16 14:35:07 -0700443}
minyue7a973442016-10-20 03:27:12 -0700444
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100445void AudioSendStream::StoreEncoderProperties(int sample_rate_hz,
446 size_t num_channels) {
447 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
448 encoder_sample_rate_hz_ = sample_rate_hz;
449 encoder_num_channels_ = num_channels;
450 if (sending_) {
451 // Update AudioState's information about the stream.
452 audio_state()->AddSendingStream(this, sample_rate_hz, num_channels);
453 }
454}
455
minyue7a973442016-10-20 03:27:12 -0700456// Apply current codec settings to a single voe::Channel used for sending.
ossu20a4b3f2017-04-27 02:08:52 -0700457bool AudioSendStream::SetupSendCodec(AudioSendStream* stream,
458 const Config& new_config) {
459 RTC_DCHECK(new_config.send_codec_spec);
460 const auto& spec = *new_config.send_codec_spec;
minyue48368ad2017-05-10 04:06:11 -0700461
462 RTC_DCHECK(new_config.encoder_factory);
ossu20a4b3f2017-04-27 02:08:52 -0700463 std::unique_ptr<AudioEncoder> encoder =
464 new_config.encoder_factory->MakeAudioEncoder(spec.payload_type,
465 spec.format);
minyue7a973442016-10-20 03:27:12 -0700466
ossu20a4b3f2017-04-27 02:08:52 -0700467 if (!encoder) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100468 RTC_LOG(LS_ERROR) << "Unable to create encoder for " << spec.format;
ossu20a4b3f2017-04-27 02:08:52 -0700469 return false;
470 }
471 // If a bitrate has been specified for the codec, use it over the
472 // codec's default.
473 if (spec.target_bitrate_bps) {
474 encoder->OnReceivedTargetAudioBitrate(*spec.target_bitrate_bps);
minyue7a973442016-10-20 03:27:12 -0700475 }
476
ossu20a4b3f2017-04-27 02:08:52 -0700477 // Enable ANA if configured (currently only used by Opus).
478 if (new_config.audio_network_adaptor_config) {
479 if (encoder->EnableAudioNetworkAdaptor(
480 *new_config.audio_network_adaptor_config, stream->event_log_)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100481 RTC_LOG(LS_INFO) << "Audio network adaptor enabled on SSRC "
482 << new_config.rtp.ssrc;
ossu20a4b3f2017-04-27 02:08:52 -0700483 } else {
484 RTC_NOTREACHED();
minyue6b825df2016-10-31 04:08:32 -0700485 }
minyue7a973442016-10-20 03:27:12 -0700486 }
487
ossu20a4b3f2017-04-27 02:08:52 -0700488 // Wrap the encoder in a an AudioEncoderCNG, if VAD is enabled.
489 if (spec.cng_payload_type) {
490 AudioEncoderCng::Config cng_config;
491 cng_config.num_channels = encoder->NumChannels();
492 cng_config.payload_type = *spec.cng_payload_type;
493 cng_config.speech_encoder = std::move(encoder);
494 cng_config.vad_mode = Vad::kVadNormal;
495 encoder.reset(new AudioEncoderCng(std::move(cng_config)));
ossu3b9ff382017-04-27 08:03:42 -0700496
497 stream->RegisterCngPayloadType(
498 *spec.cng_payload_type,
499 new_config.send_codec_spec->format.clockrate_hz);
minyue7a973442016-10-20 03:27:12 -0700500 }
ossu20a4b3f2017-04-27 02:08:52 -0700501
Fredrik Solenberg2a877972017-12-15 16:42:15 +0100502 stream->StoreEncoderProperties(encoder->SampleRateHz(),
503 encoder->NumChannels());
ossu20a4b3f2017-04-27 02:08:52 -0700504 stream->channel_proxy_->SetEncoder(new_config.send_codec_spec->payload_type,
505 std::move(encoder));
minyue7a973442016-10-20 03:27:12 -0700506 return true;
507}
508
ossu20a4b3f2017-04-27 02:08:52 -0700509bool AudioSendStream::ReconfigureSendCodec(AudioSendStream* stream,
510 const Config& new_config) {
511 const auto& old_config = stream->config_;
minyue-webrtc8de18262017-07-26 14:18:40 +0200512
513 if (!new_config.send_codec_spec) {
514 // We cannot de-configure a send codec. So we will do nothing.
515 // By design, the send codec should have not been configured.
516 RTC_DCHECK(!old_config.send_codec_spec);
517 return true;
518 }
519
520 if (new_config.send_codec_spec == old_config.send_codec_spec &&
521 new_config.audio_network_adaptor_config ==
522 old_config.audio_network_adaptor_config) {
ossu20a4b3f2017-04-27 02:08:52 -0700523 return true;
524 }
525
526 // If we have no encoder, or the format or payload type's changed, create a
527 // new encoder.
528 if (!old_config.send_codec_spec ||
529 new_config.send_codec_spec->format !=
530 old_config.send_codec_spec->format ||
531 new_config.send_codec_spec->payload_type !=
532 old_config.send_codec_spec->payload_type) {
533 return SetupSendCodec(stream, new_config);
534 }
535
ossu20a4b3f2017-04-27 02:08:52 -0700536 const rtc::Optional<int>& new_target_bitrate_bps =
537 new_config.send_codec_spec->target_bitrate_bps;
538 // If a bitrate has been specified for the codec, use it over the
539 // codec's default.
540 if (new_target_bitrate_bps &&
541 new_target_bitrate_bps !=
542 old_config.send_codec_spec->target_bitrate_bps) {
543 CallEncoder(stream->channel_proxy_, [&](AudioEncoder* encoder) {
544 encoder->OnReceivedTargetAudioBitrate(*new_target_bitrate_bps);
545 });
546 }
547
548 ReconfigureANA(stream, new_config);
549 ReconfigureCNG(stream, new_config);
550
551 return true;
552}
553
554void AudioSendStream::ReconfigureANA(AudioSendStream* stream,
555 const Config& new_config) {
556 if (new_config.audio_network_adaptor_config ==
557 stream->config_.audio_network_adaptor_config) {
558 return;
559 }
560 if (new_config.audio_network_adaptor_config) {
561 CallEncoder(stream->channel_proxy_, [&](AudioEncoder* encoder) {
562 if (encoder->EnableAudioNetworkAdaptor(
563 *new_config.audio_network_adaptor_config, stream->event_log_)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100564 RTC_LOG(LS_INFO) << "Audio network adaptor enabled on SSRC "
565 << new_config.rtp.ssrc;
ossu20a4b3f2017-04-27 02:08:52 -0700566 } else {
567 RTC_NOTREACHED();
568 }
569 });
570 } else {
571 CallEncoder(stream->channel_proxy_, [&](AudioEncoder* encoder) {
572 encoder->DisableAudioNetworkAdaptor();
573 });
Mirko Bonadei675513b2017-11-09 11:09:25 +0100574 RTC_LOG(LS_INFO) << "Audio network adaptor disabled on SSRC "
575 << new_config.rtp.ssrc;
ossu20a4b3f2017-04-27 02:08:52 -0700576 }
577}
578
579void AudioSendStream::ReconfigureCNG(AudioSendStream* stream,
580 const Config& new_config) {
581 if (new_config.send_codec_spec->cng_payload_type ==
582 stream->config_.send_codec_spec->cng_payload_type) {
583 return;
584 }
585
ossu3b9ff382017-04-27 08:03:42 -0700586 // Register the CNG payload type if it's been added, don't do anything if CNG
587 // is removed. Payload types must not be redefined.
588 if (new_config.send_codec_spec->cng_payload_type) {
589 stream->RegisterCngPayloadType(
590 *new_config.send_codec_spec->cng_payload_type,
591 new_config.send_codec_spec->format.clockrate_hz);
592 }
593
ossu20a4b3f2017-04-27 02:08:52 -0700594 // Wrap or unwrap the encoder in an AudioEncoderCNG.
595 stream->channel_proxy_->ModifyEncoder(
596 [&](std::unique_ptr<AudioEncoder>* encoder_ptr) {
597 std::unique_ptr<AudioEncoder> old_encoder(std::move(*encoder_ptr));
598 auto sub_encoders = old_encoder->ReclaimContainedEncoders();
599 if (!sub_encoders.empty()) {
600 // Replace enc with its sub encoder. We need to put the sub
601 // encoder in a temporary first, since otherwise the old value
602 // of enc would be destroyed before the new value got assigned,
603 // which would be bad since the new value is a part of the old
604 // value.
605 auto tmp = std::move(sub_encoders[0]);
606 old_encoder = std::move(tmp);
607 }
608 if (new_config.send_codec_spec->cng_payload_type) {
609 AudioEncoderCng::Config config;
610 config.speech_encoder = std::move(old_encoder);
611 config.num_channels = config.speech_encoder->NumChannels();
612 config.payload_type = *new_config.send_codec_spec->cng_payload_type;
613 config.vad_mode = Vad::kVadNormal;
614 encoder_ptr->reset(new AudioEncoderCng(std::move(config)));
615 } else {
616 *encoder_ptr = std::move(old_encoder);
617 }
618 });
619}
620
621void AudioSendStream::ReconfigureBitrateObserver(
622 AudioSendStream* stream,
623 const webrtc::AudioSendStream::Config& new_config) {
624 // Since the Config's default is for both of these to be -1, this test will
625 // allow us to configure the bitrate observer if the new config has bitrate
626 // limits set, but would only have us call RemoveBitrateObserver if we were
627 // previously configured with bitrate limits.
Alex Narestcedd3512017-12-07 20:54:55 +0100628 int new_transport_seq_num_id =
629 FindExtensionIds(new_config.rtp.extensions).transport_sequence_number;
ossu20a4b3f2017-04-27 02:08:52 -0700630 if (stream->config_.min_bitrate_bps == new_config.min_bitrate_bps &&
Alex Narestcedd3512017-12-07 20:54:55 +0100631 stream->config_.max_bitrate_bps == new_config.max_bitrate_bps &&
632 (FindExtensionIds(stream->config_.rtp.extensions)
633 .transport_sequence_number == new_transport_seq_num_id ||
634 !webrtc::field_trial::IsEnabled("WebRTC-Audio-SendSideBwe"))) {
ossu20a4b3f2017-04-27 02:08:52 -0700635 return;
636 }
637
Alex Narestcedd3512017-12-07 20:54:55 +0100638 if (new_config.min_bitrate_bps != -1 && new_config.max_bitrate_bps != -1 &&
639 (new_transport_seq_num_id != 0 ||
640 !webrtc::field_trial::IsEnabled("WebRTC-Audio-SendSideBwe"))) {
ossu20a4b3f2017-04-27 02:08:52 -0700641 stream->ConfigureBitrateObserver(new_config.min_bitrate_bps,
642 new_config.max_bitrate_bps);
643 } else {
644 stream->RemoveBitrateObserver();
645 }
646}
647
648void AudioSendStream::ConfigureBitrateObserver(int min_bitrate_bps,
649 int max_bitrate_bps) {
650 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
651 RTC_DCHECK_GE(max_bitrate_bps, min_bitrate_bps);
652 rtc::Event thread_sync_event(false /* manual_reset */, false);
653 worker_queue_->PostTask([&] {
654 // We may get a callback immediately as the observer is registered, so make
655 // sure the bitrate limits in config_ are up-to-date.
656 config_.min_bitrate_bps = min_bitrate_bps;
657 config_.max_bitrate_bps = max_bitrate_bps;
658 bitrate_allocator_->AddObserver(this, min_bitrate_bps, max_bitrate_bps, 0,
Alex Narestb3944f02017-10-13 14:56:18 +0200659 true, config_.track_id);
ossu20a4b3f2017-04-27 02:08:52 -0700660 thread_sync_event.Set();
661 });
662 thread_sync_event.Wait(rtc::Event::kForever);
663}
664
665void AudioSendStream::RemoveBitrateObserver() {
666 RTC_DCHECK(worker_thread_checker_.CalledOnValidThread());
667 rtc::Event thread_sync_event(false /* manual_reset */, false);
668 worker_queue_->PostTask([this, &thread_sync_event] {
669 bitrate_allocator_->RemoveObserver(this);
670 thread_sync_event.Set();
671 });
672 thread_sync_event.Wait(rtc::Event::kForever);
673}
674
ossu3b9ff382017-04-27 08:03:42 -0700675void AudioSendStream::RegisterCngPayloadType(int payload_type,
676 int clockrate_hz) {
ossu3b9ff382017-04-27 08:03:42 -0700677 const CodecInst codec = {payload_type, "CN", clockrate_hz, 0, 1, 0};
ossuc3d4b482017-05-23 06:07:11 -0700678 if (rtp_rtcp_module_->RegisterSendPayload(codec) != 0) {
679 rtp_rtcp_module_->DeRegisterSendPayload(codec.pltype);
680 if (rtp_rtcp_module_->RegisterSendPayload(codec) != 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100681 RTC_LOG(LS_ERROR) << "RegisterCngPayloadType() failed to register CN to "
682 "RTP/RTCP module";
ossu3b9ff382017-04-27 08:03:42 -0700683 }
684 }
685}
solenbergc7a8b082015-10-16 14:35:07 -0700686} // namespace internal
687} // namespace webrtc