blob: 5e53853d03c67b77ad168baf652ab2e551566825 [file] [log] [blame]
niklase@google.com470e71d2011-07-07 08:21:25 +00001/*
andrew@webrtc.org40654032012-01-30 20:51:15 +00002 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
niklase@google.com470e71d2011-07-07 08:21:25 +00003 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "modules/audio_processing/audio_processing_impl.h"
niklase@google.com470e71d2011-07-07 08:21:25 +000012
peah103ac7e2017-04-12 05:40:55 -070013#include <math.h>
Michael Graczyk86c6d332015-07-23 11:41:39 -070014#include <algorithm>
alessiob3ec96df2017-05-22 06:57:06 -070015#include <string>
niklase@google.com470e71d2011-07-07 08:21:25 +000016
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020017#include "common_audio/audio_converter.h"
18#include "common_audio/channel_buffer.h"
19#include "common_audio/include/audio_util.h"
20#include "common_audio/signal_processing/include/signal_processing_library.h"
21#include "modules/audio_processing/aec/aec_core.h"
22#include "modules/audio_processing/aec3/echo_canceller3.h"
23#include "modules/audio_processing/agc/agc_manager_direct.h"
24#include "modules/audio_processing/agc2/gain_controller2.h"
25#include "modules/audio_processing/audio_buffer.h"
26#include "modules/audio_processing/beamformer/nonlinear_beamformer.h"
27#include "modules/audio_processing/common.h"
28#include "modules/audio_processing/echo_cancellation_impl.h"
29#include "modules/audio_processing/echo_control_mobile_impl.h"
30#include "modules/audio_processing/gain_control_for_experimental_agc.h"
31#include "modules/audio_processing/gain_control_impl.h"
32#include "rtc_base/checks.h"
33#include "rtc_base/logging.h"
34#include "rtc_base/platform_file.h"
Niels Möller84255bb2017-10-06 13:43:23 +020035#include "rtc_base/refcountedobject.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020036#include "rtc_base/trace_event.h"
peah1bcfce52016-08-26 07:16:04 -070037#if WEBRTC_INTELLIGIBILITY_ENHANCER
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020038#include "modules/audio_processing/intelligibility/intelligibility_enhancer.h"
peah1bcfce52016-08-26 07:16:04 -070039#endif
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020040#include "modules/audio_processing/level_controller/level_controller.h"
41#include "modules/audio_processing/level_estimator_impl.h"
42#include "modules/audio_processing/low_cut_filter.h"
43#include "modules/audio_processing/noise_suppression_impl.h"
44#include "modules/audio_processing/residual_echo_detector.h"
45#include "modules/audio_processing/transient/transient_suppressor.h"
46#include "modules/audio_processing/voice_detection_impl.h"
47#include "modules/include/module_common_types.h"
48#include "system_wrappers/include/file_wrapper.h"
49#include "system_wrappers/include/metrics.h"
andrew@webrtc.org7bf26462011-12-03 00:03:31 +000050
peah1bcfce52016-08-26 07:16:04 -070051// Check to verify that the define for the intelligibility enhancer is properly
52// set.
53#if !defined(WEBRTC_INTELLIGIBILITY_ENHANCER) || \
54 (WEBRTC_INTELLIGIBILITY_ENHANCER != 0 && \
55 WEBRTC_INTELLIGIBILITY_ENHANCER != 1)
56#error "Set WEBRTC_INTELLIGIBILITY_ENHANCER to either 0 or 1"
57#endif
58
Michael Graczyk86c6d332015-07-23 11:41:39 -070059#define RETURN_ON_ERR(expr) \
60 do { \
61 int err = (expr); \
62 if (err != kNoError) { \
63 return err; \
64 } \
andrew@webrtc.org60730cf2014-01-07 17:45:09 +000065 } while (0)
66
niklase@google.com470e71d2011-07-07 08:21:25 +000067namespace webrtc {
aluebsdf6416a2016-03-16 18:26:35 -070068
kwibergd59d3bb2016-09-13 07:49:33 -070069constexpr int AudioProcessing::kNativeSampleRatesHz[];
aluebsdf6416a2016-03-16 18:26:35 -070070
Michael Graczyk86c6d332015-07-23 11:41:39 -070071namespace {
72
73static bool LayoutHasKeyboard(AudioProcessing::ChannelLayout layout) {
74 switch (layout) {
75 case AudioProcessing::kMono:
76 case AudioProcessing::kStereo:
77 return false;
78 case AudioProcessing::kMonoAndKeyboard:
79 case AudioProcessing::kStereoAndKeyboard:
80 return true;
81 }
82
kwiberg9e2be5f2016-09-14 05:23:22 -070083 RTC_NOTREACHED();
Michael Graczyk86c6d332015-07-23 11:41:39 -070084 return false;
85}
aluebsdf6416a2016-03-16 18:26:35 -070086
peah2ace3f92016-09-10 04:42:27 -070087bool SampleRateSupportsMultiBand(int sample_rate_hz) {
aluebsdf6416a2016-03-16 18:26:35 -070088 return sample_rate_hz == AudioProcessing::kSampleRate32kHz ||
89 sample_rate_hz == AudioProcessing::kSampleRate48kHz;
90}
91
peah2ace3f92016-09-10 04:42:27 -070092int FindNativeProcessRateToUse(int minimum_rate, bool band_splitting_required) {
93#ifdef WEBRTC_ARCH_ARM_FAMILY
kwibergd59d3bb2016-09-13 07:49:33 -070094 constexpr int kMaxSplittingNativeProcessRate =
95 AudioProcessing::kSampleRate32kHz;
peah2ace3f92016-09-10 04:42:27 -070096#else
kwibergd59d3bb2016-09-13 07:49:33 -070097 constexpr int kMaxSplittingNativeProcessRate =
98 AudioProcessing::kSampleRate48kHz;
peah2ace3f92016-09-10 04:42:27 -070099#endif
kwibergd59d3bb2016-09-13 07:49:33 -0700100 static_assert(
101 kMaxSplittingNativeProcessRate <= AudioProcessing::kMaxNativeSampleRateHz,
102 "");
peah2ace3f92016-09-10 04:42:27 -0700103 const int uppermost_native_rate = band_splitting_required
104 ? kMaxSplittingNativeProcessRate
105 : AudioProcessing::kSampleRate48kHz;
106
107 for (auto rate : AudioProcessing::kNativeSampleRatesHz) {
108 if (rate >= uppermost_native_rate) {
109 return uppermost_native_rate;
110 }
111 if (rate >= minimum_rate) {
aluebsdf6416a2016-03-16 18:26:35 -0700112 return rate;
113 }
114 }
peah2ace3f92016-09-10 04:42:27 -0700115 RTC_NOTREACHED();
116 return uppermost_native_rate;
aluebsdf6416a2016-03-16 18:26:35 -0700117}
118
peah9e6a2902017-05-15 07:19:21 -0700119// Maximum lengths that frame of samples being passed from the render side to
120// the capture side can have (does not apply to AEC3).
121static const size_t kMaxAllowedValuesOfSamplesPerBand = 160;
122static const size_t kMaxAllowedValuesOfSamplesPerFrame = 480;
123
peah764e3642016-10-22 05:04:30 -0700124// Maximum number of frames to buffer in the render queue.
125// TODO(peah): Decrease this once we properly handle hugely unbalanced
126// reverse and forward call numbers.
127static const size_t kMaxNumFramesToBuffer = 100;
128
peah8271d042016-11-22 07:24:52 -0800129class HighPassFilterImpl : public HighPassFilter {
130 public:
131 explicit HighPassFilterImpl(AudioProcessingImpl* apm) : apm_(apm) {}
132 ~HighPassFilterImpl() override = default;
133
134 // HighPassFilter implementation.
135 int Enable(bool enable) override {
136 apm_->MutateConfig([enable](AudioProcessing::Config* config) {
137 config->high_pass_filter.enabled = enable;
138 });
139
140 return AudioProcessing::kNoError;
141 }
142
143 bool is_enabled() const override {
144 return apm_->GetConfig().high_pass_filter.enabled;
145 }
146
147 private:
148 AudioProcessingImpl* apm_;
149 RTC_DISALLOW_IMPLICIT_CONSTRUCTORS(HighPassFilterImpl);
150};
151
aleloi868f32f2017-05-23 07:20:05 -0700152webrtc::InternalAPMStreamsConfig ToStreamsConfig(
153 const ProcessingConfig& api_format) {
154 webrtc::InternalAPMStreamsConfig result;
155 result.input_sample_rate = api_format.input_stream().sample_rate_hz();
156 result.input_num_channels = api_format.input_stream().num_channels();
157 result.output_num_channels = api_format.output_stream().num_channels();
158 result.render_input_num_channels =
159 api_format.reverse_input_stream().num_channels();
160 result.render_input_sample_rate =
161 api_format.reverse_input_stream().sample_rate_hz();
162 result.output_sample_rate = api_format.output_stream().sample_rate_hz();
163 result.render_output_sample_rate =
164 api_format.reverse_output_stream().sample_rate_hz();
165 result.render_output_num_channels =
166 api_format.reverse_output_stream().num_channels();
167 return result;
168}
Michael Graczyk86c6d332015-07-23 11:41:39 -0700169} // namespace
andrew@webrtc.org60730cf2014-01-07 17:45:09 +0000170
171// Throughout webrtc, it's assumed that success is represented by zero.
kwiberg@webrtc.org2ebfac52015-01-14 10:51:54 +0000172static_assert(AudioProcessing::kNoError == 0, "kNoError must be zero");
andrew@webrtc.org60730cf2014-01-07 17:45:09 +0000173
Sam Zackrisson0beac582017-09-25 12:04:02 +0200174AudioProcessingImpl::ApmSubmoduleStates::ApmSubmoduleStates(
175 bool capture_post_processor_enabled)
176 : capture_post_processor_enabled_(capture_post_processor_enabled) {}
peah2ace3f92016-09-10 04:42:27 -0700177
178bool AudioProcessingImpl::ApmSubmoduleStates::Update(
peah8271d042016-11-22 07:24:52 -0800179 bool low_cut_filter_enabled,
peah2ace3f92016-09-10 04:42:27 -0700180 bool echo_canceller_enabled,
181 bool mobile_echo_controller_enabled,
ivoc9f4a4a02016-10-28 05:39:16 -0700182 bool residual_echo_detector_enabled,
peah2ace3f92016-09-10 04:42:27 -0700183 bool noise_suppressor_enabled,
184 bool intelligibility_enhancer_enabled,
185 bool beamformer_enabled,
186 bool adaptive_gain_controller_enabled,
alessiob3ec96df2017-05-22 06:57:06 -0700187 bool gain_controller2_enabled,
peah2ace3f92016-09-10 04:42:27 -0700188 bool level_controller_enabled,
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200189 bool echo_controller_enabled,
peah2ace3f92016-09-10 04:42:27 -0700190 bool voice_activity_detector_enabled,
191 bool level_estimator_enabled,
192 bool transient_suppressor_enabled) {
193 bool changed = false;
peah8271d042016-11-22 07:24:52 -0800194 changed |= (low_cut_filter_enabled != low_cut_filter_enabled_);
peah2ace3f92016-09-10 04:42:27 -0700195 changed |= (echo_canceller_enabled != echo_canceller_enabled_);
196 changed |=
197 (mobile_echo_controller_enabled != mobile_echo_controller_enabled_);
ivoc9f4a4a02016-10-28 05:39:16 -0700198 changed |=
199 (residual_echo_detector_enabled != residual_echo_detector_enabled_);
peah2ace3f92016-09-10 04:42:27 -0700200 changed |= (noise_suppressor_enabled != noise_suppressor_enabled_);
201 changed |=
202 (intelligibility_enhancer_enabled != intelligibility_enhancer_enabled_);
203 changed |= (beamformer_enabled != beamformer_enabled_);
204 changed |=
205 (adaptive_gain_controller_enabled != adaptive_gain_controller_enabled_);
alessiob3ec96df2017-05-22 06:57:06 -0700206 changed |=
207 (gain_controller2_enabled != gain_controller2_enabled_);
peah2ace3f92016-09-10 04:42:27 -0700208 changed |= (level_controller_enabled != level_controller_enabled_);
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200209 changed |= (echo_controller_enabled != echo_controller_enabled_);
peah2ace3f92016-09-10 04:42:27 -0700210 changed |= (level_estimator_enabled != level_estimator_enabled_);
211 changed |=
212 (voice_activity_detector_enabled != voice_activity_detector_enabled_);
213 changed |= (transient_suppressor_enabled != transient_suppressor_enabled_);
214 if (changed) {
peah8271d042016-11-22 07:24:52 -0800215 low_cut_filter_enabled_ = low_cut_filter_enabled;
peah2ace3f92016-09-10 04:42:27 -0700216 echo_canceller_enabled_ = echo_canceller_enabled;
217 mobile_echo_controller_enabled_ = mobile_echo_controller_enabled;
ivoc9f4a4a02016-10-28 05:39:16 -0700218 residual_echo_detector_enabled_ = residual_echo_detector_enabled;
peah2ace3f92016-09-10 04:42:27 -0700219 noise_suppressor_enabled_ = noise_suppressor_enabled;
220 intelligibility_enhancer_enabled_ = intelligibility_enhancer_enabled;
221 beamformer_enabled_ = beamformer_enabled;
222 adaptive_gain_controller_enabled_ = adaptive_gain_controller_enabled;
alessiob3ec96df2017-05-22 06:57:06 -0700223 gain_controller2_enabled_ = gain_controller2_enabled;
peah2ace3f92016-09-10 04:42:27 -0700224 level_controller_enabled_ = level_controller_enabled;
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200225 echo_controller_enabled_ = echo_controller_enabled;
peah2ace3f92016-09-10 04:42:27 -0700226 level_estimator_enabled_ = level_estimator_enabled;
227 voice_activity_detector_enabled_ = voice_activity_detector_enabled;
228 transient_suppressor_enabled_ = transient_suppressor_enabled;
229 }
230
231 changed |= first_update_;
232 first_update_ = false;
233 return changed;
234}
235
236bool AudioProcessingImpl::ApmSubmoduleStates::CaptureMultiBandSubModulesActive()
237 const {
238#if WEBRTC_INTELLIGIBILITY_ENHANCER
239 return CaptureMultiBandProcessingActive() ||
peah52775842017-05-16 06:14:09 -0700240 intelligibility_enhancer_enabled_ || voice_activity_detector_enabled_;
peah2ace3f92016-09-10 04:42:27 -0700241#else
peah52775842017-05-16 06:14:09 -0700242 return CaptureMultiBandProcessingActive() || voice_activity_detector_enabled_;
peah2ace3f92016-09-10 04:42:27 -0700243#endif
244}
245
246bool AudioProcessingImpl::ApmSubmoduleStates::CaptureMultiBandProcessingActive()
247 const {
peah8271d042016-11-22 07:24:52 -0800248 return low_cut_filter_enabled_ || echo_canceller_enabled_ ||
peah2ace3f92016-09-10 04:42:27 -0700249 mobile_echo_controller_enabled_ || noise_suppressor_enabled_ ||
peahe0eae3c2016-12-14 01:16:23 -0800250 beamformer_enabled_ || adaptive_gain_controller_enabled_ ||
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200251 echo_controller_enabled_;
peah2ace3f92016-09-10 04:42:27 -0700252}
253
peah23ac8b42017-05-23 05:33:56 -0700254bool AudioProcessingImpl::ApmSubmoduleStates::CaptureFullBandProcessingActive()
255 const {
Alessio Bazzica270f7b52017-10-13 11:05:17 +0200256 return level_controller_enabled_ || gain_controller2_enabled_ ||
257 capture_post_processor_enabled_;
peah23ac8b42017-05-23 05:33:56 -0700258}
259
peah2ace3f92016-09-10 04:42:27 -0700260bool AudioProcessingImpl::ApmSubmoduleStates::RenderMultiBandSubModulesActive()
261 const {
262 return RenderMultiBandProcessingActive() || echo_canceller_enabled_ ||
ivoc20270be2016-11-15 05:24:35 -0800263 mobile_echo_controller_enabled_ || adaptive_gain_controller_enabled_ ||
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200264 echo_controller_enabled_;
peah2ace3f92016-09-10 04:42:27 -0700265}
266
267bool AudioProcessingImpl::ApmSubmoduleStates::RenderMultiBandProcessingActive()
268 const {
269#if WEBRTC_INTELLIGIBILITY_ENHANCER
270 return intelligibility_enhancer_enabled_;
271#else
272 return false;
273#endif
274}
275
solenberg5e465c32015-12-08 13:22:33 -0800276struct AudioProcessingImpl::ApmPublicSubmodules {
peahbfa97112016-03-10 21:09:04 -0800277 ApmPublicSubmodules() {}
solenberg5e465c32015-12-08 13:22:33 -0800278 // Accessed externally of APM without any lock acquired.
peahb624d8c2016-03-05 03:01:14 -0800279 std::unique_ptr<EchoCancellationImpl> echo_cancellation;
peahbb9edbd2016-03-10 12:54:25 -0800280 std::unique_ptr<EchoControlMobileImpl> echo_control_mobile;
peahbfa97112016-03-10 21:09:04 -0800281 std::unique_ptr<GainControlImpl> gain_control;
kwiberg88788ad2016-02-19 07:04:49 -0800282 std::unique_ptr<LevelEstimatorImpl> level_estimator;
283 std::unique_ptr<NoiseSuppressionImpl> noise_suppression;
284 std::unique_ptr<VoiceDetectionImpl> voice_detection;
285 std::unique_ptr<GainControlForExperimentalAgc>
peahbe615622016-02-13 16:40:47 -0800286 gain_control_for_experimental_agc;
solenberg5e465c32015-12-08 13:22:33 -0800287
288 // Accessed internally from both render and capture.
kwiberg88788ad2016-02-19 07:04:49 -0800289 std::unique_ptr<TransientSuppressor> transient_suppressor;
peah1bcfce52016-08-26 07:16:04 -0700290#if WEBRTC_INTELLIGIBILITY_ENHANCER
kwiberg88788ad2016-02-19 07:04:49 -0800291 std::unique_ptr<IntelligibilityEnhancer> intelligibility_enhancer;
peah1bcfce52016-08-26 07:16:04 -0700292#endif
solenberg5e465c32015-12-08 13:22:33 -0800293};
294
295struct AudioProcessingImpl::ApmPrivateSubmodules {
Sam Zackrisson0beac582017-09-25 12:04:02 +0200296 ApmPrivateSubmodules(NonlinearBeamformer* beamformer,
297 std::unique_ptr<PostProcessing> capture_post_processor)
298 : beamformer(beamformer),
299 capture_post_processor(std::move(capture_post_processor)) {}
solenberg5e465c32015-12-08 13:22:33 -0800300 // Accessed internally from capture or during initialization
Alejandro Luebsf4022ff2016-07-01 17:19:09 -0700301 std::unique_ptr<NonlinearBeamformer> beamformer;
kwiberg88788ad2016-02-19 07:04:49 -0800302 std::unique_ptr<AgcManagerDirect> agc_manager;
alessiob3ec96df2017-05-22 06:57:06 -0700303 std::unique_ptr<GainController2> gain_controller2;
peah8271d042016-11-22 07:24:52 -0800304 std::unique_ptr<LowCutFilter> low_cut_filter;
peahca4cac72016-06-29 15:26:12 -0700305 std::unique_ptr<LevelController> level_controller;
ivoc9f4a4a02016-10-28 05:39:16 -0700306 std::unique_ptr<ResidualEchoDetector> residual_echo_detector;
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +0200307 std::unique_ptr<EchoControl> echo_controller;
Sam Zackrisson0beac582017-09-25 12:04:02 +0200308 std::unique_ptr<PostProcessing> capture_post_processor;
solenberg5e465c32015-12-08 13:22:33 -0800309};
310
andrew@webrtc.orge84978f2014-01-25 02:09:06 +0000311AudioProcessing* AudioProcessing::Create() {
peah88ac8532016-09-12 16:47:25 -0700312 webrtc::Config config;
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200313 return Create(config, nullptr, nullptr, nullptr);
andrew@webrtc.orge84978f2014-01-25 02:09:06 +0000314}
315
peah88ac8532016-09-12 16:47:25 -0700316AudioProcessing* AudioProcessing::Create(const webrtc::Config& config) {
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200317 return Create(config, nullptr, nullptr, nullptr);
aluebs@webrtc.orgd82f55d2015-01-15 18:07:21 +0000318}
319
peah88ac8532016-09-12 16:47:25 -0700320AudioProcessing* AudioProcessing::Create(const webrtc::Config& config,
Alejandro Luebsf4022ff2016-07-01 17:19:09 -0700321 NonlinearBeamformer* beamformer) {
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200322 return Create(config, nullptr, nullptr, beamformer);
Sam Zackrisson0beac582017-09-25 12:04:02 +0200323}
324
325AudioProcessing* AudioProcessing::Create(
326 const webrtc::Config& config,
327 std::unique_ptr<PostProcessing> capture_post_processor,
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200328 std::unique_ptr<EchoControlFactory> echo_control_factory,
Gustaf Ullbergd8579e02017-10-11 16:29:02 +0200329 NonlinearBeamformer* beamformer) {
Sam Zackrisson0beac582017-09-25 12:04:02 +0200330 AudioProcessingImpl* apm = new rtc::RefCountedObject<AudioProcessingImpl>(
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200331 config, std::move(capture_post_processor),
332 std::move(echo_control_factory), beamformer);
niklase@google.com470e71d2011-07-07 08:21:25 +0000333 if (apm->Initialize() != kNoError) {
334 delete apm;
peahdf3efa82015-11-28 12:35:15 -0800335 apm = nullptr;
niklase@google.com470e71d2011-07-07 08:21:25 +0000336 }
337
338 return apm;
339}
340
peah88ac8532016-09-12 16:47:25 -0700341AudioProcessingImpl::AudioProcessingImpl(const webrtc::Config& config)
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200342 : AudioProcessingImpl(config, nullptr, nullptr, nullptr) {}
aluebs@webrtc.orgd82f55d2015-01-15 18:07:21 +0000343
Sam Zackrisson0beac582017-09-25 12:04:02 +0200344AudioProcessingImpl::AudioProcessingImpl(
345 const webrtc::Config& config,
346 std::unique_ptr<PostProcessing> capture_post_processor,
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200347 std::unique_ptr<EchoControlFactory> echo_control_factory,
Sam Zackrisson0beac582017-09-25 12:04:02 +0200348 NonlinearBeamformer* beamformer)
peah8271d042016-11-22 07:24:52 -0800349 : high_pass_filter_impl_(new HighPassFilterImpl(this)),
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200350 echo_control_factory_(std::move(echo_control_factory)),
Sam Zackrisson0beac582017-09-25 12:04:02 +0200351 submodule_states_(!!capture_post_processor),
peah8271d042016-11-22 07:24:52 -0800352 public_submodules_(new ApmPublicSubmodules()),
Sam Zackrisson0beac582017-09-25 12:04:02 +0200353 private_submodules_(
354 new ApmPrivateSubmodules(beamformer,
355 std::move(capture_post_processor))),
peahdf3efa82015-11-28 12:35:15 -0800356 constants_(config.Get<ExperimentalAgc>().startup_min_volume,
henrik.lundinbd681b92016-12-05 09:08:42 -0800357 config.Get<ExperimentalAgc>().clipped_level_min,
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000358#if defined(WEBRTC_ANDROID) || defined(WEBRTC_IOS)
Alejandro Luebsc9b0c262016-05-16 15:32:38 -0700359 false),
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000360#else
Alejandro Luebsc9b0c262016-05-16 15:32:38 -0700361 config.Get<ExperimentalAgc>().enabled),
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000362#endif
andrew1c7075f2015-06-24 18:14:14 -0700363#if defined(WEBRTC_ANDROID) || defined(WEBRTC_IOS)
aluebs2a346882016-01-11 18:04:30 -0800364 capture_(false,
andrew1c7075f2015-06-24 18:14:14 -0700365#else
aluebs2a346882016-01-11 18:04:30 -0800366 capture_(config.Get<ExperimentalNs>().enabled,
andrew1c7075f2015-06-24 18:14:14 -0700367#endif
aluebs2a346882016-01-11 18:04:30 -0800368 config.Get<Beamforming>().array_geometry,
aluebsb2328d12016-01-11 20:32:29 -0800369 config.Get<Beamforming>().target_direction),
Alejandro Luebsc9b0c262016-05-16 15:32:38 -0700370 capture_nonlocked_(config.Get<Beamforming>().enabled,
peah88ac8532016-09-12 16:47:25 -0700371 config.Get<Intelligibility>().enabled) {
peahdf3efa82015-11-28 12:35:15 -0800372 {
373 rtc::CritScope cs_render(&crit_render_);
374 rtc::CritScope cs_capture(&crit_capture_);
niklase@google.com470e71d2011-07-07 08:21:25 +0000375
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200376 // Mark Echo Controller enabled if a factory is injected.
377 capture_nonlocked_.echo_controller_enabled =
378 static_cast<bool>(echo_control_factory_);
379
peahb624d8c2016-03-05 03:01:14 -0800380 public_submodules_->echo_cancellation.reset(
peahb58a1582016-03-15 09:34:24 -0700381 new EchoCancellationImpl(&crit_render_, &crit_capture_));
peahbb9edbd2016-03-10 12:54:25 -0800382 public_submodules_->echo_control_mobile.reset(
peah253534d2016-03-15 04:32:28 -0700383 new EchoControlMobileImpl(&crit_render_, &crit_capture_));
peahbfa97112016-03-10 21:09:04 -0800384 public_submodules_->gain_control.reset(
peahb8fbb542016-03-15 02:28:08 -0700385 new GainControlImpl(&crit_capture_, &crit_capture_));
solenberg949028f2015-12-15 11:39:38 -0800386 public_submodules_->level_estimator.reset(
387 new LevelEstimatorImpl(&crit_capture_));
solenberg5e465c32015-12-08 13:22:33 -0800388 public_submodules_->noise_suppression.reset(
389 new NoiseSuppressionImpl(&crit_capture_));
solenberga29386c2015-12-16 03:31:12 -0800390 public_submodules_->voice_detection.reset(
391 new VoiceDetectionImpl(&crit_capture_));
peahbe615622016-02-13 16:40:47 -0800392 public_submodules_->gain_control_for_experimental_agc.reset(
peahbfa97112016-03-10 21:09:04 -0800393 new GainControlForExperimentalAgc(
394 public_submodules_->gain_control.get(), &crit_capture_));
ivoc9f4a4a02016-10-28 05:39:16 -0700395 private_submodules_->residual_echo_detector.reset(
396 new ResidualEchoDetector());
peahca4cac72016-06-29 15:26:12 -0700397
peahc19f3122016-10-07 14:54:10 -0700398 // TODO(peah): Move this creation to happen only when the level controller
399 // is enabled.
peahca4cac72016-06-29 15:26:12 -0700400 private_submodules_->level_controller.reset(new LevelController());
Sam Zackrisson0beac582017-09-25 12:04:02 +0200401
Alessio Bazzica270f7b52017-10-13 11:05:17 +0200402 // TODO(alessiob): Move the injected gain controller once injection is
403 // implemented.
404 private_submodules_->gain_controller2.reset(new GainController2());
405
Sam Zackrisson0beac582017-09-25 12:04:02 +0200406 LOG(LS_INFO) << "Capture post processor activated: "
407 << !!private_submodules_->capture_post_processor;
peahdf3efa82015-11-28 12:35:15 -0800408 }
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000409
andrew@webrtc.orge84978f2014-01-25 02:09:06 +0000410 SetExtraOptions(config);
niklase@google.com470e71d2011-07-07 08:21:25 +0000411}
412
413AudioProcessingImpl::~AudioProcessingImpl() {
peahdf3efa82015-11-28 12:35:15 -0800414 // Depends on gain_control_ and
peahbe615622016-02-13 16:40:47 -0800415 // public_submodules_->gain_control_for_experimental_agc.
peahdf3efa82015-11-28 12:35:15 -0800416 private_submodules_->agc_manager.reset();
417 // Depends on gain_control_.
peahbe615622016-02-13 16:40:47 -0800418 public_submodules_->gain_control_for_experimental_agc.reset();
niklase@google.com470e71d2011-07-07 08:21:25 +0000419}
420
niklase@google.com470e71d2011-07-07 08:21:25 +0000421int AudioProcessingImpl::Initialize() {
peahdf3efa82015-11-28 12:35:15 -0800422 // Run in a single-threaded manner during initialization.
423 rtc::CritScope cs_render(&crit_render_);
424 rtc::CritScope cs_capture(&crit_capture_);
niklase@google.com470e71d2011-07-07 08:21:25 +0000425 return InitializeLocked();
426}
427
peahde65ddc2016-09-16 15:02:15 -0700428int AudioProcessingImpl::Initialize(int capture_input_sample_rate_hz,
429 int capture_output_sample_rate_hz,
430 int render_input_sample_rate_hz,
431 ChannelLayout capture_input_layout,
432 ChannelLayout capture_output_layout,
433 ChannelLayout render_input_layout) {
Michael Graczyk86c6d332015-07-23 11:41:39 -0700434 const ProcessingConfig processing_config = {
peahde65ddc2016-09-16 15:02:15 -0700435 {{capture_input_sample_rate_hz, ChannelsFromLayout(capture_input_layout),
436 LayoutHasKeyboard(capture_input_layout)},
437 {capture_output_sample_rate_hz,
438 ChannelsFromLayout(capture_output_layout),
439 LayoutHasKeyboard(capture_output_layout)},
440 {render_input_sample_rate_hz, ChannelsFromLayout(render_input_layout),
441 LayoutHasKeyboard(render_input_layout)},
442 {render_input_sample_rate_hz, ChannelsFromLayout(render_input_layout),
443 LayoutHasKeyboard(render_input_layout)}}};
Michael Graczyk86c6d332015-07-23 11:41:39 -0700444
445 return Initialize(processing_config);
446}
447
448int AudioProcessingImpl::Initialize(const ProcessingConfig& processing_config) {
peahdf3efa82015-11-28 12:35:15 -0800449 // Run in a single-threaded manner during initialization.
450 rtc::CritScope cs_render(&crit_render_);
451 rtc::CritScope cs_capture(&crit_capture_);
Michael Graczyk86c6d332015-07-23 11:41:39 -0700452 return InitializeLocked(processing_config);
andrew@webrtc.orga8b97372014-03-10 22:26:12 +0000453}
454
peahdf3efa82015-11-28 12:35:15 -0800455int AudioProcessingImpl::MaybeInitializeRender(
peah81b9bfe2015-11-27 02:47:28 -0800456 const ProcessingConfig& processing_config) {
peah2ace3f92016-09-10 04:42:27 -0700457 return MaybeInitialize(processing_config, false);
peah81b9bfe2015-11-27 02:47:28 -0800458}
459
peahdf3efa82015-11-28 12:35:15 -0800460int AudioProcessingImpl::MaybeInitializeCapture(
peah2ace3f92016-09-10 04:42:27 -0700461 const ProcessingConfig& processing_config,
462 bool force_initialization) {
463 return MaybeInitialize(processing_config, force_initialization);
peah81b9bfe2015-11-27 02:47:28 -0800464}
465
peah192164e2015-11-17 02:16:45 -0800466// Calls InitializeLocked() if any of the audio parameters have changed from
peahdf3efa82015-11-28 12:35:15 -0800467// their current values (needs to be called while holding the crit_render_lock).
468int AudioProcessingImpl::MaybeInitialize(
peah2ace3f92016-09-10 04:42:27 -0700469 const ProcessingConfig& processing_config,
470 bool force_initialization) {
peahdf3efa82015-11-28 12:35:15 -0800471 // Called from both threads. Thread check is therefore not possible.
peah2ace3f92016-09-10 04:42:27 -0700472 if (processing_config == formats_.api_format && !force_initialization) {
peah192164e2015-11-17 02:16:45 -0800473 return kNoError;
474 }
peahdf3efa82015-11-28 12:35:15 -0800475
476 rtc::CritScope cs_capture(&crit_capture_);
peah192164e2015-11-17 02:16:45 -0800477 return InitializeLocked(processing_config);
478}
479
niklase@google.com470e71d2011-07-07 08:21:25 +0000480int AudioProcessingImpl::InitializeLocked() {
Per Ã…hgren4bdced52017-06-27 16:00:38 +0200481 UpdateActiveSubmoduleStates();
482
peah522d71b2017-02-23 05:16:26 -0800483 const int capture_audiobuffer_num_channels =
484 capture_nonlocked_.beamformer_enabled
485 ? formats_.api_format.input_stream().num_channels()
486 : formats_.api_format.output_stream().num_channels();
487
peahde65ddc2016-09-16 15:02:15 -0700488 const int render_audiobuffer_num_output_frames =
peahdf3efa82015-11-28 12:35:15 -0800489 formats_.api_format.reverse_output_stream().num_frames() == 0
peahde65ddc2016-09-16 15:02:15 -0700490 ? formats_.render_processing_format.num_frames()
peahdf3efa82015-11-28 12:35:15 -0800491 : formats_.api_format.reverse_output_stream().num_frames();
492 if (formats_.api_format.reverse_input_stream().num_channels() > 0) {
493 render_.render_audio.reset(new AudioBuffer(
494 formats_.api_format.reverse_input_stream().num_frames(),
495 formats_.api_format.reverse_input_stream().num_channels(),
peahde65ddc2016-09-16 15:02:15 -0700496 formats_.render_processing_format.num_frames(),
497 formats_.render_processing_format.num_channels(),
498 render_audiobuffer_num_output_frames));
peah2ace3f92016-09-10 04:42:27 -0700499 if (formats_.api_format.reverse_input_stream() !=
500 formats_.api_format.reverse_output_stream()) {
kwibergc2b785d2016-02-24 05:22:32 -0800501 render_.render_converter = AudioConverter::Create(
peahdf3efa82015-11-28 12:35:15 -0800502 formats_.api_format.reverse_input_stream().num_channels(),
503 formats_.api_format.reverse_input_stream().num_frames(),
504 formats_.api_format.reverse_output_stream().num_channels(),
kwibergc2b785d2016-02-24 05:22:32 -0800505 formats_.api_format.reverse_output_stream().num_frames());
ekmeyerson60d9b332015-08-14 10:35:55 -0700506 } else {
peahdf3efa82015-11-28 12:35:15 -0800507 render_.render_converter.reset(nullptr);
ekmeyerson60d9b332015-08-14 10:35:55 -0700508 }
Michael Graczyk86c6d332015-07-23 11:41:39 -0700509 } else {
peahdf3efa82015-11-28 12:35:15 -0800510 render_.render_audio.reset(nullptr);
511 render_.render_converter.reset(nullptr);
Michael Graczyk86c6d332015-07-23 11:41:39 -0700512 }
peahce4d9152017-05-19 01:28:05 -0700513
peahdf3efa82015-11-28 12:35:15 -0800514 capture_.capture_audio.reset(
515 new AudioBuffer(formats_.api_format.input_stream().num_frames(),
516 formats_.api_format.input_stream().num_channels(),
peahde65ddc2016-09-16 15:02:15 -0700517 capture_nonlocked_.capture_processing_format.num_frames(),
518 capture_audiobuffer_num_channels,
peahdf3efa82015-11-28 12:35:15 -0800519 formats_.api_format.output_stream().num_frames()));
niklase@google.com470e71d2011-07-07 08:21:25 +0000520
peahde65ddc2016-09-16 15:02:15 -0700521 public_submodules_->echo_cancellation->Initialize(
522 proc_sample_rate_hz(), num_reverse_channels(), num_output_channels(),
523 num_proc_channels());
peah764e3642016-10-22 05:04:30 -0700524 AllocateRenderQueue();
525
ivoc3e9a5372016-10-28 07:55:33 -0700526 int success = public_submodules_->echo_cancellation->enable_metrics(true);
527 RTC_DCHECK_EQ(0, success);
528 success = public_submodules_->echo_cancellation->enable_delay_logging(true);
529 RTC_DCHECK_EQ(0, success);
peahde65ddc2016-09-16 15:02:15 -0700530 public_submodules_->echo_control_mobile->Initialize(
531 proc_split_sample_rate_hz(), num_reverse_channels(),
532 num_output_channels());
peah135259a2016-10-28 03:12:11 -0700533
534 public_submodules_->gain_control->Initialize(num_proc_channels(),
535 proc_sample_rate_hz());
peahde65ddc2016-09-16 15:02:15 -0700536 if (constants_.use_experimental_agc) {
537 if (!private_submodules_->agc_manager.get()) {
538 private_submodules_->agc_manager.reset(new AgcManagerDirect(
539 public_submodules_->gain_control.get(),
540 public_submodules_->gain_control_for_experimental_agc.get(),
henrik.lundinbd681b92016-12-05 09:08:42 -0800541 constants_.agc_startup_min_volume, constants_.agc_clipped_level_min));
peahde65ddc2016-09-16 15:02:15 -0700542 }
543 private_submodules_->agc_manager->Initialize();
544 private_submodules_->agc_manager->SetCaptureMuted(
545 capture_.output_will_be_muted);
peah135259a2016-10-28 03:12:11 -0700546 public_submodules_->gain_control_for_experimental_agc->Initialize();
peahde65ddc2016-09-16 15:02:15 -0700547 }
Bjorn Volckeradc46c42015-04-15 11:42:40 +0200548 InitializeTransient();
aluebs@webrtc.orgae643ce2014-12-19 19:57:34 +0000549 InitializeBeamformer();
peah1bcfce52016-08-26 07:16:04 -0700550#if WEBRTC_INTELLIGIBILITY_ENHANCER
ekmeyerson60d9b332015-08-14 10:35:55 -0700551 InitializeIntelligibility();
peah1bcfce52016-08-26 07:16:04 -0700552#endif
peah8271d042016-11-22 07:24:52 -0800553 InitializeLowCutFilter();
peahde65ddc2016-09-16 15:02:15 -0700554 public_submodules_->noise_suppression->Initialize(num_proc_channels(),
555 proc_sample_rate_hz());
556 public_submodules_->voice_detection->Initialize(proc_split_sample_rate_hz());
557 public_submodules_->level_estimator->Initialize();
peahca4cac72016-06-29 15:26:12 -0700558 InitializeLevelController();
ivoc9f4a4a02016-10-28 05:39:16 -0700559 InitializeResidualEchoDetector();
Gustaf Ullberg8eb9c7d2017-10-14 08:28:46 +0200560 InitializeEchoController();
alessiob3ec96df2017-05-22 06:57:06 -0700561 InitializeGainController2();
Sam Zackrisson0beac582017-09-25 12:04:02 +0200562 InitializePostProcessor();
solenberg70f99032015-12-08 11:07:32 -0800563
aleloi868f32f2017-05-23 07:20:05 -0700564 if (aec_dump_) {
565 aec_dump_->WriteInitMessage(ToStreamsConfig(formats_.api_format));
566 }
niklase@google.com470e71d2011-07-07 08:21:25 +0000567 return kNoError;
568}
569
Michael Graczyk86c6d332015-07-23 11:41:39 -0700570int AudioProcessingImpl::InitializeLocked(const ProcessingConfig& config) {
Per Ã…hgren4bdced52017-06-27 16:00:38 +0200571 UpdateActiveSubmoduleStates();
572
Michael Graczyk86c6d332015-07-23 11:41:39 -0700573 for (const auto& stream : config.streams) {
Michael Graczyk86c6d332015-07-23 11:41:39 -0700574 if (stream.num_channels() > 0 && stream.sample_rate_hz() <= 0) {
575 return kBadSampleRateError;
576 }
andrew@webrtc.orga8b97372014-03-10 22:26:12 +0000577 }
Michael Graczyk86c6d332015-07-23 11:41:39 -0700578
Peter Kasting69558702016-01-12 16:26:35 -0800579 const size_t num_in_channels = config.input_stream().num_channels();
580 const size_t num_out_channels = config.output_stream().num_channels();
Michael Graczyk86c6d332015-07-23 11:41:39 -0700581
582 // Need at least one input channel.
583 // Need either one output channel or as many outputs as there are inputs.
584 if (num_in_channels == 0 ||
585 !(num_out_channels == 1 || num_out_channels == num_in_channels)) {
Michael Graczykc2047542015-07-22 21:06:11 -0700586 return kBadNumberChannelsError;
587 }
588
aluebsb2328d12016-01-11 20:32:29 -0800589 if (capture_nonlocked_.beamformer_enabled &&
Peter Kasting69558702016-01-12 16:26:35 -0800590 num_in_channels != capture_.array_geometry.size()) {
Michael Graczyk86c6d332015-07-23 11:41:39 -0700591 return kBadNumberChannelsError;
592 }
593
peahdf3efa82015-11-28 12:35:15 -0800594 formats_.api_format = config;
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000595
peahde65ddc2016-09-16 15:02:15 -0700596 int capture_processing_rate = FindNativeProcessRateToUse(
peah423d2362016-04-09 16:06:52 -0700597 std::min(formats_.api_format.input_stream().sample_rate_hz(),
peah2ace3f92016-09-10 04:42:27 -0700598 formats_.api_format.output_stream().sample_rate_hz()),
599 submodule_states_.CaptureMultiBandSubModulesActive() ||
600 submodule_states_.RenderMultiBandSubModulesActive());
andrew@webrtc.orga8b97372014-03-10 22:26:12 +0000601
peahde65ddc2016-09-16 15:02:15 -0700602 capture_nonlocked_.capture_processing_format =
603 StreamConfig(capture_processing_rate);
peah2ace3f92016-09-10 04:42:27 -0700604
peah2ce640f2017-04-07 03:57:48 -0700605 int render_processing_rate;
Gustaf Ullbergbd83b912017-10-18 12:32:42 +0200606 if (!capture_nonlocked_.echo_controller_enabled) {
peah2ce640f2017-04-07 03:57:48 -0700607 render_processing_rate = FindNativeProcessRateToUse(
608 std::min(formats_.api_format.reverse_input_stream().sample_rate_hz(),
609 formats_.api_format.reverse_output_stream().sample_rate_hz()),
610 submodule_states_.CaptureMultiBandSubModulesActive() ||
611 submodule_states_.RenderMultiBandSubModulesActive());
612 } else {
613 render_processing_rate = capture_processing_rate;
614 }
615
aluebseb3603b2016-04-20 15:27:58 -0700616 // TODO(aluebs): Remove this restriction once we figure out why the 3-band
617 // splitting filter degrades the AEC performance.
peahcf02cf12017-04-05 14:18:07 -0700618 if (render_processing_rate > kSampleRate32kHz &&
Gustaf Ullbergbd83b912017-10-18 12:32:42 +0200619 !capture_nonlocked_.echo_controller_enabled) {
peahde65ddc2016-09-16 15:02:15 -0700620 render_processing_rate = submodule_states_.RenderMultiBandProcessingActive()
621 ? kSampleRate32kHz
622 : kSampleRate16kHz;
aluebseb3603b2016-04-20 15:27:58 -0700623 }
peah2ce640f2017-04-07 03:57:48 -0700624
peahde65ddc2016-09-16 15:02:15 -0700625 // If the forward sample rate is 8 kHz, the render stream is also processed
aluebseb3603b2016-04-20 15:27:58 -0700626 // at this rate.
peahde65ddc2016-09-16 15:02:15 -0700627 if (capture_nonlocked_.capture_processing_format.sample_rate_hz() ==
628 kSampleRate8kHz) {
629 render_processing_rate = kSampleRate8kHz;
andrew@webrtc.orga8b97372014-03-10 22:26:12 +0000630 } else {
peahde65ddc2016-09-16 15:02:15 -0700631 render_processing_rate =
632 std::max(render_processing_rate, static_cast<int>(kSampleRate16kHz));
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000633 }
634
peahde65ddc2016-09-16 15:02:15 -0700635 // Always downmix the render stream to mono for analysis. This has been
andrew@webrtc.org30be8272014-09-24 20:06:23 +0000636 // demonstrated to work well for AEC in most practical scenarios.
peahce4d9152017-05-19 01:28:05 -0700637 if (submodule_states_.RenderMultiBandSubModulesActive()) {
638 formats_.render_processing_format = StreamConfig(render_processing_rate, 1);
639 } else {
640 formats_.render_processing_format = StreamConfig(
641 formats_.api_format.reverse_input_stream().sample_rate_hz(),
642 formats_.api_format.reverse_input_stream().num_channels());
643 }
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000644
peahde65ddc2016-09-16 15:02:15 -0700645 if (capture_nonlocked_.capture_processing_format.sample_rate_hz() ==
646 kSampleRate32kHz ||
647 capture_nonlocked_.capture_processing_format.sample_rate_hz() ==
648 kSampleRate48kHz) {
peahdf3efa82015-11-28 12:35:15 -0800649 capture_nonlocked_.split_rate = kSampleRate16kHz;
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000650 } else {
peahdf3efa82015-11-28 12:35:15 -0800651 capture_nonlocked_.split_rate =
peahde65ddc2016-09-16 15:02:15 -0700652 capture_nonlocked_.capture_processing_format.sample_rate_hz();
andrew@webrtc.orga8b97372014-03-10 22:26:12 +0000653 }
654
655 return InitializeLocked();
656}
657
peah88ac8532016-09-12 16:47:25 -0700658void AudioProcessingImpl::ApplyConfig(const AudioProcessing::Config& config) {
peahc19f3122016-10-07 14:54:10 -0700659 config_ = config;
peah88ac8532016-09-12 16:47:25 -0700660
peahc19f3122016-10-07 14:54:10 -0700661 bool config_ok = LevelController::Validate(config_.level_controller);
peah88ac8532016-09-12 16:47:25 -0700662 if (!config_ok) {
663 LOG(LS_ERROR) << "AudioProcessing module config error" << std::endl
664 << "level_controller: "
peahc19f3122016-10-07 14:54:10 -0700665 << LevelController::ToString(config_.level_controller)
peah88ac8532016-09-12 16:47:25 -0700666 << std::endl
667 << "Reverting to default parameter set";
peahc19f3122016-10-07 14:54:10 -0700668 config_.level_controller = AudioProcessing::Config::LevelController();
peah88ac8532016-09-12 16:47:25 -0700669 }
670
671 // Run in a single-threaded manner when applying the settings.
672 rtc::CritScope cs_render(&crit_render_);
673 rtc::CritScope cs_capture(&crit_capture_);
674
peahc19f3122016-10-07 14:54:10 -0700675 // TODO(peah): Replace the use of capture_nonlocked_.level_controller_enabled
676 // with the value in config_ everywhere in the code.
677 if (capture_nonlocked_.level_controller_enabled !=
678 config_.level_controller.enabled) {
peah88ac8532016-09-12 16:47:25 -0700679 capture_nonlocked_.level_controller_enabled =
peahc19f3122016-10-07 14:54:10 -0700680 config_.level_controller.enabled;
681 // TODO(peah): Remove the conditional initialization to always initialize
682 // the level controller regardless of whether it is enabled or not.
683 InitializeLevelController();
peah88ac8532016-09-12 16:47:25 -0700684 }
peahc19f3122016-10-07 14:54:10 -0700685 LOG(LS_INFO) << "Level controller activated: "
686 << capture_nonlocked_.level_controller_enabled;
687
688 private_submodules_->level_controller->ApplyConfig(config_.level_controller);
peah8271d042016-11-22 07:24:52 -0800689
690 InitializeLowCutFilter();
691
692 LOG(LS_INFO) << "Highpass filter activated: "
693 << config_.high_pass_filter.enabled;
peahe0eae3c2016-12-14 01:16:23 -0800694
Gustaf Ullbergbd83b912017-10-18 12:32:42 +0200695 // Deprecated way of activating AEC3.
696 // TODO(gustaf): Remove when possible.
Gustaf Ullberg8eb9c7d2017-10-14 08:28:46 +0200697 if (config.echo_canceller3.enabled && !echo_control_factory_) {
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200698 capture_nonlocked_.echo_controller_enabled =
peahe0eae3c2016-12-14 01:16:23 -0800699 config_.echo_canceller3.enabled;
Gustaf Ullbergbd83b912017-10-18 12:32:42 +0200700 echo_control_factory_ =
701 std::unique_ptr<EchoControlFactory>(new EchoCanceller3Factory());
Gustaf Ullberg8eb9c7d2017-10-14 08:28:46 +0200702 InitializeEchoController();
peahe0eae3c2016-12-14 01:16:23 -0800703 LOG(LS_INFO) << "Echo canceller 3 activated: "
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200704 << capture_nonlocked_.echo_controller_enabled;
peahe0eae3c2016-12-14 01:16:23 -0800705 }
alessiob3ec96df2017-05-22 06:57:06 -0700706
707 config_ok = GainController2::Validate(config_.gain_controller2);
708 if (!config_ok) {
709 LOG(LS_ERROR) << "AudioProcessing module config error" << std::endl
Alessio Bazzica270f7b52017-10-13 11:05:17 +0200710 << "Gain Controller 2: "
alessiob3ec96df2017-05-22 06:57:06 -0700711 << GainController2::ToString(config_.gain_controller2)
712 << std::endl
713 << "Reverting to default parameter set";
714 config_.gain_controller2 = AudioProcessing::Config::GainController2();
715 }
Alessio Bazzica270f7b52017-10-13 11:05:17 +0200716 InitializeGainController2();
717 private_submodules_->gain_controller2->ApplyConfig(config_.gain_controller2);
718 LOG(LS_INFO) << "Gain Controller 2 activated: "
719 << config_.gain_controller2.enabled;
peah88ac8532016-09-12 16:47:25 -0700720}
721
722void AudioProcessingImpl::SetExtraOptions(const webrtc::Config& config) {
peahdf3efa82015-11-28 12:35:15 -0800723 // Run in a single-threaded manner when setting the extra options.
724 rtc::CritScope cs_render(&crit_render_);
725 rtc::CritScope cs_capture(&crit_capture_);
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000726
peahb624d8c2016-03-05 03:01:14 -0800727 public_submodules_->echo_cancellation->SetExtraOptions(config);
728
peahdf3efa82015-11-28 12:35:15 -0800729 if (capture_.transient_suppressor_enabled !=
730 config.Get<ExperimentalNs>().enabled) {
731 capture_.transient_suppressor_enabled =
732 config.Get<ExperimentalNs>().enabled;
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000733 InitializeTransient();
734 }
aluebs2a346882016-01-11 18:04:30 -0800735
peah1bcfce52016-08-26 07:16:04 -0700736#if WEBRTC_INTELLIGIBILITY_ENHANCER
alessiob3ec96df2017-05-22 06:57:06 -0700737 if (capture_nonlocked_.intelligibility_enabled !=
Alejandro Luebsc9b0c262016-05-16 15:32:38 -0700738 config.Get<Intelligibility>().enabled) {
739 capture_nonlocked_.intelligibility_enabled =
740 config.Get<Intelligibility>().enabled;
741 InitializeIntelligibility();
742 }
peah1bcfce52016-08-26 07:16:04 -0700743#endif
Alejandro Luebsc9b0c262016-05-16 15:32:38 -0700744
aluebs2a346882016-01-11 18:04:30 -0800745#ifdef WEBRTC_ANDROID_PLATFORM_BUILD
aluebsb2328d12016-01-11 20:32:29 -0800746 if (capture_nonlocked_.beamformer_enabled !=
747 config.Get<Beamforming>().enabled) {
748 capture_nonlocked_.beamformer_enabled = config.Get<Beamforming>().enabled;
aluebs2a346882016-01-11 18:04:30 -0800749 if (config.Get<Beamforming>().array_geometry.size() > 1) {
750 capture_.array_geometry = config.Get<Beamforming>().array_geometry;
751 }
752 capture_.target_direction = config.Get<Beamforming>().target_direction;
753 InitializeBeamformer();
754 }
755#endif // WEBRTC_ANDROID_PLATFORM_BUILD
andrew@webrtc.org61e596f2013-07-25 18:28:29 +0000756}
757
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000758int AudioProcessingImpl::proc_sample_rate_hz() const {
peahdf3efa82015-11-28 12:35:15 -0800759 // Used as callback from submodules, hence locking is not allowed.
peahde65ddc2016-09-16 15:02:15 -0700760 return capture_nonlocked_.capture_processing_format.sample_rate_hz();
niklase@google.com470e71d2011-07-07 08:21:25 +0000761}
762
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000763int AudioProcessingImpl::proc_split_sample_rate_hz() const {
peahdf3efa82015-11-28 12:35:15 -0800764 // Used as callback from submodules, hence locking is not allowed.
765 return capture_nonlocked_.split_rate;
niklase@google.com470e71d2011-07-07 08:21:25 +0000766}
767
Peter Kasting69558702016-01-12 16:26:35 -0800768size_t AudioProcessingImpl::num_reverse_channels() const {
peahdf3efa82015-11-28 12:35:15 -0800769 // Used as callback from submodules, hence locking is not allowed.
peahde65ddc2016-09-16 15:02:15 -0700770 return formats_.render_processing_format.num_channels();
niklase@google.com470e71d2011-07-07 08:21:25 +0000771}
772
Peter Kasting69558702016-01-12 16:26:35 -0800773size_t AudioProcessingImpl::num_input_channels() const {
peahdf3efa82015-11-28 12:35:15 -0800774 // Used as callback from submodules, hence locking is not allowed.
775 return formats_.api_format.input_stream().num_channels();
niklase@google.com470e71d2011-07-07 08:21:25 +0000776}
777
Peter Kasting69558702016-01-12 16:26:35 -0800778size_t AudioProcessingImpl::num_proc_channels() const {
aluebsb2328d12016-01-11 20:32:29 -0800779 // Used as callback from submodules, hence locking is not allowed.
peahedddac52017-05-16 01:08:58 -0700780 return (capture_nonlocked_.beamformer_enabled ||
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200781 capture_nonlocked_.echo_controller_enabled)
peahedddac52017-05-16 01:08:58 -0700782 ? 1
783 : num_output_channels();
aluebsb2328d12016-01-11 20:32:29 -0800784}
785
Peter Kasting69558702016-01-12 16:26:35 -0800786size_t AudioProcessingImpl::num_output_channels() const {
peahdf3efa82015-11-28 12:35:15 -0800787 // Used as callback from submodules, hence locking is not allowed.
788 return formats_.api_format.output_stream().num_channels();
niklase@google.com470e71d2011-07-07 08:21:25 +0000789}
790
andrew@webrtc.org17342e52014-02-12 22:28:31 +0000791void AudioProcessingImpl::set_output_will_be_muted(bool muted) {
peahdf3efa82015-11-28 12:35:15 -0800792 rtc::CritScope cs(&crit_capture_);
793 capture_.output_will_be_muted = muted;
794 if (private_submodules_->agc_manager.get()) {
795 private_submodules_->agc_manager->SetCaptureMuted(
796 capture_.output_will_be_muted);
pbos@webrtc.org788acd12014-12-15 09:41:24 +0000797 }
andrew@webrtc.org17342e52014-02-12 22:28:31 +0000798}
799
andrew@webrtc.org17342e52014-02-12 22:28:31 +0000800
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000801int AudioProcessingImpl::ProcessStream(const float* const* src,
Peter Kastingdce40cf2015-08-24 14:52:23 -0700802 size_t samples_per_channel,
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000803 int input_sample_rate_hz,
andrew@webrtc.org17e40642014-03-04 20:58:13 +0000804 ChannelLayout input_layout,
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000805 int output_sample_rate_hz,
806 ChannelLayout output_layout,
807 float* const* dest) {
peah369f8282015-12-17 06:42:29 -0800808 TRACE_EVENT0("webrtc", "AudioProcessing::ProcessStream_ChannelLayout");
peahdf3efa82015-11-28 12:35:15 -0800809 StreamConfig input_stream;
810 StreamConfig output_stream;
811 {
812 // Access the formats_.api_format.input_stream beneath the capture lock.
813 // The lock must be released as it is later required in the call
814 // to ProcessStream(,,,);
815 rtc::CritScope cs(&crit_capture_);
816 input_stream = formats_.api_format.input_stream();
817 output_stream = formats_.api_format.output_stream();
818 }
819
Michael Graczyk86c6d332015-07-23 11:41:39 -0700820 input_stream.set_sample_rate_hz(input_sample_rate_hz);
821 input_stream.set_num_channels(ChannelsFromLayout(input_layout));
822 input_stream.set_has_keyboard(LayoutHasKeyboard(input_layout));
Michael Graczyk86c6d332015-07-23 11:41:39 -0700823 output_stream.set_sample_rate_hz(output_sample_rate_hz);
824 output_stream.set_num_channels(ChannelsFromLayout(output_layout));
825 output_stream.set_has_keyboard(LayoutHasKeyboard(output_layout));
826
827 if (samples_per_channel != input_stream.num_frames()) {
828 return kBadDataLengthError;
829 }
830 return ProcessStream(src, input_stream, output_stream, dest);
831}
832
833int AudioProcessingImpl::ProcessStream(const float* const* src,
834 const StreamConfig& input_config,
835 const StreamConfig& output_config,
836 float* const* dest) {
peah369f8282015-12-17 06:42:29 -0800837 TRACE_EVENT0("webrtc", "AudioProcessing::ProcessStream_StreamConfig");
peahdf3efa82015-11-28 12:35:15 -0800838 ProcessingConfig processing_config;
peah2ace3f92016-09-10 04:42:27 -0700839 bool reinitialization_required = false;
peahdf3efa82015-11-28 12:35:15 -0800840 {
841 // Acquire the capture lock in order to safely call the function
842 // that retrieves the render side data. This function accesses apm
843 // getters that need the capture lock held when being called.
844 rtc::CritScope cs_capture(&crit_capture_);
peah764e3642016-10-22 05:04:30 -0700845 EmptyQueuedRenderAudio();
peahdf3efa82015-11-28 12:35:15 -0800846
847 if (!src || !dest) {
848 return kNullPointerError;
849 }
850
851 processing_config = formats_.api_format;
peah2ace3f92016-09-10 04:42:27 -0700852 reinitialization_required = UpdateActiveSubmoduleStates();
niklase@google.com470e71d2011-07-07 08:21:25 +0000853 }
andrew@webrtc.org17e40642014-03-04 20:58:13 +0000854
Michael Graczyk86c6d332015-07-23 11:41:39 -0700855 processing_config.input_stream() = input_config;
856 processing_config.output_stream() = output_config;
857
peahdf3efa82015-11-28 12:35:15 -0800858 {
859 // Do conditional reinitialization.
860 rtc::CritScope cs_render(&crit_render_);
peah2ace3f92016-09-10 04:42:27 -0700861 RETURN_ON_ERR(
862 MaybeInitializeCapture(processing_config, reinitialization_required));
peahdf3efa82015-11-28 12:35:15 -0800863 }
864 rtc::CritScope cs_capture(&crit_capture_);
kwiberg9e2be5f2016-09-14 05:23:22 -0700865 RTC_DCHECK_EQ(processing_config.input_stream().num_frames(),
866 formats_.api_format.input_stream().num_frames());
andrew@webrtc.org17e40642014-03-04 20:58:13 +0000867
aleloi868f32f2017-05-23 07:20:05 -0700868 if (aec_dump_) {
869 RecordUnprocessedCaptureStream(src);
870 }
871
peahdf3efa82015-11-28 12:35:15 -0800872 capture_.capture_audio->CopyFrom(src, formats_.api_format.input_stream());
peahde65ddc2016-09-16 15:02:15 -0700873 RETURN_ON_ERR(ProcessCaptureStreamLocked());
peahdf3efa82015-11-28 12:35:15 -0800874 capture_.capture_audio->CopyTo(formats_.api_format.output_stream(), dest);
andrew@webrtc.org17e40642014-03-04 20:58:13 +0000875
aleloi868f32f2017-05-23 07:20:05 -0700876 if (aec_dump_) {
877 RecordProcessedCaptureStream(dest);
878 }
andrew@webrtc.org17e40642014-03-04 20:58:13 +0000879 return kNoError;
880}
881
peah9e6a2902017-05-15 07:19:21 -0700882void AudioProcessingImpl::QueueBandedRenderAudio(AudioBuffer* audio) {
peah764e3642016-10-22 05:04:30 -0700883 EchoCancellationImpl::PackRenderAudioBuffer(audio, num_output_channels(),
884 num_reverse_channels(),
peah701d6282016-10-25 05:42:20 -0700885 &aec_render_queue_buffer_);
peah764e3642016-10-22 05:04:30 -0700886
kwibergaf476c72016-11-28 15:21:39 -0800887 RTC_DCHECK_GE(160, audio->num_frames_per_band());
peah764e3642016-10-22 05:04:30 -0700888
889 // Insert the samples into the queue.
peah701d6282016-10-25 05:42:20 -0700890 if (!aec_render_signal_queue_->Insert(&aec_render_queue_buffer_)) {
peah764e3642016-10-22 05:04:30 -0700891 // The data queue is full and needs to be emptied.
892 EmptyQueuedRenderAudio();
893
894 // Retry the insert (should always work).
peah701d6282016-10-25 05:42:20 -0700895 bool result = aec_render_signal_queue_->Insert(&aec_render_queue_buffer_);
peaha0624602016-10-25 04:45:24 -0700896 RTC_DCHECK(result);
897 }
898
899 EchoControlMobileImpl::PackRenderAudioBuffer(audio, num_output_channels(),
900 num_reverse_channels(),
peah701d6282016-10-25 05:42:20 -0700901 &aecm_render_queue_buffer_);
peaha0624602016-10-25 04:45:24 -0700902
903 // Insert the samples into the queue.
peah701d6282016-10-25 05:42:20 -0700904 if (!aecm_render_signal_queue_->Insert(&aecm_render_queue_buffer_)) {
peaha0624602016-10-25 04:45:24 -0700905 // The data queue is full and needs to be emptied.
906 EmptyQueuedRenderAudio();
907
908 // Retry the insert (should always work).
peah701d6282016-10-25 05:42:20 -0700909 bool result = aecm_render_signal_queue_->Insert(&aecm_render_queue_buffer_);
peah764e3642016-10-22 05:04:30 -0700910 RTC_DCHECK(result);
911 }
peah701d6282016-10-25 05:42:20 -0700912
913 if (!constants_.use_experimental_agc) {
914 GainControlImpl::PackRenderAudioBuffer(audio, &agc_render_queue_buffer_);
915 // Insert the samples into the queue.
916 if (!agc_render_signal_queue_->Insert(&agc_render_queue_buffer_)) {
917 // The data queue is full and needs to be emptied.
918 EmptyQueuedRenderAudio();
919
920 // Retry the insert (should always work).
921 bool result = agc_render_signal_queue_->Insert(&agc_render_queue_buffer_);
922 RTC_DCHECK(result);
923 }
924 }
peah9e6a2902017-05-15 07:19:21 -0700925}
ivoc9f4a4a02016-10-28 05:39:16 -0700926
peah9e6a2902017-05-15 07:19:21 -0700927void AudioProcessingImpl::QueueNonbandedRenderAudio(AudioBuffer* audio) {
ivoc9f4a4a02016-10-28 05:39:16 -0700928 ResidualEchoDetector::PackRenderAudioBuffer(audio, &red_render_queue_buffer_);
929
930 // Insert the samples into the queue.
931 if (!red_render_signal_queue_->Insert(&red_render_queue_buffer_)) {
932 // The data queue is full and needs to be emptied.
933 EmptyQueuedRenderAudio();
934
935 // Retry the insert (should always work).
936 bool result = red_render_signal_queue_->Insert(&red_render_queue_buffer_);
937 RTC_DCHECK(result);
938 }
peah764e3642016-10-22 05:04:30 -0700939}
940
941void AudioProcessingImpl::AllocateRenderQueue() {
peah701d6282016-10-25 05:42:20 -0700942 const size_t new_aec_render_queue_element_max_size =
peah764e3642016-10-22 05:04:30 -0700943 std::max(static_cast<size_t>(1),
peah9e6a2902017-05-15 07:19:21 -0700944 kMaxAllowedValuesOfSamplesPerBand *
peah764e3642016-10-22 05:04:30 -0700945 EchoCancellationImpl::NumCancellersRequired(
946 num_output_channels(), num_reverse_channels()));
947
peah701d6282016-10-25 05:42:20 -0700948 const size_t new_aecm_render_queue_element_max_size =
peaha0624602016-10-25 04:45:24 -0700949 std::max(static_cast<size_t>(1),
peah9e6a2902017-05-15 07:19:21 -0700950 kMaxAllowedValuesOfSamplesPerBand *
peaha0624602016-10-25 04:45:24 -0700951 EchoControlMobileImpl::NumCancellersRequired(
952 num_output_channels(), num_reverse_channels()));
peah764e3642016-10-22 05:04:30 -0700953
peah701d6282016-10-25 05:42:20 -0700954 const size_t new_agc_render_queue_element_max_size =
peah9e6a2902017-05-15 07:19:21 -0700955 std::max(static_cast<size_t>(1), kMaxAllowedValuesOfSamplesPerBand);
peah701d6282016-10-25 05:42:20 -0700956
ivoc9f4a4a02016-10-28 05:39:16 -0700957 const size_t new_red_render_queue_element_max_size =
958 std::max(static_cast<size_t>(1), kMaxAllowedValuesOfSamplesPerFrame);
959
peaha0624602016-10-25 04:45:24 -0700960 // Reallocate the queues if the queue item sizes are too small to fit the
961 // data to put in the queues.
peah701d6282016-10-25 05:42:20 -0700962 if (aec_render_queue_element_max_size_ <
963 new_aec_render_queue_element_max_size) {
964 aec_render_queue_element_max_size_ = new_aec_render_queue_element_max_size;
peah764e3642016-10-22 05:04:30 -0700965
peaha0624602016-10-25 04:45:24 -0700966 std::vector<float> template_queue_element(
peah701d6282016-10-25 05:42:20 -0700967 aec_render_queue_element_max_size_);
peaha0624602016-10-25 04:45:24 -0700968
peah701d6282016-10-25 05:42:20 -0700969 aec_render_signal_queue_.reset(
peah764e3642016-10-22 05:04:30 -0700970 new SwapQueue<std::vector<float>, RenderQueueItemVerifier<float>>(
971 kMaxNumFramesToBuffer, template_queue_element,
peaha0624602016-10-25 04:45:24 -0700972 RenderQueueItemVerifier<float>(
peah701d6282016-10-25 05:42:20 -0700973 aec_render_queue_element_max_size_)));
peah764e3642016-10-22 05:04:30 -0700974
peah701d6282016-10-25 05:42:20 -0700975 aec_render_queue_buffer_.resize(aec_render_queue_element_max_size_);
976 aec_capture_queue_buffer_.resize(aec_render_queue_element_max_size_);
peah764e3642016-10-22 05:04:30 -0700977 } else {
peah701d6282016-10-25 05:42:20 -0700978 aec_render_signal_queue_->Clear();
peaha0624602016-10-25 04:45:24 -0700979 }
980
peah701d6282016-10-25 05:42:20 -0700981 if (aecm_render_queue_element_max_size_ <
982 new_aecm_render_queue_element_max_size) {
983 aecm_render_queue_element_max_size_ =
984 new_aecm_render_queue_element_max_size;
peaha0624602016-10-25 04:45:24 -0700985
986 std::vector<int16_t> template_queue_element(
peah701d6282016-10-25 05:42:20 -0700987 aecm_render_queue_element_max_size_);
peaha0624602016-10-25 04:45:24 -0700988
peah701d6282016-10-25 05:42:20 -0700989 aecm_render_signal_queue_.reset(
peaha0624602016-10-25 04:45:24 -0700990 new SwapQueue<std::vector<int16_t>, RenderQueueItemVerifier<int16_t>>(
991 kMaxNumFramesToBuffer, template_queue_element,
992 RenderQueueItemVerifier<int16_t>(
peah701d6282016-10-25 05:42:20 -0700993 aecm_render_queue_element_max_size_)));
peaha0624602016-10-25 04:45:24 -0700994
peah701d6282016-10-25 05:42:20 -0700995 aecm_render_queue_buffer_.resize(aecm_render_queue_element_max_size_);
996 aecm_capture_queue_buffer_.resize(aecm_render_queue_element_max_size_);
peaha0624602016-10-25 04:45:24 -0700997 } else {
peah701d6282016-10-25 05:42:20 -0700998 aecm_render_signal_queue_->Clear();
999 }
1000
1001 if (agc_render_queue_element_max_size_ <
1002 new_agc_render_queue_element_max_size) {
1003 agc_render_queue_element_max_size_ = new_agc_render_queue_element_max_size;
1004
1005 std::vector<int16_t> template_queue_element(
1006 agc_render_queue_element_max_size_);
1007
1008 agc_render_signal_queue_.reset(
1009 new SwapQueue<std::vector<int16_t>, RenderQueueItemVerifier<int16_t>>(
1010 kMaxNumFramesToBuffer, template_queue_element,
1011 RenderQueueItemVerifier<int16_t>(
1012 agc_render_queue_element_max_size_)));
1013
1014 agc_render_queue_buffer_.resize(agc_render_queue_element_max_size_);
1015 agc_capture_queue_buffer_.resize(agc_render_queue_element_max_size_);
1016 } else {
1017 agc_render_signal_queue_->Clear();
peah764e3642016-10-22 05:04:30 -07001018 }
ivoc9f4a4a02016-10-28 05:39:16 -07001019
1020 if (red_render_queue_element_max_size_ <
1021 new_red_render_queue_element_max_size) {
1022 red_render_queue_element_max_size_ = new_red_render_queue_element_max_size;
1023
1024 std::vector<float> template_queue_element(
1025 red_render_queue_element_max_size_);
1026
1027 red_render_signal_queue_.reset(
1028 new SwapQueue<std::vector<float>, RenderQueueItemVerifier<float>>(
1029 kMaxNumFramesToBuffer, template_queue_element,
1030 RenderQueueItemVerifier<float>(
1031 red_render_queue_element_max_size_)));
1032
1033 red_render_queue_buffer_.resize(red_render_queue_element_max_size_);
1034 red_capture_queue_buffer_.resize(red_render_queue_element_max_size_);
1035 } else {
1036 red_render_signal_queue_->Clear();
1037 }
peah764e3642016-10-22 05:04:30 -07001038}
1039
1040void AudioProcessingImpl::EmptyQueuedRenderAudio() {
1041 rtc::CritScope cs_capture(&crit_capture_);
peah701d6282016-10-25 05:42:20 -07001042 while (aec_render_signal_queue_->Remove(&aec_capture_queue_buffer_)) {
peah764e3642016-10-22 05:04:30 -07001043 public_submodules_->echo_cancellation->ProcessRenderAudio(
peah701d6282016-10-25 05:42:20 -07001044 aec_capture_queue_buffer_);
peaha0624602016-10-25 04:45:24 -07001045 }
1046
peah701d6282016-10-25 05:42:20 -07001047 while (aecm_render_signal_queue_->Remove(&aecm_capture_queue_buffer_)) {
peaha0624602016-10-25 04:45:24 -07001048 public_submodules_->echo_control_mobile->ProcessRenderAudio(
peah701d6282016-10-25 05:42:20 -07001049 aecm_capture_queue_buffer_);
1050 }
1051
1052 while (agc_render_signal_queue_->Remove(&agc_capture_queue_buffer_)) {
1053 public_submodules_->gain_control->ProcessRenderAudio(
1054 agc_capture_queue_buffer_);
peah764e3642016-10-22 05:04:30 -07001055 }
ivoc9f4a4a02016-10-28 05:39:16 -07001056
1057 while (red_render_signal_queue_->Remove(&red_capture_queue_buffer_)) {
1058 private_submodules_->residual_echo_detector->AnalyzeRenderAudio(
1059 red_capture_queue_buffer_);
1060 }
peah764e3642016-10-22 05:04:30 -07001061}
1062
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001063int AudioProcessingImpl::ProcessStream(AudioFrame* frame) {
peah369f8282015-12-17 06:42:29 -08001064 TRACE_EVENT0("webrtc", "AudioProcessing::ProcessStream_AudioFrame");
peahdf3efa82015-11-28 12:35:15 -08001065 {
1066 // Acquire the capture lock in order to safely call the function
1067 // that retrieves the render side data. This function accesses apm
1068 // getters that need the capture lock held when being called.
1069 // The lock needs to be released as
1070 // public_submodules_->echo_control_mobile->is_enabled() aquires this lock
1071 // as well.
1072 rtc::CritScope cs_capture(&crit_capture_);
peah764e3642016-10-22 05:04:30 -07001073 EmptyQueuedRenderAudio();
peahdf3efa82015-11-28 12:35:15 -08001074 }
peahfa6228e2015-11-16 16:27:42 -08001075
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001076 if (!frame) {
1077 return kNullPointerError;
1078 }
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +00001079 // Must be a native rate.
1080 if (frame->sample_rate_hz_ != kSampleRate8kHz &&
1081 frame->sample_rate_hz_ != kSampleRate16kHz &&
aluebs@webrtc.org087da132014-11-17 23:01:23 +00001082 frame->sample_rate_hz_ != kSampleRate32kHz &&
1083 frame->sample_rate_hz_ != kSampleRate48kHz) {
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +00001084 return kBadSampleRateError;
1085 }
peah192164e2015-11-17 02:16:45 -08001086
peahdf3efa82015-11-28 12:35:15 -08001087 ProcessingConfig processing_config;
peah2ace3f92016-09-10 04:42:27 -07001088 bool reinitialization_required = false;
peahdf3efa82015-11-28 12:35:15 -08001089 {
1090 // Aquire lock for the access of api_format.
1091 // The lock is released immediately due to the conditional
1092 // reinitialization.
1093 rtc::CritScope cs_capture(&crit_capture_);
1094 // TODO(ajm): The input and output rates and channels are currently
1095 // constrained to be identical in the int16 interface.
1096 processing_config = formats_.api_format;
peah2ace3f92016-09-10 04:42:27 -07001097
1098 reinitialization_required = UpdateActiveSubmoduleStates();
peahdf3efa82015-11-28 12:35:15 -08001099 }
Michael Graczyk86c6d332015-07-23 11:41:39 -07001100 processing_config.input_stream().set_sample_rate_hz(frame->sample_rate_hz_);
1101 processing_config.input_stream().set_num_channels(frame->num_channels_);
1102 processing_config.output_stream().set_sample_rate_hz(frame->sample_rate_hz_);
1103 processing_config.output_stream().set_num_channels(frame->num_channels_);
1104
peahdf3efa82015-11-28 12:35:15 -08001105 {
1106 // Do conditional reinitialization.
1107 rtc::CritScope cs_render(&crit_render_);
peah2ace3f92016-09-10 04:42:27 -07001108 RETURN_ON_ERR(
1109 MaybeInitializeCapture(processing_config, reinitialization_required));
peahdf3efa82015-11-28 12:35:15 -08001110 }
1111 rtc::CritScope cs_capture(&crit_capture_);
peah192164e2015-11-17 02:16:45 -08001112 if (frame->samples_per_channel_ !=
peahdf3efa82015-11-28 12:35:15 -08001113 formats_.api_format.input_stream().num_frames()) {
niklase@google.com470e71d2011-07-07 08:21:25 +00001114 return kBadDataLengthError;
1115 }
1116
aleloi868f32f2017-05-23 07:20:05 -07001117 if (aec_dump_) {
1118 RecordUnprocessedCaptureStream(*frame);
1119 }
1120
peahdf3efa82015-11-28 12:35:15 -08001121 capture_.capture_audio->DeinterleaveFrom(frame);
peahde65ddc2016-09-16 15:02:15 -07001122 RETURN_ON_ERR(ProcessCaptureStreamLocked());
peah2ace3f92016-09-10 04:42:27 -07001123 capture_.capture_audio->InterleaveTo(
peah23ac8b42017-05-23 05:33:56 -07001124 frame, submodule_states_.CaptureMultiBandProcessingActive() ||
1125 submodule_states_.CaptureFullBandProcessingActive());
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001126
aleloi868f32f2017-05-23 07:20:05 -07001127 if (aec_dump_) {
1128 RecordProcessedCaptureStream(*frame);
1129 }
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001130
1131 return kNoError;
1132}
1133
peahde65ddc2016-09-16 15:02:15 -07001134int AudioProcessingImpl::ProcessCaptureStreamLocked() {
peahb58a1582016-03-15 09:34:24 -07001135 // Ensure that not both the AEC and AECM are active at the same time.
1136 // TODO(peah): Simplify once the public API Enable functions for these
1137 // are moved to APM.
1138 RTC_DCHECK(!(public_submodules_->echo_cancellation->is_enabled() &&
1139 public_submodules_->echo_control_mobile->is_enabled()));
1140
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001141 MaybeUpdateHistograms();
1142
peahde65ddc2016-09-16 15:02:15 -07001143 AudioBuffer* capture_buffer = capture_.capture_audio.get(); // For brevity.
ekmeyerson60d9b332015-08-14 10:35:55 -07001144
peah1b08dc32016-12-20 13:45:58 -08001145 capture_input_rms_.Analyze(rtc::ArrayView<const int16_t>(
henrik.lundin290d43a2016-11-29 08:09:09 -08001146 capture_buffer->channels_const()[0],
1147 capture_nonlocked_.capture_processing_format.num_frames()));
peah1b08dc32016-12-20 13:45:58 -08001148 const bool log_rms = ++capture_rms_interval_counter_ >= 1000;
1149 if (log_rms) {
1150 capture_rms_interval_counter_ = 0;
1151 RmsLevel::Levels levels = capture_input_rms_.AverageAndPeak();
henrik.lundin45bb5132016-12-06 04:28:04 -08001152 RTC_HISTOGRAM_COUNTS_LINEAR("WebRTC.Audio.ApmCaptureInputLevelAverageRms",
1153 levels.average, 1, RmsLevel::kMinLevelDb, 64);
1154 RTC_HISTOGRAM_COUNTS_LINEAR("WebRTC.Audio.ApmCaptureInputLevelPeakRms",
1155 levels.peak, 1, RmsLevel::kMinLevelDb, 64);
henrik.lundin290d43a2016-11-29 08:09:09 -08001156 }
1157
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001158 if (private_submodules_->echo_controller) {
Per Ã…hgren9aed31c2017-06-29 20:23:27 +02001159 // TODO(peah): Reactivate analogue AGC gain detection once the analogue AGC
1160 // issues have been addressed.
1161 capture_.echo_path_gain_change = false;
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001162 private_submodules_->echo_controller->AnalyzeCapture(capture_buffer);
peahe0eae3c2016-12-14 01:16:23 -08001163 }
1164
peahbe615622016-02-13 16:40:47 -08001165 if (constants_.use_experimental_agc &&
peahdf3efa82015-11-28 12:35:15 -08001166 public_submodules_->gain_control->is_enabled()) {
1167 private_submodules_->agc_manager->AnalyzePreProcess(
peahde65ddc2016-09-16 15:02:15 -07001168 capture_buffer->channels()[0], capture_buffer->num_channels(),
1169 capture_nonlocked_.capture_processing_format.num_frames());
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001170 }
1171
peah2ace3f92016-09-10 04:42:27 -07001172 if (submodule_states_.CaptureMultiBandSubModulesActive() &&
1173 SampleRateSupportsMultiBand(
peahde65ddc2016-09-16 15:02:15 -07001174 capture_nonlocked_.capture_processing_format.sample_rate_hz())) {
1175 capture_buffer->SplitIntoFrequencyBands();
niklase@google.com470e71d2011-07-07 08:21:25 +00001176 }
1177
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001178 if (private_submodules_->echo_controller) {
peah522d71b2017-02-23 05:16:26 -08001179 // Force down-mixing of the number of channels after the detection of
1180 // capture signal saturation.
1181 // TODO(peah): Look into ensuring that this kind of tampering with the
1182 // AudioBuffer functionality should not be needed.
1183 capture_buffer->set_num_channels(1);
1184 }
1185
aluebsb2328d12016-01-11 20:32:29 -08001186 if (capture_nonlocked_.beamformer_enabled) {
peahde65ddc2016-09-16 15:02:15 -07001187 private_submodules_->beamformer->AnalyzeChunk(
1188 *capture_buffer->split_data_f());
Alejandro Luebsf4022ff2016-07-01 17:19:09 -07001189 // Discards all channels by the leftmost one.
peahde65ddc2016-09-16 15:02:15 -07001190 capture_buffer->set_num_channels(1);
aluebs@webrtc.orgae643ce2014-12-19 19:57:34 +00001191 }
aluebs@webrtc.orgae643ce2014-12-19 19:57:34 +00001192
peahe0eae3c2016-12-14 01:16:23 -08001193 // TODO(peah): Move the AEC3 low-cut filter to this place.
1194 if (private_submodules_->low_cut_filter &&
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001195 !private_submodules_->echo_controller) {
peah8271d042016-11-22 07:24:52 -08001196 private_submodules_->low_cut_filter->Process(capture_buffer);
1197 }
peahde65ddc2016-09-16 15:02:15 -07001198 RETURN_ON_ERR(
1199 public_submodules_->gain_control->AnalyzeCaptureAudio(capture_buffer));
1200 public_submodules_->noise_suppression->AnalyzeCaptureAudio(capture_buffer);
peahb58a1582016-03-15 09:34:24 -07001201
1202 // Ensure that the stream delay was set before the call to the
1203 // AEC ProcessCaptureAudio function.
1204 if (public_submodules_->echo_cancellation->is_enabled() &&
1205 !was_stream_delay_set()) {
1206 return AudioProcessing::kStreamParameterNotSetError;
1207 }
1208
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001209 if (private_submodules_->echo_controller) {
1210 private_submodules_->echo_controller->ProcessCapture(
peah67995532017-04-10 14:12:41 -07001211 capture_buffer, capture_.echo_path_gain_change);
peah61202ac2017-02-06 03:39:42 -08001212 } else {
1213 RETURN_ON_ERR(public_submodules_->echo_cancellation->ProcessCaptureAudio(
1214 capture_buffer, stream_delay_ms()));
peahe0eae3c2016-12-14 01:16:23 -08001215 }
1216
peahdf3efa82015-11-28 12:35:15 -08001217 if (public_submodules_->echo_control_mobile->is_enabled() &&
1218 public_submodules_->noise_suppression->is_enabled()) {
peahde65ddc2016-09-16 15:02:15 -07001219 capture_buffer->CopyLowPassToReference();
niklase@google.com470e71d2011-07-07 08:21:25 +00001220 }
peahde65ddc2016-09-16 15:02:15 -07001221 public_submodules_->noise_suppression->ProcessCaptureAudio(capture_buffer);
peah1bcfce52016-08-26 07:16:04 -07001222#if WEBRTC_INTELLIGIBILITY_ENHANCER
Alejandro Luebsc9b0c262016-05-16 15:32:38 -07001223 if (capture_nonlocked_.intelligibility_enabled) {
aluebsc466bad2016-02-10 12:03:00 -08001224 RTC_DCHECK(public_submodules_->noise_suppression->is_enabled());
Alejandro Luebsc9b0c262016-05-16 15:32:38 -07001225 int gain_db = public_submodules_->gain_control->is_enabled() ?
1226 public_submodules_->gain_control->compression_gain_db() :
1227 0;
Alejandro Luebs50411102016-06-30 15:35:41 -07001228 float gain = std::pow(10.f, gain_db / 20.f);
1229 gain *= capture_nonlocked_.level_controller_enabled ?
1230 private_submodules_->level_controller->GetLastGain() :
1231 1.f;
aluebsc466bad2016-02-10 12:03:00 -08001232 public_submodules_->intelligibility_enhancer->SetCaptureNoiseEstimate(
Alejandro Luebs50411102016-06-30 15:35:41 -07001233 public_submodules_->noise_suppression->NoiseEstimate(), gain);
aluebsc466bad2016-02-10 12:03:00 -08001234 }
peah1bcfce52016-08-26 07:16:04 -07001235#endif
peah253534d2016-03-15 04:32:28 -07001236
1237 // Ensure that the stream delay was set before the call to the
1238 // AECM ProcessCaptureAudio function.
1239 if (public_submodules_->echo_control_mobile->is_enabled() &&
1240 !was_stream_delay_set()) {
1241 return AudioProcessing::kStreamParameterNotSetError;
1242 }
1243
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001244 if (!(private_submodules_->echo_controller ||
Per Ã…hgren46537a32017-06-07 10:08:10 +02001245 public_submodules_->echo_cancellation->is_enabled())) {
1246 RETURN_ON_ERR(public_submodules_->echo_control_mobile->ProcessCaptureAudio(
1247 capture_buffer, stream_delay_ms()));
1248 }
ivoc9f4a4a02016-10-28 05:39:16 -07001249
Alejandro Luebsf4022ff2016-07-01 17:19:09 -07001250 if (capture_nonlocked_.beamformer_enabled) {
peahde65ddc2016-09-16 15:02:15 -07001251 private_submodules_->beamformer->PostFilter(capture_buffer->split_data_f());
Alejandro Luebsf4022ff2016-07-01 17:19:09 -07001252 }
1253
peahde65ddc2016-09-16 15:02:15 -07001254 public_submodules_->voice_detection->ProcessCaptureAudio(capture_buffer);
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001255
peahbe615622016-02-13 16:40:47 -08001256 if (constants_.use_experimental_agc &&
peahdf3efa82015-11-28 12:35:15 -08001257 public_submodules_->gain_control->is_enabled() &&
aluebsb2328d12016-01-11 20:32:29 -08001258 (!capture_nonlocked_.beamformer_enabled ||
peahdf3efa82015-11-28 12:35:15 -08001259 private_submodules_->beamformer->is_target_present())) {
1260 private_submodules_->agc_manager->Process(
peahde65ddc2016-09-16 15:02:15 -07001261 capture_buffer->split_bands_const(0)[kBand0To8kHz],
1262 capture_buffer->num_frames_per_band(), capture_nonlocked_.split_rate);
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001263 }
peahb8fbb542016-03-15 02:28:08 -07001264 RETURN_ON_ERR(public_submodules_->gain_control->ProcessCaptureAudio(
peahde65ddc2016-09-16 15:02:15 -07001265 capture_buffer, echo_cancellation()->stream_has_echo()));
niklase@google.com470e71d2011-07-07 08:21:25 +00001266
peah2ace3f92016-09-10 04:42:27 -07001267 if (submodule_states_.CaptureMultiBandProcessingActive() &&
1268 SampleRateSupportsMultiBand(
peahde65ddc2016-09-16 15:02:15 -07001269 capture_nonlocked_.capture_processing_format.sample_rate_hz())) {
1270 capture_buffer->MergeFrequencyBands();
niklase@google.com470e71d2011-07-07 08:21:25 +00001271 }
1272
peah9e6a2902017-05-15 07:19:21 -07001273 if (config_.residual_echo_detector.enabled) {
1274 private_submodules_->residual_echo_detector->AnalyzeCaptureAudio(
1275 rtc::ArrayView<const float>(capture_buffer->channels_f()[0],
1276 capture_buffer->num_frames()));
1277 }
1278
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001279 // TODO(aluebs): Investigate if the transient suppression placement should be
1280 // before or after the AGC.
peahdf3efa82015-11-28 12:35:15 -08001281 if (capture_.transient_suppressor_enabled) {
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001282 float voice_probability =
peahdf3efa82015-11-28 12:35:15 -08001283 private_submodules_->agc_manager.get()
1284 ? private_submodules_->agc_manager->voice_probability()
1285 : 1.f;
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001286
peahdf3efa82015-11-28 12:35:15 -08001287 public_submodules_->transient_suppressor->Suppress(
peahde65ddc2016-09-16 15:02:15 -07001288 capture_buffer->channels_f()[0], capture_buffer->num_frames(),
1289 capture_buffer->num_channels(),
1290 capture_buffer->split_bands_const_f(0)[kBand0To8kHz],
1291 capture_buffer->num_frames_per_band(), capture_buffer->keyboard_data(),
1292 capture_buffer->num_keyboard_frames(), voice_probability,
peahdf3efa82015-11-28 12:35:15 -08001293 capture_.key_pressed);
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001294 }
1295
Alessio Bazzica270f7b52017-10-13 11:05:17 +02001296 if (config_.gain_controller2.enabled) {
alessiob3ec96df2017-05-22 06:57:06 -07001297 private_submodules_->gain_controller2->Process(capture_buffer);
1298 }
1299
peahca4cac72016-06-29 15:26:12 -07001300 if (capture_nonlocked_.level_controller_enabled) {
peahde65ddc2016-09-16 15:02:15 -07001301 private_submodules_->level_controller->Process(capture_buffer);
peahca4cac72016-06-29 15:26:12 -07001302 }
1303
Sam Zackrisson0beac582017-09-25 12:04:02 +02001304 if (private_submodules_->capture_post_processor) {
1305 private_submodules_->capture_post_processor->Process(capture_buffer);
1306 }
1307
andrew@webrtc.org755b04a2011-11-15 16:57:56 +00001308 // The level estimator operates on the recombined data.
peahde65ddc2016-09-16 15:02:15 -07001309 public_submodules_->level_estimator->ProcessStream(capture_buffer);
ajm@google.com808e0e02011-08-03 21:08:51 +00001310
peah1b08dc32016-12-20 13:45:58 -08001311 capture_output_rms_.Analyze(rtc::ArrayView<const int16_t>(
1312 capture_buffer->channels_const()[0],
1313 capture_nonlocked_.capture_processing_format.num_frames()));
1314 if (log_rms) {
1315 RmsLevel::Levels levels = capture_output_rms_.AverageAndPeak();
1316 RTC_HISTOGRAM_COUNTS_LINEAR("WebRTC.Audio.ApmCaptureOutputLevelAverageRms",
1317 levels.average, 1, RmsLevel::kMinLevelDb, 64);
1318 RTC_HISTOGRAM_COUNTS_LINEAR("WebRTC.Audio.ApmCaptureOutputLevelPeakRms",
1319 levels.peak, 1, RmsLevel::kMinLevelDb, 64);
1320 }
1321
peahdf3efa82015-11-28 12:35:15 -08001322 capture_.was_stream_delay_set = false;
niklase@google.com470e71d2011-07-07 08:21:25 +00001323 return kNoError;
1324}
1325
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001326int AudioProcessingImpl::AnalyzeReverseStream(const float* const* data,
Peter Kastingdce40cf2015-08-24 14:52:23 -07001327 size_t samples_per_channel,
peahde65ddc2016-09-16 15:02:15 -07001328 int sample_rate_hz,
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001329 ChannelLayout layout) {
peah369f8282015-12-17 06:42:29 -08001330 TRACE_EVENT0("webrtc", "AudioProcessing::AnalyzeReverseStream_ChannelLayout");
peahdf3efa82015-11-28 12:35:15 -08001331 rtc::CritScope cs(&crit_render_);
Michael Graczyk86c6d332015-07-23 11:41:39 -07001332 const StreamConfig reverse_config = {
peahde65ddc2016-09-16 15:02:15 -07001333 sample_rate_hz, ChannelsFromLayout(layout), LayoutHasKeyboard(layout),
Michael Graczyk86c6d332015-07-23 11:41:39 -07001334 };
1335 if (samples_per_channel != reverse_config.num_frames()) {
1336 return kBadDataLengthError;
1337 }
peahdf3efa82015-11-28 12:35:15 -08001338 return AnalyzeReverseStreamLocked(data, reverse_config, reverse_config);
ekmeyerson60d9b332015-08-14 10:35:55 -07001339}
1340
peahde65ddc2016-09-16 15:02:15 -07001341int AudioProcessingImpl::ProcessReverseStream(const float* const* src,
1342 const StreamConfig& input_config,
1343 const StreamConfig& output_config,
1344 float* const* dest) {
peah369f8282015-12-17 06:42:29 -08001345 TRACE_EVENT0("webrtc", "AudioProcessing::ProcessReverseStream_StreamConfig");
peahdf3efa82015-11-28 12:35:15 -08001346 rtc::CritScope cs(&crit_render_);
peahde65ddc2016-09-16 15:02:15 -07001347 RETURN_ON_ERR(AnalyzeReverseStreamLocked(src, input_config, output_config));
peah2ace3f92016-09-10 04:42:27 -07001348 if (submodule_states_.RenderMultiBandProcessingActive()) {
peahdf3efa82015-11-28 12:35:15 -08001349 render_.render_audio->CopyTo(formats_.api_format.reverse_output_stream(),
1350 dest);
peah2ace3f92016-09-10 04:42:27 -07001351 } else if (formats_.api_format.reverse_input_stream() !=
1352 formats_.api_format.reverse_output_stream()) {
peahde65ddc2016-09-16 15:02:15 -07001353 render_.render_converter->Convert(src, input_config.num_samples(), dest,
1354 output_config.num_samples());
ekmeyerson60d9b332015-08-14 10:35:55 -07001355 } else {
peahde65ddc2016-09-16 15:02:15 -07001356 CopyAudioIfNeeded(src, input_config.num_frames(),
1357 input_config.num_channels(), dest);
ekmeyerson60d9b332015-08-14 10:35:55 -07001358 }
1359
1360 return kNoError;
Michael Graczyk86c6d332015-07-23 11:41:39 -07001361}
1362
peahdf3efa82015-11-28 12:35:15 -08001363int AudioProcessingImpl::AnalyzeReverseStreamLocked(
ekmeyerson60d9b332015-08-14 10:35:55 -07001364 const float* const* src,
peahde65ddc2016-09-16 15:02:15 -07001365 const StreamConfig& input_config,
1366 const StreamConfig& output_config) {
peahdf3efa82015-11-28 12:35:15 -08001367 if (src == nullptr) {
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001368 return kNullPointerError;
1369 }
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001370
peahde65ddc2016-09-16 15:02:15 -07001371 if (input_config.num_channels() == 0) {
Michael Graczyk86c6d332015-07-23 11:41:39 -07001372 return kBadNumberChannelsError;
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001373 }
1374
peahdf3efa82015-11-28 12:35:15 -08001375 ProcessingConfig processing_config = formats_.api_format;
peahde65ddc2016-09-16 15:02:15 -07001376 processing_config.reverse_input_stream() = input_config;
1377 processing_config.reverse_output_stream() = output_config;
Michael Graczyk86c6d332015-07-23 11:41:39 -07001378
peahdf3efa82015-11-28 12:35:15 -08001379 RETURN_ON_ERR(MaybeInitializeRender(processing_config));
peahde65ddc2016-09-16 15:02:15 -07001380 assert(input_config.num_frames() ==
1381 formats_.api_format.reverse_input_stream().num_frames());
Michael Graczyk86c6d332015-07-23 11:41:39 -07001382
aleloi868f32f2017-05-23 07:20:05 -07001383 if (aec_dump_) {
1384 const size_t channel_size =
1385 formats_.api_format.reverse_input_stream().num_frames();
1386 const size_t num_channels =
1387 formats_.api_format.reverse_input_stream().num_channels();
1388 aec_dump_->WriteRenderStreamMessage(
1389 FloatAudioFrame(src, num_channels, channel_size));
1390 }
peahdf3efa82015-11-28 12:35:15 -08001391 render_.render_audio->CopyFrom(src,
1392 formats_.api_format.reverse_input_stream());
peahde65ddc2016-09-16 15:02:15 -07001393 return ProcessRenderStreamLocked();
ekmeyerson60d9b332015-08-14 10:35:55 -07001394}
1395
1396int AudioProcessingImpl::ProcessReverseStream(AudioFrame* frame) {
peah369f8282015-12-17 06:42:29 -08001397 TRACE_EVENT0("webrtc", "AudioProcessing::ProcessReverseStream_AudioFrame");
peahdf3efa82015-11-28 12:35:15 -08001398 rtc::CritScope cs(&crit_render_);
peahdf3efa82015-11-28 12:35:15 -08001399 if (frame == nullptr) {
niklase@google.com470e71d2011-07-07 08:21:25 +00001400 return kNullPointerError;
1401 }
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +00001402 // Must be a native rate.
1403 if (frame->sample_rate_hz_ != kSampleRate8kHz &&
1404 frame->sample_rate_hz_ != kSampleRate16kHz &&
aluebs@webrtc.org087da132014-11-17 23:01:23 +00001405 frame->sample_rate_hz_ != kSampleRate32kHz &&
1406 frame->sample_rate_hz_ != kSampleRate48kHz) {
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +00001407 return kBadSampleRateError;
1408 }
andrew@webrtc.orga8b97372014-03-10 22:26:12 +00001409
Michael Graczyk86c6d332015-07-23 11:41:39 -07001410 if (frame->num_channels_ <= 0) {
1411 return kBadNumberChannelsError;
1412 }
1413
peahdf3efa82015-11-28 12:35:15 -08001414 ProcessingConfig processing_config = formats_.api_format;
ekmeyerson60d9b332015-08-14 10:35:55 -07001415 processing_config.reverse_input_stream().set_sample_rate_hz(
1416 frame->sample_rate_hz_);
1417 processing_config.reverse_input_stream().set_num_channels(
1418 frame->num_channels_);
1419 processing_config.reverse_output_stream().set_sample_rate_hz(
1420 frame->sample_rate_hz_);
1421 processing_config.reverse_output_stream().set_num_channels(
1422 frame->num_channels_);
Michael Graczyk86c6d332015-07-23 11:41:39 -07001423
peahdf3efa82015-11-28 12:35:15 -08001424 RETURN_ON_ERR(MaybeInitializeRender(processing_config));
Michael Graczyk86c6d332015-07-23 11:41:39 -07001425 if (frame->samples_per_channel_ !=
peahdf3efa82015-11-28 12:35:15 -08001426 formats_.api_format.reverse_input_stream().num_frames()) {
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001427 return kBadDataLengthError;
1428 }
niklase@google.com470e71d2011-07-07 08:21:25 +00001429
aleloi868f32f2017-05-23 07:20:05 -07001430 if (aec_dump_) {
1431 aec_dump_->WriteRenderStreamMessage(*frame);
1432 }
1433
peahdf3efa82015-11-28 12:35:15 -08001434 render_.render_audio->DeinterleaveFrom(frame);
peahde65ddc2016-09-16 15:02:15 -07001435 RETURN_ON_ERR(ProcessRenderStreamLocked());
peah2ace3f92016-09-10 04:42:27 -07001436 render_.render_audio->InterleaveTo(
1437 frame, submodule_states_.RenderMultiBandProcessingActive());
aluebsb0319552016-03-17 20:39:53 -07001438 return kNoError;
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001439}
niklase@google.com470e71d2011-07-07 08:21:25 +00001440
peahde65ddc2016-09-16 15:02:15 -07001441int AudioProcessingImpl::ProcessRenderStreamLocked() {
1442 AudioBuffer* render_buffer = render_.render_audio.get(); // For brevity.
peah9e6a2902017-05-15 07:19:21 -07001443
1444 QueueNonbandedRenderAudio(render_buffer);
1445
peah2ace3f92016-09-10 04:42:27 -07001446 if (submodule_states_.RenderMultiBandSubModulesActive() &&
peahde65ddc2016-09-16 15:02:15 -07001447 SampleRateSupportsMultiBand(
1448 formats_.render_processing_format.sample_rate_hz())) {
1449 render_buffer->SplitIntoFrequencyBands();
niklase@google.com470e71d2011-07-07 08:21:25 +00001450 }
1451
peah1bcfce52016-08-26 07:16:04 -07001452#if WEBRTC_INTELLIGIBILITY_ENHANCER
Alejandro Luebsc9b0c262016-05-16 15:32:38 -07001453 if (capture_nonlocked_.intelligibility_enabled) {
peahdf3efa82015-11-28 12:35:15 -08001454 public_submodules_->intelligibility_enhancer->ProcessRenderAudio(
Alejandro Luebsef009252016-09-20 14:51:56 -07001455 render_buffer);
ekmeyerson60d9b332015-08-14 10:35:55 -07001456 }
peah1bcfce52016-08-26 07:16:04 -07001457#endif
ekmeyerson60d9b332015-08-14 10:35:55 -07001458
peahce4d9152017-05-19 01:28:05 -07001459 if (submodule_states_.RenderMultiBandSubModulesActive()) {
1460 QueueBandedRenderAudio(render_buffer);
1461 }
1462
peahe0eae3c2016-12-14 01:16:23 -08001463 // TODO(peah): Perform the queueing ínside QueueRenderAudiuo().
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001464 if (private_submodules_->echo_controller) {
1465 private_submodules_->echo_controller->AnalyzeRender(render_buffer);
peahe0eae3c2016-12-14 01:16:23 -08001466 }
niklase@google.com470e71d2011-07-07 08:21:25 +00001467
peah2ace3f92016-09-10 04:42:27 -07001468 if (submodule_states_.RenderMultiBandProcessingActive() &&
peahde65ddc2016-09-16 15:02:15 -07001469 SampleRateSupportsMultiBand(
1470 formats_.render_processing_format.sample_rate_hz())) {
1471 render_buffer->MergeFrequencyBands();
ekmeyerson60d9b332015-08-14 10:35:55 -07001472 }
1473
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001474 return kNoError;
niklase@google.com470e71d2011-07-07 08:21:25 +00001475}
1476
1477int AudioProcessingImpl::set_stream_delay_ms(int delay) {
peahdf3efa82015-11-28 12:35:15 -08001478 rtc::CritScope cs(&crit_capture_);
andrew@webrtc.org5f23d642012-05-29 21:14:06 +00001479 Error retval = kNoError;
peahdf3efa82015-11-28 12:35:15 -08001480 capture_.was_stream_delay_set = true;
1481 delay += capture_.delay_offset_ms;
andrew@webrtc.org6f9f8172012-03-06 19:03:39 +00001482
niklase@google.com470e71d2011-07-07 08:21:25 +00001483 if (delay < 0) {
andrew@webrtc.org5f23d642012-05-29 21:14:06 +00001484 delay = 0;
1485 retval = kBadStreamParameterWarning;
niklase@google.com470e71d2011-07-07 08:21:25 +00001486 }
1487
1488 // TODO(ajm): the max is rather arbitrarily chosen; investigate.
1489 if (delay > 500) {
andrew@webrtc.org5f23d642012-05-29 21:14:06 +00001490 delay = 500;
1491 retval = kBadStreamParameterWarning;
niklase@google.com470e71d2011-07-07 08:21:25 +00001492 }
1493
peahdf3efa82015-11-28 12:35:15 -08001494 capture_nonlocked_.stream_delay_ms = delay;
andrew@webrtc.org5f23d642012-05-29 21:14:06 +00001495 return retval;
niklase@google.com470e71d2011-07-07 08:21:25 +00001496}
1497
1498int AudioProcessingImpl::stream_delay_ms() const {
peahdf3efa82015-11-28 12:35:15 -08001499 // Used as callback from submodules, hence locking is not allowed.
1500 return capture_nonlocked_.stream_delay_ms;
niklase@google.com470e71d2011-07-07 08:21:25 +00001501}
1502
1503bool AudioProcessingImpl::was_stream_delay_set() const {
peahdf3efa82015-11-28 12:35:15 -08001504 // Used as callback from submodules, hence locking is not allowed.
1505 return capture_.was_stream_delay_set;
niklase@google.com470e71d2011-07-07 08:21:25 +00001506}
1507
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001508void AudioProcessingImpl::set_stream_key_pressed(bool key_pressed) {
peahdf3efa82015-11-28 12:35:15 -08001509 rtc::CritScope cs(&crit_capture_);
1510 capture_.key_pressed = key_pressed;
andrew@webrtc.org17e40642014-03-04 20:58:13 +00001511}
1512
andrew@webrtc.org6f9f8172012-03-06 19:03:39 +00001513void AudioProcessingImpl::set_delay_offset_ms(int offset) {
peahdf3efa82015-11-28 12:35:15 -08001514 rtc::CritScope cs(&crit_capture_);
1515 capture_.delay_offset_ms = offset;
andrew@webrtc.org6f9f8172012-03-06 19:03:39 +00001516}
1517
1518int AudioProcessingImpl::delay_offset_ms() const {
peahdf3efa82015-11-28 12:35:15 -08001519 rtc::CritScope cs(&crit_capture_);
1520 return capture_.delay_offset_ms;
andrew@webrtc.org6f9f8172012-03-06 19:03:39 +00001521}
1522
aleloi868f32f2017-05-23 07:20:05 -07001523void AudioProcessingImpl::AttachAecDump(std::unique_ptr<AecDump> aec_dump) {
1524 RTC_DCHECK(aec_dump);
1525 rtc::CritScope cs_render(&crit_render_);
1526 rtc::CritScope cs_capture(&crit_capture_);
1527
1528 // The previously attached AecDump will be destroyed with the
1529 // 'aec_dump' parameter, which is after locks are released.
1530 aec_dump_.swap(aec_dump);
1531 WriteAecDumpConfigMessage(true);
1532 aec_dump_->WriteInitMessage(ToStreamsConfig(formats_.api_format));
1533}
1534
1535void AudioProcessingImpl::DetachAecDump() {
1536 // The d-tor of a task-queue based AecDump blocks until all pending
1537 // tasks are done. This construction avoids blocking while holding
1538 // the render and capture locks.
1539 std::unique_ptr<AecDump> aec_dump = nullptr;
1540 {
1541 rtc::CritScope cs_render(&crit_render_);
1542 rtc::CritScope cs_capture(&crit_capture_);
1543 aec_dump = std::move(aec_dump_);
1544 }
1545}
1546
ivoc4e477a12017-01-15 08:29:46 -08001547AudioProcessing::AudioProcessingStatistics::AudioProcessingStatistics() {
1548 residual_echo_return_loss.Set(-100.0f, -100.0f, -100.0f, -100.0f);
1549 echo_return_loss.Set(-100.0f, -100.0f, -100.0f, -100.0f);
1550 echo_return_loss_enhancement.Set(-100.0f, -100.0f, -100.0f, -100.0f);
1551 a_nlp.Set(-100.0f, -100.0f, -100.0f, -100.0f);
1552}
1553
1554AudioProcessing::AudioProcessingStatistics::AudioProcessingStatistics(
1555 const AudioProcessingStatistics& other) = default;
1556
1557AudioProcessing::AudioProcessingStatistics::~AudioProcessingStatistics() =
1558 default;
1559
ivoc3e9a5372016-10-28 07:55:33 -07001560// TODO(ivoc): Remove this when GetStatistics() becomes pure virtual.
1561AudioProcessing::AudioProcessingStatistics AudioProcessing::GetStatistics()
1562 const {
1563 return AudioProcessingStatistics();
1564}
1565
1566AudioProcessing::AudioProcessingStatistics AudioProcessingImpl::GetStatistics()
1567 const {
1568 AudioProcessingStatistics stats;
1569 EchoCancellation::Metrics metrics;
ivocd0a151c2016-11-02 09:14:37 -07001570 int success = public_submodules_->echo_cancellation->GetMetrics(&metrics);
1571 if (success == Error::kNoError) {
1572 stats.a_nlp.Set(metrics.a_nlp);
1573 stats.divergent_filter_fraction = metrics.divergent_filter_fraction;
1574 stats.echo_return_loss.Set(metrics.echo_return_loss);
1575 stats.echo_return_loss_enhancement.Set(
1576 metrics.echo_return_loss_enhancement);
1577 stats.residual_echo_return_loss.Set(metrics.residual_echo_return_loss);
1578 }
ivoc9c192b22017-03-16 04:22:14 -07001579 {
1580 rtc::CritScope cs_capture(&crit_capture_);
1581 stats.residual_echo_likelihood =
1582 private_submodules_->residual_echo_detector->echo_likelihood();
1583 stats.residual_echo_likelihood_recent_max =
1584 private_submodules_->residual_echo_detector
1585 ->echo_likelihood_recent_max();
1586 }
ivoc3e9a5372016-10-28 07:55:33 -07001587 public_submodules_->echo_cancellation->GetDelayMetrics(
1588 &stats.delay_median, &stats.delay_standard_deviation,
1589 &stats.fraction_poor_delays);
1590 return stats;
1591}
1592
niklase@google.com470e71d2011-07-07 08:21:25 +00001593EchoCancellation* AudioProcessingImpl::echo_cancellation() const {
peahb624d8c2016-03-05 03:01:14 -08001594 return public_submodules_->echo_cancellation.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001595}
1596
1597EchoControlMobile* AudioProcessingImpl::echo_control_mobile() const {
peahbb9edbd2016-03-10 12:54:25 -08001598 return public_submodules_->echo_control_mobile.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001599}
1600
1601GainControl* AudioProcessingImpl::gain_control() const {
peahbe615622016-02-13 16:40:47 -08001602 if (constants_.use_experimental_agc) {
1603 return public_submodules_->gain_control_for_experimental_agc.get();
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001604 }
peahbfa97112016-03-10 21:09:04 -08001605 return public_submodules_->gain_control.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001606}
1607
1608HighPassFilter* AudioProcessingImpl::high_pass_filter() const {
peah8271d042016-11-22 07:24:52 -08001609 return high_pass_filter_impl_.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001610}
1611
1612LevelEstimator* AudioProcessingImpl::level_estimator() const {
solenberg949028f2015-12-15 11:39:38 -08001613 return public_submodules_->level_estimator.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001614}
1615
1616NoiseSuppression* AudioProcessingImpl::noise_suppression() const {
solenberg5e465c32015-12-08 13:22:33 -08001617 return public_submodules_->noise_suppression.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001618}
1619
1620VoiceDetection* AudioProcessingImpl::voice_detection() const {
solenberga29386c2015-12-16 03:31:12 -08001621 return public_submodules_->voice_detection.get();
niklase@google.com470e71d2011-07-07 08:21:25 +00001622}
1623
peah8271d042016-11-22 07:24:52 -08001624void AudioProcessingImpl::MutateConfig(
1625 rtc::FunctionView<void(AudioProcessing::Config*)> mutator) {
1626 rtc::CritScope cs_render(&crit_render_);
1627 rtc::CritScope cs_capture(&crit_capture_);
1628 mutator(&config_);
1629 ApplyConfig(config_);
1630}
1631
1632AudioProcessing::Config AudioProcessingImpl::GetConfig() const {
1633 rtc::CritScope cs_render(&crit_render_);
1634 rtc::CritScope cs_capture(&crit_capture_);
1635 return config_;
1636}
1637
peah2ace3f92016-09-10 04:42:27 -07001638bool AudioProcessingImpl::UpdateActiveSubmoduleStates() {
1639 return submodule_states_.Update(
peah8271d042016-11-22 07:24:52 -08001640 config_.high_pass_filter.enabled,
peah2ace3f92016-09-10 04:42:27 -07001641 public_submodules_->echo_cancellation->is_enabled(),
1642 public_submodules_->echo_control_mobile->is_enabled(),
ivoc9f4a4a02016-10-28 05:39:16 -07001643 config_.residual_echo_detector.enabled,
peah2ace3f92016-09-10 04:42:27 -07001644 public_submodules_->noise_suppression->is_enabled(),
1645 capture_nonlocked_.intelligibility_enabled,
1646 capture_nonlocked_.beamformer_enabled,
1647 public_submodules_->gain_control->is_enabled(),
Alessio Bazzica270f7b52017-10-13 11:05:17 +02001648 config_.gain_controller2.enabled,
peah2ace3f92016-09-10 04:42:27 -07001649 capture_nonlocked_.level_controller_enabled,
Gustaf Ullbergce045ac2017-10-16 13:49:04 +02001650 capture_nonlocked_.echo_controller_enabled,
peah2ace3f92016-09-10 04:42:27 -07001651 public_submodules_->voice_detection->is_enabled(),
1652 public_submodules_->level_estimator->is_enabled(),
1653 capture_.transient_suppressor_enabled);
ekmeyerson60d9b332015-08-14 10:35:55 -07001654}
1655
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001656
Bjorn Volckeradc46c42015-04-15 11:42:40 +02001657void AudioProcessingImpl::InitializeTransient() {
peahdf3efa82015-11-28 12:35:15 -08001658 if (capture_.transient_suppressor_enabled) {
1659 if (!public_submodules_->transient_suppressor.get()) {
1660 public_submodules_->transient_suppressor.reset(new TransientSuppressor());
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001661 }
peahdf3efa82015-11-28 12:35:15 -08001662 public_submodules_->transient_suppressor->Initialize(
peahde65ddc2016-09-16 15:02:15 -07001663 capture_nonlocked_.capture_processing_format.sample_rate_hz(),
1664 capture_nonlocked_.split_rate, num_proc_channels());
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001665 }
pbos@webrtc.org788acd12014-12-15 09:41:24 +00001666}
1667
aluebs@webrtc.orgae643ce2014-12-19 19:57:34 +00001668void AudioProcessingImpl::InitializeBeamformer() {
aluebsb2328d12016-01-11 20:32:29 -08001669 if (capture_nonlocked_.beamformer_enabled) {
peahdf3efa82015-11-28 12:35:15 -08001670 if (!private_submodules_->beamformer) {
1671 private_submodules_->beamformer.reset(new NonlinearBeamformer(
Alejandro Luebsf4022ff2016-07-01 17:19:09 -07001672 capture_.array_geometry, 1u, capture_.target_direction));
aluebs@webrtc.orgd82f55d2015-01-15 18:07:21 +00001673 }
peahdf3efa82015-11-28 12:35:15 -08001674 private_submodules_->beamformer->Initialize(kChunkSizeMs,
1675 capture_nonlocked_.split_rate);
aluebs@webrtc.orgae643ce2014-12-19 19:57:34 +00001676 }
1677}
1678
ekmeyerson60d9b332015-08-14 10:35:55 -07001679void AudioProcessingImpl::InitializeIntelligibility() {
peah1bcfce52016-08-26 07:16:04 -07001680#if WEBRTC_INTELLIGIBILITY_ENHANCER
Alejandro Luebsc9b0c262016-05-16 15:32:38 -07001681 if (capture_nonlocked_.intelligibility_enabled) {
peahdf3efa82015-11-28 12:35:15 -08001682 public_submodules_->intelligibility_enhancer.reset(
Alejandro Luebs18fcbcf2016-02-22 15:57:38 -08001683 new IntelligibilityEnhancer(capture_nonlocked_.split_rate,
Alex Luebs57ae8292016-03-09 16:24:34 +01001684 render_.render_audio->num_channels(),
Alejandro Luebsef009252016-09-20 14:51:56 -07001685 render_.render_audio->num_bands(),
Alex Luebs57ae8292016-03-09 16:24:34 +01001686 NoiseSuppressionImpl::num_noise_bins()));
ekmeyerson60d9b332015-08-14 10:35:55 -07001687 }
peah1bcfce52016-08-26 07:16:04 -07001688#endif
ekmeyerson60d9b332015-08-14 10:35:55 -07001689}
1690
peah8271d042016-11-22 07:24:52 -08001691void AudioProcessingImpl::InitializeLowCutFilter() {
1692 if (config_.high_pass_filter.enabled) {
1693 private_submodules_->low_cut_filter.reset(
1694 new LowCutFilter(num_proc_channels(), proc_sample_rate_hz()));
1695 } else {
1696 private_submodules_->low_cut_filter.reset();
1697 }
1698}
alessiob3ec96df2017-05-22 06:57:06 -07001699
Gustaf Ullberg8eb9c7d2017-10-14 08:28:46 +02001700void AudioProcessingImpl::InitializeEchoController() {
Gustaf Ullberg002ef282017-10-12 15:13:17 +02001701 if (echo_control_factory_) {
1702 private_submodules_->echo_controller =
1703 echo_control_factory_->Create(proc_sample_rate_hz());
peahe0eae3c2016-12-14 01:16:23 -08001704 } else {
Gustaf Ullberg59ff0e22017-10-09 10:20:34 +02001705 private_submodules_->echo_controller.reset();
peahe0eae3c2016-12-14 01:16:23 -08001706 }
1707}
peah8271d042016-11-22 07:24:52 -08001708
alessiob3ec96df2017-05-22 06:57:06 -07001709void AudioProcessingImpl::InitializeGainController2() {
Alessio Bazzica270f7b52017-10-13 11:05:17 +02001710 if (config_.gain_controller2.enabled) {
1711 private_submodules_->gain_controller2->Initialize(proc_sample_rate_hz());
alessiob3ec96df2017-05-22 06:57:06 -07001712 }
1713}
1714
peahca4cac72016-06-29 15:26:12 -07001715void AudioProcessingImpl::InitializeLevelController() {
1716 private_submodules_->level_controller->Initialize(proc_sample_rate_hz());
1717}
1718
ivoc9f4a4a02016-10-28 05:39:16 -07001719void AudioProcessingImpl::InitializeResidualEchoDetector() {
1720 private_submodules_->residual_echo_detector->Initialize();
1721}
1722
Sam Zackrisson0beac582017-09-25 12:04:02 +02001723void AudioProcessingImpl::InitializePostProcessor() {
1724 if (private_submodules_->capture_post_processor) {
1725 private_submodules_->capture_post_processor->Initialize(
1726 proc_sample_rate_hz(), num_proc_channels());
1727 }
1728}
1729
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001730void AudioProcessingImpl::MaybeUpdateHistograms() {
Bjorn Volckerd92f2672015-07-05 10:46:01 +02001731 static const int kMinDiffDelayMs = 60;
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001732
1733 if (echo_cancellation()->is_enabled()) {
Alessio Bazzica270f7b52017-10-13 11:05:17 +02001734 // Activate delay_jumps_ counters if we know echo_cancellation is running.
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001735 // If a stream has echo we know that the echo_cancellation is in process.
peahdf3efa82015-11-28 12:35:15 -08001736 if (capture_.stream_delay_jumps == -1 &&
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001737 echo_cancellation()->stream_has_echo()) {
peahdf3efa82015-11-28 12:35:15 -08001738 capture_.stream_delay_jumps = 0;
1739 }
1740 if (capture_.aec_system_delay_jumps == -1 &&
1741 echo_cancellation()->stream_has_echo()) {
1742 capture_.aec_system_delay_jumps = 0;
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001743 }
1744
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001745 // Detect a jump in platform reported system delay and log the difference.
peahdf3efa82015-11-28 12:35:15 -08001746 const int diff_stream_delay_ms =
1747 capture_nonlocked_.stream_delay_ms - capture_.last_stream_delay_ms;
1748 if (diff_stream_delay_ms > kMinDiffDelayMs &&
1749 capture_.last_stream_delay_ms != 0) {
asaperssona2c58e22016-03-07 01:52:59 -08001750 RTC_HISTOGRAM_COUNTS("WebRTC.Audio.PlatformReportedStreamDelayJump",
1751 diff_stream_delay_ms, kMinDiffDelayMs, 1000, 100);
peahdf3efa82015-11-28 12:35:15 -08001752 if (capture_.stream_delay_jumps == -1) {
1753 capture_.stream_delay_jumps = 0; // Activate counter if needed.
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001754 }
peahdf3efa82015-11-28 12:35:15 -08001755 capture_.stream_delay_jumps++;
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001756 }
peahdf3efa82015-11-28 12:35:15 -08001757 capture_.last_stream_delay_ms = capture_nonlocked_.stream_delay_ms;
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001758
1759 // Detect a jump in AEC system delay and log the difference.
peah20028c42016-03-04 11:50:54 -08001760 const int samples_per_ms =
peahdf3efa82015-11-28 12:35:15 -08001761 rtc::CheckedDivExact(capture_nonlocked_.split_rate, 1000);
peah20028c42016-03-04 11:50:54 -08001762 RTC_DCHECK_LT(0, samples_per_ms);
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001763 const int aec_system_delay_ms =
peah20028c42016-03-04 11:50:54 -08001764 public_submodules_->echo_cancellation->GetSystemDelayInSamples() /
1765 samples_per_ms;
Michael Graczyk86c6d332015-07-23 11:41:39 -07001766 const int diff_aec_system_delay_ms =
peahdf3efa82015-11-28 12:35:15 -08001767 aec_system_delay_ms - capture_.last_aec_system_delay_ms;
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001768 if (diff_aec_system_delay_ms > kMinDiffDelayMs &&
peahdf3efa82015-11-28 12:35:15 -08001769 capture_.last_aec_system_delay_ms != 0) {
asaperssona2c58e22016-03-07 01:52:59 -08001770 RTC_HISTOGRAM_COUNTS("WebRTC.Audio.AecSystemDelayJump",
1771 diff_aec_system_delay_ms, kMinDiffDelayMs, 1000,
1772 100);
peahdf3efa82015-11-28 12:35:15 -08001773 if (capture_.aec_system_delay_jumps == -1) {
1774 capture_.aec_system_delay_jumps = 0; // Activate counter if needed.
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001775 }
peahdf3efa82015-11-28 12:35:15 -08001776 capture_.aec_system_delay_jumps++;
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001777 }
peahdf3efa82015-11-28 12:35:15 -08001778 capture_.last_aec_system_delay_ms = aec_system_delay_ms;
Bjorn Volcker1ca324f2015-06-29 14:57:29 +02001779 }
1780}
1781
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001782void AudioProcessingImpl::UpdateHistogramsOnCallEnd() {
peahdf3efa82015-11-28 12:35:15 -08001783 // Run in a single-threaded manner.
1784 rtc::CritScope cs_render(&crit_render_);
1785 rtc::CritScope cs_capture(&crit_capture_);
1786
1787 if (capture_.stream_delay_jumps > -1) {
asaperssona2c58e22016-03-07 01:52:59 -08001788 RTC_HISTOGRAM_ENUMERATION(
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001789 "WebRTC.Audio.NumOfPlatformReportedStreamDelayJumps",
peahdf3efa82015-11-28 12:35:15 -08001790 capture_.stream_delay_jumps, 51);
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001791 }
peahdf3efa82015-11-28 12:35:15 -08001792 capture_.stream_delay_jumps = -1;
1793 capture_.last_stream_delay_ms = 0;
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001794
peahdf3efa82015-11-28 12:35:15 -08001795 if (capture_.aec_system_delay_jumps > -1) {
asaperssona2c58e22016-03-07 01:52:59 -08001796 RTC_HISTOGRAM_ENUMERATION("WebRTC.Audio.NumOfAecSystemDelayJumps",
1797 capture_.aec_system_delay_jumps, 51);
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001798 }
peahdf3efa82015-11-28 12:35:15 -08001799 capture_.aec_system_delay_jumps = -1;
1800 capture_.last_aec_system_delay_ms = 0;
Bjorn Volcker4e7aa432015-07-07 11:50:05 +02001801}
1802
aleloi868f32f2017-05-23 07:20:05 -07001803void AudioProcessingImpl::WriteAecDumpConfigMessage(bool forced) {
1804 if (!aec_dump_) {
1805 return;
1806 }
1807 std::string experiments_description =
1808 public_submodules_->echo_cancellation->GetExperimentsDescription();
1809 // TODO(peah): Add semicolon-separated concatenations of experiment
1810 // descriptions for other submodules.
1811 if (capture_nonlocked_.level_controller_enabled) {
1812 experiments_description += "LevelController;";
1813 }
1814 if (constants_.agc_clipped_level_min != kClippedLevelMin) {
1815 experiments_description += "AgcClippingLevelExperiment;";
1816 }
Gustaf Ullbergce045ac2017-10-16 13:49:04 +02001817 if (capture_nonlocked_.echo_controller_enabled) {
1818 experiments_description += "EchoController;";
aleloi868f32f2017-05-23 07:20:05 -07001819 }
Alessio Bazzica270f7b52017-10-13 11:05:17 +02001820 if (config_.gain_controller2.enabled) {
1821 experiments_description += "GainController2;";
1822 }
aleloi868f32f2017-05-23 07:20:05 -07001823
1824 InternalAPMConfig apm_config;
1825
1826 apm_config.aec_enabled = public_submodules_->echo_cancellation->is_enabled();
1827 apm_config.aec_delay_agnostic_enabled =
1828 public_submodules_->echo_cancellation->is_delay_agnostic_enabled();
1829 apm_config.aec_drift_compensation_enabled =
1830 public_submodules_->echo_cancellation->is_drift_compensation_enabled();
1831 apm_config.aec_extended_filter_enabled =
1832 public_submodules_->echo_cancellation->is_extended_filter_enabled();
1833 apm_config.aec_suppression_level = static_cast<int>(
1834 public_submodules_->echo_cancellation->suppression_level());
1835
1836 apm_config.aecm_enabled =
1837 public_submodules_->echo_control_mobile->is_enabled();
1838 apm_config.aecm_comfort_noise_enabled =
1839 public_submodules_->echo_control_mobile->is_comfort_noise_enabled();
1840 apm_config.aecm_routing_mode =
1841 static_cast<int>(public_submodules_->echo_control_mobile->routing_mode());
1842
1843 apm_config.agc_enabled = public_submodules_->gain_control->is_enabled();
1844 apm_config.agc_mode =
1845 static_cast<int>(public_submodules_->gain_control->mode());
1846 apm_config.agc_limiter_enabled =
1847 public_submodules_->gain_control->is_limiter_enabled();
1848 apm_config.noise_robust_agc_enabled = constants_.use_experimental_agc;
1849
1850 apm_config.hpf_enabled = config_.high_pass_filter.enabled;
1851
1852 apm_config.ns_enabled = public_submodules_->noise_suppression->is_enabled();
1853 apm_config.ns_level =
1854 static_cast<int>(public_submodules_->noise_suppression->level());
1855
1856 apm_config.transient_suppression_enabled =
1857 capture_.transient_suppressor_enabled;
1858 apm_config.intelligibility_enhancer_enabled =
1859 capture_nonlocked_.intelligibility_enabled;
1860 apm_config.experiments_description = experiments_description;
1861
1862 if (!forced && apm_config == apm_config_for_aec_dump_) {
1863 return;
1864 }
1865 aec_dump_->WriteConfig(apm_config);
1866 apm_config_for_aec_dump_ = apm_config;
1867}
1868
1869void AudioProcessingImpl::RecordUnprocessedCaptureStream(
1870 const float* const* src) {
1871 RTC_DCHECK(aec_dump_);
1872 WriteAecDumpConfigMessage(false);
1873
1874 const size_t channel_size = formats_.api_format.input_stream().num_frames();
1875 const size_t num_channels = formats_.api_format.input_stream().num_channels();
1876 aec_dump_->AddCaptureStreamInput(
1877 FloatAudioFrame(src, num_channels, channel_size));
1878 RecordAudioProcessingState();
1879}
1880
1881void AudioProcessingImpl::RecordUnprocessedCaptureStream(
1882 const AudioFrame& capture_frame) {
1883 RTC_DCHECK(aec_dump_);
1884 WriteAecDumpConfigMessage(false);
1885
1886 aec_dump_->AddCaptureStreamInput(capture_frame);
1887 RecordAudioProcessingState();
1888}
1889
1890void AudioProcessingImpl::RecordProcessedCaptureStream(
1891 const float* const* processed_capture_stream) {
1892 RTC_DCHECK(aec_dump_);
1893
1894 const size_t channel_size = formats_.api_format.output_stream().num_frames();
1895 const size_t num_channels =
1896 formats_.api_format.output_stream().num_channels();
1897 aec_dump_->AddCaptureStreamOutput(
1898 FloatAudioFrame(processed_capture_stream, num_channels, channel_size));
1899 aec_dump_->WriteCaptureStreamMessage();
1900}
1901
1902void AudioProcessingImpl::RecordProcessedCaptureStream(
1903 const AudioFrame& processed_capture_frame) {
1904 RTC_DCHECK(aec_dump_);
1905
1906 aec_dump_->AddCaptureStreamOutput(processed_capture_frame);
1907 aec_dump_->WriteCaptureStreamMessage();
1908}
1909
1910void AudioProcessingImpl::RecordAudioProcessingState() {
1911 RTC_DCHECK(aec_dump_);
1912 AecDump::AudioProcessingState audio_proc_state;
1913 audio_proc_state.delay = capture_nonlocked_.stream_delay_ms;
1914 audio_proc_state.drift =
1915 public_submodules_->echo_cancellation->stream_drift_samples();
1916 audio_proc_state.level = gain_control()->stream_analog_level();
1917 audio_proc_state.keypress = capture_.key_pressed;
1918 aec_dump_->AddAudioProcessingState(audio_proc_state);
1919}
1920
kwiberg83ffe452016-08-29 14:46:07 -07001921AudioProcessingImpl::ApmCaptureState::ApmCaptureState(
1922 bool transient_suppressor_enabled,
1923 const std::vector<Point>& array_geometry,
1924 SphericalPointf target_direction)
1925 : aec_system_delay_jumps(-1),
1926 delay_offset_ms(0),
1927 was_stream_delay_set(false),
1928 last_stream_delay_ms(0),
1929 last_aec_system_delay_ms(0),
1930 stream_delay_jumps(-1),
1931 output_will_be_muted(false),
1932 key_pressed(false),
1933 transient_suppressor_enabled(transient_suppressor_enabled),
1934 array_geometry(array_geometry),
1935 target_direction(target_direction),
peahde65ddc2016-09-16 15:02:15 -07001936 capture_processing_format(kSampleRate16kHz),
peah67995532017-04-10 14:12:41 -07001937 split_rate(kSampleRate16kHz),
peah67995532017-04-10 14:12:41 -07001938 echo_path_gain_change(false) {}
kwiberg83ffe452016-08-29 14:46:07 -07001939
1940AudioProcessingImpl::ApmCaptureState::~ApmCaptureState() = default;
1941
1942AudioProcessingImpl::ApmRenderState::ApmRenderState() = default;
1943
1944AudioProcessingImpl::ApmRenderState::~ApmRenderState() = default;
1945
niklase@google.com470e71d2011-07-07 08:21:25 +00001946} // namespace webrtc