blob: 5daea9088af2172c3532ff63b061d938e81a9c2a [file] [log] [blame]
niklase@google.com470e71d2011-07-07 08:21:25 +00001/*
andrew@webrtc.org6f9f8172012-03-06 19:03:39 +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#ifndef MODULES_AUDIO_PROCESSING_AUDIO_PROCESSING_IMPL_H_
12#define MODULES_AUDIO_PROCESSING_AUDIO_PROCESSING_IMPL_H_
niklase@google.com470e71d2011-07-07 08:21:25 +000013
Per Åhgren09e9a832020-05-11 11:03:47 +020014#include <stdio.h>
15
Niels Möller7a669002022-06-27 09:47:02 +020016#include <atomic>
niklase@google.com470e71d2011-07-07 08:21:25 +000017#include <list>
kwiberg88788ad2016-02-19 07:04:49 -080018#include <memory>
Per Åhgren09e9a832020-05-11 11:03:47 +020019#include <string>
Michael Graczyk86c6d332015-07-23 11:41:39 -070020#include <vector>
niklase@google.com470e71d2011-07-07 08:21:25 +000021
Ali Tofigh1fa87c42022-07-25 22:07:08 +020022#include "absl/strings/string_view.h"
Alessio Bazzicafcf1af32022-09-07 17:14:26 +020023#include "absl/types/optional.h"
Alessio Bazzicabab12852022-02-03 16:30:25 +010024#include "api/array_view.h"
Artem Titov741daaf2019-03-21 14:37:36 +010025#include "api/function_view.h"
saza1d600522019-10-18 13:29:43 +020026#include "modules/audio_processing/aec3/echo_canceller3.h"
27#include "modules/audio_processing/agc/agc_manager_direct.h"
Sam Zackrisson41478c72019-10-15 10:10:26 +020028#include "modules/audio_processing/agc/gain_control.h"
Alessio Bazzicad226c572022-10-24 22:05:19 +020029#include "modules/audio_processing/agc2/input_volume_stats_reporter.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020030#include "modules/audio_processing/audio_buffer.h"
Per Åhgrendb5d7282021-03-15 16:31:04 +000031#include "modules/audio_processing/capture_levels_adjuster/capture_levels_adjuster.h"
saza1d600522019-10-18 13:29:43 +020032#include "modules/audio_processing/echo_control_mobile_impl.h"
saza1d600522019-10-18 13:29:43 +020033#include "modules/audio_processing/gain_control_impl.h"
34#include "modules/audio_processing/gain_controller2.h"
35#include "modules/audio_processing/high_pass_filter.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020036#include "modules/audio_processing/include/aec_dump.h"
Per Åhgren71652f42020-03-17 13:23:58 +010037#include "modules/audio_processing/include/audio_frame_proxies.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020038#include "modules/audio_processing/include/audio_processing.h"
Sam Zackrissonb24c00f2018-11-26 16:18:25 +010039#include "modules/audio_processing/include/audio_processing_statistics.h"
Per Åhgren0cbb58e2019-10-29 22:59:44 +010040#include "modules/audio_processing/ns/noise_suppressor.h"
Sam Zackrissonb37e59d2020-04-27 08:39:33 +020041#include "modules/audio_processing/optionally_built_submodule_creators.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020042#include "modules/audio_processing/render_queue_item_verifier.h"
43#include "modules/audio_processing/rms_level.h"
saza1d600522019-10-18 13:29:43 +020044#include "modules/audio_processing/transient/transient_suppressor.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020045#include "rtc_base/gtest_prod_util.h"
46#include "rtc_base/ignore_wundef.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020047#include "rtc_base/swap_queue.h"
Markus Handell0df0fae2020-07-07 15:53:34 +020048#include "rtc_base/synchronization/mutex.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020049#include "rtc_base/thread_annotations.h"
peahdf3efa82015-11-28 12:35:15 -080050
niklase@google.com470e71d2011-07-07 08:21:25 +000051namespace webrtc {
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +000052
Per Åhgren13735822018-02-12 21:42:56 +010053class ApmDataDumper;
ekmeyerson60d9b332015-08-14 10:35:55 -070054class AudioConverter;
Michael Graczykdfa36052015-03-25 16:37:27 -070055
Henrik Lundin8a9aa552022-02-08 09:15:12 +000056constexpr int RuntimeSettingQueueSize() {
57 return 100;
58}
59
niklase@google.com470e71d2011-07-07 08:21:25 +000060class AudioProcessingImpl : public AudioProcessing {
61 public:
peahdf3efa82015-11-28 12:35:15 -080062 // Methods forcing APM to run in a single-threaded manner.
63 // Acquires both the render and capture locks.
Alessio Bazzicabe1b8982021-09-17 08:26:10 +020064 AudioProcessingImpl();
Alessio Bazzica20a9ac62021-10-14 10:55:08 +020065 AudioProcessingImpl(const AudioProcessing::Config& config,
66 std::unique_ptr<CustomProcessing> capture_post_processor,
Alex Loiko5825aa62017-12-18 16:02:40 +010067 std::unique_ptr<CustomProcessing> render_pre_processor,
Gustaf Ullberg002ef282017-10-12 15:13:17 +020068 std::unique_ptr<EchoControlFactory> echo_control_factory,
Valeriia Nemychnikovaf06eb572018-08-29 10:37:09 +020069 rtc::scoped_refptr<EchoDetector> echo_detector,
70 std::unique_ptr<CustomAudioAnalyzer> capture_analyzer);
kwiberg83ffe452016-08-29 14:46:07 -070071 ~AudioProcessingImpl() override;
kjellander@webrtc.org14665ff2015-03-04 12:58:35 +000072 int Initialize() override;
Michael Graczyk86c6d332015-07-23 11:41:39 -070073 int Initialize(const ProcessingConfig& processing_config) override;
peah88ac8532016-09-12 16:47:25 -070074 void ApplyConfig(const AudioProcessing::Config& config) override;
Ali Tofigh1fa87c42022-07-25 22:07:08 +020075 bool CreateAndAttachAecDump(absl::string_view file_name,
76 int64_t max_log_size_bytes,
77 rtc::TaskQueue* worker_queue) override;
Per Åhgren09e9a832020-05-11 11:03:47 +020078 bool CreateAndAttachAecDump(FILE* handle,
79 int64_t max_log_size_bytes,
80 rtc::TaskQueue* worker_queue) override;
81 // TODO(webrtc:5298) Deprecated variant.
aleloi868f32f2017-05-23 07:20:05 -070082 void AttachAecDump(std::unique_ptr<AecDump> aec_dump) override;
83 void DetachAecDump() override;
Alessio Bazzicac054e782018-04-16 12:10:09 +020084 void SetRuntimeSetting(RuntimeSetting setting) override;
Per Åhgren0a144a72021-02-09 08:47:51 +010085 bool PostRuntimeSetting(RuntimeSetting setting) override;
Alessio Bazzicac054e782018-04-16 12:10:09 +020086
peahdf3efa82015-11-28 12:35:15 -080087 // Capture-side exclusive methods possibly running APM in a
88 // multi-threaded manner. Acquire the capture lock.
Per Åhgren645f24c2020-03-16 12:06:02 +010089 int ProcessStream(const int16_t* const src,
90 const StreamConfig& input_config,
91 const StreamConfig& output_config,
Per Åhgrendc5522b2020-03-19 14:55:58 +010092 int16_t* const dest) override;
kjellander@webrtc.org14665ff2015-03-04 12:58:35 +000093 int ProcessStream(const float* const* src,
Michael Graczyk86c6d332015-07-23 11:41:39 -070094 const StreamConfig& input_config,
95 const StreamConfig& output_config,
96 float* const* dest) override;
Per Åhgrenc20a19c2019-11-13 11:12:29 +010097 bool GetLinearAecOutput(
98 rtc::ArrayView<std::array<float, 160>> linear_output) const override;
peahdf3efa82015-11-28 12:35:15 -080099 void set_output_will_be_muted(bool muted) override;
Per Åhgren0a144a72021-02-09 08:47:51 +0100100 void HandleCaptureOutputUsedSetting(bool capture_output_used)
101 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
peahdf3efa82015-11-28 12:35:15 -0800102 int set_stream_delay_ms(int delay) override;
peahdf3efa82015-11-28 12:35:15 -0800103 void set_stream_key_pressed(bool key_pressed) override;
Sam Zackrissonf0d1c032019-03-27 13:28:08 +0100104 void set_stream_analog_level(int level) override;
Markus Handell02ba1d22020-05-14 14:31:18 +0200105 int recommended_stream_analog_level() const
Markus Handell0df0fae2020-07-07 15:53:34 +0200106 RTC_LOCKS_EXCLUDED(mutex_capture_) override;
peahdf3efa82015-11-28 12:35:15 -0800107
108 // Render-side exclusive methods possibly running APM in a
109 // multi-threaded manner. Acquire the render lock.
Per Åhgren645f24c2020-03-16 12:06:02 +0100110 int ProcessReverseStream(const int16_t* const src,
111 const StreamConfig& input_config,
112 const StreamConfig& output_config,
113 int16_t* const dest) override;
kjellander@webrtc.org14665ff2015-03-04 12:58:35 +0000114 int AnalyzeReverseStream(const float* const* data,
Gustaf Ullberg8c51f2e2019-10-22 15:21:31 +0200115 const StreamConfig& reverse_config) override;
ekmeyerson60d9b332015-08-14 10:35:55 -0700116 int ProcessReverseStream(const float* const* src,
peahde65ddc2016-09-16 15:02:15 -0700117 const StreamConfig& input_config,
118 const StreamConfig& output_config,
ekmeyerson60d9b332015-08-14 10:35:55 -0700119 float* const* dest) override;
peahdf3efa82015-11-28 12:35:15 -0800120
121 // Methods only accessed from APM submodules or
122 // from AudioProcessing tests in a single-threaded manner.
123 // Hence there is no need for locks in these.
124 int proc_sample_rate_hz() const override;
125 int proc_split_sample_rate_hz() const override;
Peter Kasting69558702016-01-12 16:26:35 -0800126 size_t num_input_channels() const override;
127 size_t num_proc_channels() const override;
128 size_t num_output_channels() const override;
129 size_t num_reverse_channels() const override;
kjellander@webrtc.org14665ff2015-03-04 12:58:35 +0000130 int stream_delay_ms() const override;
peahdf3efa82015-11-28 12:35:15 -0800131
Per Åhgrencf4c8722019-12-30 14:32:14 +0100132 AudioProcessingStats GetStatistics(bool has_remote_tracks) override {
133 return GetStatistics();
134 }
135 AudioProcessingStats GetStatistics() override {
136 return stats_reporter_.GetStatistics();
137 }
ivoc3e9a5372016-10-28 07:55:33 -0700138
henrik.lundinadf06352017-04-05 05:48:24 -0700139 AudioProcessing::Config GetConfig() const override;
peah8271d042016-11-22 07:24:52 -0800140
andrew@webrtc.org60730cf2014-01-07 17:45:09 +0000141 protected:
andrew@webrtc.orga8b97372014-03-10 22:26:12 +0000142 // Overridden in a mock.
Per Åhgren0ade9832020-09-01 23:57:20 +0200143 virtual void InitializeLocked()
Markus Handell0df0fae2020-07-07 15:53:34 +0200144 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_);
Niels Möller5b747232021-07-26 17:16:25 +0200145 void AssertLockedForTest()
146 RTC_ASSERT_EXCLUSIVE_LOCK(mutex_render_, mutex_capture_) {
147 mutex_render_.AssertHeld();
148 mutex_capture_.AssertHeld();
149 }
andrew@webrtc.org60730cf2014-01-07 17:45:09 +0000150
niklase@google.com470e71d2011-07-07 08:21:25 +0000151 private:
peahc19f3122016-10-07 14:54:10 -0700152 // TODO(peah): These friend classes should be removed as soon as the new
153 // parameter setting scheme allows.
154 FRIEND_TEST_ALL_PREFIXES(ApmConfiguration, DefaultBehavior);
155 FRIEND_TEST_ALL_PREFIXES(ApmConfiguration, ValidConfigBehavior);
156 FRIEND_TEST_ALL_PREFIXES(ApmConfiguration, InValidConfigBehavior);
Sam Zackrissonb37e59d2020-04-27 08:39:33 +0200157 FRIEND_TEST_ALL_PREFIXES(ApmWithSubmodulesExcludedTest,
158 ToggleTransientSuppressor);
159 FRIEND_TEST_ALL_PREFIXES(ApmWithSubmodulesExcludedTest,
160 ReinitializeTransientSuppressor);
161 FRIEND_TEST_ALL_PREFIXES(ApmWithSubmodulesExcludedTest,
162 BitexactWithDisabledModules);
163
Alessio Bazzica0c0c6022022-09-07 15:15:52 +0200164 void set_stream_analog_level_locked(int level)
165 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Alessio Bazzica533e4612022-09-07 16:58:33 +0200166 void UpdateRecommendedInputVolumeLocked()
Markus Handell0df0fae2020-07-07 15:53:34 +0200167 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Markus Handell02ba1d22020-05-14 14:31:18 +0200168
Sam Zackrissonb37e59d2020-04-27 08:39:33 +0200169 void OverrideSubmoduleCreationForTesting(
170 const ApmSubmoduleCreationOverrides& overrides);
Alessio Bazzicac054e782018-04-16 12:10:09 +0200171
172 // Class providing thread-safe message pipe functionality for
Artem Titov0b489302021-07-28 20:50:03 +0200173 // `runtime_settings_`.
Alessio Bazzicac054e782018-04-16 12:10:09 +0200174 class RuntimeSettingEnqueuer {
175 public:
176 explicit RuntimeSettingEnqueuer(
177 SwapQueue<RuntimeSetting>* runtime_settings);
178 ~RuntimeSettingEnqueuer();
Per Åhgren0a144a72021-02-09 08:47:51 +0100179
180 // Enqueue setting and return whether the setting was successfully enqueued.
181 bool Enqueue(RuntimeSetting setting);
Alessio Bazzicac054e782018-04-16 12:10:09 +0200182
183 private:
Alessio Bazzica33444dc2018-04-20 13:16:55 +0200184 SwapQueue<RuntimeSetting>& runtime_settings_;
Alex Loiko73ec0192018-05-15 10:52:28 +0200185 };
Alex Loiko73ec0192018-05-15 10:52:28 +0200186
Sam Zackrisson03cb7e52021-12-06 15:40:04 +0100187 const std::unique_ptr<ApmDataDumper> data_dumper_;
Niels Möller7a669002022-06-27 09:47:02 +0200188 static std::atomic<int> instance_count_;
Per Åhgrenb2b58d82019-12-02 14:59:40 +0100189 const bool use_setup_specific_default_aec3_config_;
Alex Loiko73ec0192018-05-15 10:52:28 +0200190
Alessio Bazzica0441bb62021-08-10 15:23:23 +0200191 const bool use_denormal_disabler_;
192
Alessio Bazzicaefbe3af2022-03-18 12:39:00 +0100193 const TransientSuppressor::VadMode transient_suppressor_vad_mode_;
194
Alex Loiko73ec0192018-05-15 10:52:28 +0200195 SwapQueue<RuntimeSetting> capture_runtime_settings_;
196 SwapQueue<RuntimeSetting> render_runtime_settings_;
197
198 RuntimeSettingEnqueuer capture_runtime_settings_enqueuer_;
199 RuntimeSettingEnqueuer render_runtime_settings_enqueuer_;
Alessio Bazzicac054e782018-04-16 12:10:09 +0200200
Gustaf Ullberg002ef282017-10-12 15:13:17 +0200201 // EchoControl factory.
Sam Zackrisson03cb7e52021-12-06 15:40:04 +0100202 const std::unique_ptr<EchoControlFactory> echo_control_factory_;
Gustaf Ullbergd8579e02017-10-11 16:29:02 +0200203
saza1d600522019-10-18 13:29:43 +0200204 class SubmoduleStates {
peah2ace3f92016-09-10 04:42:27 -0700205 public:
saza1d600522019-10-18 13:29:43 +0200206 SubmoduleStates(bool capture_post_processor_enabled,
207 bool render_pre_processor_enabled,
208 bool capture_analyzer_enabled);
peah2ace3f92016-09-10 04:42:27 -0700209 // Updates the submodule state and returns true if it has changed.
Sam Zackrissoncb1b5562018-09-28 14:15:09 +0200210 bool Update(bool high_pass_filter_enabled,
peah2ace3f92016-09-10 04:42:27 -0700211 bool mobile_echo_controller_enabled,
212 bool noise_suppressor_enabled,
peah2ace3f92016-09-10 04:42:27 -0700213 bool adaptive_gain_controller_enabled,
alessiob3ec96df2017-05-22 06:57:06 -0700214 bool gain_controller2_enabled,
Hanna Silen0c1ad292022-06-16 16:35:45 +0200215 bool voice_activity_detector_enabled,
Per Åhgrendb5d7282021-03-15 16:31:04 +0000216 bool gain_adjustment_enabled,
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200217 bool echo_controller_enabled,
peah2ace3f92016-09-10 04:42:27 -0700218 bool transient_suppressor_enabled);
219 bool CaptureMultiBandSubModulesActive() const;
Gustaf Ullberg8675eee2019-10-09 13:34:36 +0200220 bool CaptureMultiBandProcessingPresent() const;
221 bool CaptureMultiBandProcessingActive(bool ec_processing_active) const;
peah23ac8b42017-05-23 05:33:56 -0700222 bool CaptureFullBandProcessingActive() const;
Valeriia Nemychnikovaf06eb572018-08-29 10:37:09 +0200223 bool CaptureAnalyzerActive() const;
peah2ace3f92016-09-10 04:42:27 -0700224 bool RenderMultiBandSubModulesActive() const;
Alex Loiko5825aa62017-12-18 16:02:40 +0100225 bool RenderFullBandProcessingActive() const;
peah2ace3f92016-09-10 04:42:27 -0700226 bool RenderMultiBandProcessingActive() const;
Per Åhgren0aefbf02019-08-23 21:29:17 +0200227 bool HighPassFilteringRequired() const;
peah2ace3f92016-09-10 04:42:27 -0700228
229 private:
Sam Zackrisson0beac582017-09-25 12:04:02 +0200230 const bool capture_post_processor_enabled_ = false;
Alex Loiko5825aa62017-12-18 16:02:40 +0100231 const bool render_pre_processor_enabled_ = false;
Valeriia Nemychnikovaf06eb572018-08-29 10:37:09 +0200232 const bool capture_analyzer_enabled_ = false;
Sam Zackrissoncb1b5562018-09-28 14:15:09 +0200233 bool high_pass_filter_enabled_ = false;
peah2ace3f92016-09-10 04:42:27 -0700234 bool mobile_echo_controller_enabled_ = false;
235 bool noise_suppressor_enabled_ = false;
peah2ace3f92016-09-10 04:42:27 -0700236 bool adaptive_gain_controller_enabled_ = false;
Hanna Silen0c1ad292022-06-16 16:35:45 +0200237 bool voice_activity_detector_enabled_ = false;
alessiob3ec96df2017-05-22 06:57:06 -0700238 bool gain_controller2_enabled_ = false;
Per Åhgrendb5d7282021-03-15 16:31:04 +0000239 bool gain_adjustment_enabled_ = false;
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200240 bool echo_controller_enabled_ = false;
peah2ace3f92016-09-10 04:42:27 -0700241 bool transient_suppressor_enabled_ = false;
242 bool first_update_ = true;
243 };
244
Sam Zackrisson12e319a2020-01-03 14:54:20 +0100245 // Methods for modifying the formats struct that is used by both
246 // the render and capture threads. The check for whether modifications are
247 // needed is done while holding a single lock only, thereby avoiding that the
248 // capture thread blocks the render thread.
249 // Called by render: Holds the render lock when reading the format struct and
250 // acquires both locks if reinitialization is required.
peahdf3efa82015-11-28 12:35:15 -0800251 int MaybeInitializeRender(const ProcessingConfig& processing_config)
Markus Handell0df0fae2020-07-07 15:53:34 +0200252 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
Sam Zackrisson12e319a2020-01-03 14:54:20 +0100253 // Called by capture: Holds the capture lock when reading the format struct
254 // and acquires both locks if reinitialization is needed.
255 int MaybeInitializeCapture(const StreamConfig& input_config,
256 const StreamConfig& output_config);
peahdf3efa82015-11-28 12:35:15 -0800257
peah2ace3f92016-09-10 04:42:27 -0700258 // Method for updating the state keeping track of the active submodules.
259 // Returns a bool indicating whether the state has changed.
danilchap56359be2017-09-07 07:53:45 -0700260 bool UpdateActiveSubmoduleStates()
Markus Handell0df0fae2020-07-07 15:53:34 +0200261 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
peahdf3efa82015-11-28 12:35:15 -0800262
Per Åhgrenc0734712020-01-02 15:15:36 +0100263 // Methods requiring APM running in a single-threaded manner, requiring both
264 // the render and capture lock to be acquired.
Michael Graczyk86c6d332015-07-23 11:41:39 -0700265 int InitializeLocked(const ProcessingConfig& config)
Markus Handell0df0fae2020-07-07 15:53:34 +0200266 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_);
ivoc9f4a4a02016-10-28 05:39:16 -0700267 void InitializeResidualEchoDetector()
Markus Handell0df0fae2020-07-07 15:53:34 +0200268 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_);
Per Åhgrenf204faf2019-04-25 15:18:06 +0200269 void InitializeEchoController()
Markus Handell0df0fae2020-07-07 15:53:34 +0200270 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_);
Per Åhgrenc0734712020-01-02 15:15:36 +0100271
Alessio Bazzica38901042021-10-14 12:14:21 +0200272 // Initializations of capture-only sub-modules, requiring the capture lock
Per Åhgrenc0734712020-01-02 15:15:36 +0100273 // already acquired.
Per Åhgren0f14db22020-01-03 14:27:14 +0100274 void InitializeHighPassFilter(bool forced_reset)
Markus Handell0df0fae2020-07-07 15:53:34 +0200275 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Markus Handell0df0fae2020-07-07 15:53:34 +0200276 void InitializeGainController1() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Per Åhgrenc0734712020-01-02 15:15:36 +0100277 void InitializeTransientSuppressor()
Markus Handell0df0fae2020-07-07 15:53:34 +0200278 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Alessio Bazzica38901042021-10-14 12:14:21 +0200279 // Initializes the `GainController2` sub-module. If the sub-module is enabled
280 // and `config_has_changed` is true, recreates the sub-module.
281 void InitializeGainController2(bool config_has_changed)
282 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Hanna Silen0c1ad292022-06-16 16:35:45 +0200283 // Initializes the `VoiceActivityDetectorWrapper` sub-module. If the
284 // sub-module is enabled and `config_has_changed` is true, recreates the
285 // sub-module.
286 void InitializeVoiceActivityDetector(bool config_has_changed)
287 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Markus Handell0df0fae2020-07-07 15:53:34 +0200288 void InitializeNoiseSuppressor() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Per Åhgrendb5d7282021-03-15 16:31:04 +0000289 void InitializeCaptureLevelsAdjuster()
290 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Markus Handell0df0fae2020-07-07 15:53:34 +0200291 void InitializePostProcessor() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
292 void InitializeAnalyzer() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Per Åhgrenc0734712020-01-02 15:15:36 +0100293
294 // Initializations of render-only submodules, requiring the render lock
295 // already acquired.
Markus Handell0df0fae2020-07-07 15:53:34 +0200296 void InitializePreProcessor() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
peahdf3efa82015-11-28 12:35:15 -0800297
Gustaf Ullberg422b9e02019-10-09 13:02:14 +0200298 // Sample rate used for the fullband processing.
299 int proc_fullband_sample_rate_hz() const
Markus Handell0df0fae2020-07-07 15:53:34 +0200300 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
Gustaf Ullberg422b9e02019-10-09 13:02:14 +0200301
Alex Loiko73ec0192018-05-15 10:52:28 +0200302 // Empties and handles the respective RuntimeSetting queues.
303 void HandleCaptureRuntimeSettings()
Markus Handell0df0fae2020-07-07 15:53:34 +0200304 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
305 void HandleRenderRuntimeSettings()
306 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
Sam Zackrissonf0d1c032019-03-27 13:28:08 +0100307
Markus Handell0df0fae2020-07-07 15:53:34 +0200308 void EmptyQueuedRenderAudio() RTC_LOCKS_EXCLUDED(mutex_capture_);
Markus Handell02ba1d22020-05-14 14:31:18 +0200309 void EmptyQueuedRenderAudioLocked()
Markus Handell0df0fae2020-07-07 15:53:34 +0200310 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
peah764e3642016-10-22 05:04:30 -0700311 void AllocateRenderQueue()
Markus Handell0df0fae2020-07-07 15:53:34 +0200312 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_);
peah9e6a2902017-05-15 07:19:21 -0700313 void QueueBandedRenderAudio(AudioBuffer* audio)
Markus Handell0df0fae2020-07-07 15:53:34 +0200314 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
peah9e6a2902017-05-15 07:19:21 -0700315 void QueueNonbandedRenderAudio(AudioBuffer* audio)
Markus Handell0df0fae2020-07-07 15:53:34 +0200316 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
peah764e3642016-10-22 05:04:30 -0700317
peahdf3efa82015-11-28 12:35:15 -0800318 // Capture-side exclusive methods possibly running APM in a multi-threaded
319 // manner that are called with the render lock already acquired.
Markus Handell0df0fae2020-07-07 15:53:34 +0200320 int ProcessCaptureStreamLocked() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
peahdf3efa82015-11-28 12:35:15 -0800321
322 // Render-side exclusive methods possibly running APM in a multi-threaded
323 // manner that are called with the render lock already acquired.
ekmeyerson60d9b332015-08-14 10:35:55 -0700324 // TODO(ekm): Remove once all clients updated to new interface.
peahdf3efa82015-11-28 12:35:15 -0800325 int AnalyzeReverseStreamLocked(const float* const* src,
326 const StreamConfig& input_config,
327 const StreamConfig& output_config)
Markus Handell0df0fae2020-07-07 15:53:34 +0200328 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
329 int ProcessRenderStreamLocked() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_);
andrew@webrtc.org17e40642014-03-04 20:58:13 +0000330
aleloi868f32f2017-05-23 07:20:05 -0700331 // Collects configuration settings from public and private
332 // submodules to be saved as an audioproc::Config message on the
Artem Titov0b489302021-07-28 20:50:03 +0200333 // AecDump if it is attached. If not `forced`, only writes the current
334 // config if it is different from the last saved one; if `forced`,
aleloi868f32f2017-05-23 07:20:05 -0700335 // writes the config regardless of the last saved.
336 void WriteAecDumpConfigMessage(bool forced)
Markus Handell0df0fae2020-07-07 15:53:34 +0200337 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700338
339 // Notifies attached AecDump of current configuration and capture data.
340 void RecordUnprocessedCaptureStream(const float* const* capture_stream)
Markus Handell0df0fae2020-07-07 15:53:34 +0200341 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700342
Per Åhgren645f24c2020-03-16 12:06:02 +0100343 void RecordUnprocessedCaptureStream(const int16_t* const data,
344 const StreamConfig& config)
Markus Handell0df0fae2020-07-07 15:53:34 +0200345 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700346
347 // Notifies attached AecDump of current configuration and
348 // processed capture data and issues a capture stream recording
349 // request.
350 void RecordProcessedCaptureStream(
351 const float* const* processed_capture_stream)
Markus Handell0df0fae2020-07-07 15:53:34 +0200352 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700353
Per Åhgren645f24c2020-03-16 12:06:02 +0100354 void RecordProcessedCaptureStream(const int16_t* const data,
355 const StreamConfig& config)
Markus Handell0df0fae2020-07-07 15:53:34 +0200356 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700357
358 // Notifies attached AecDump about current state (delay, drift, etc).
Markus Handell0df0fae2020-07-07 15:53:34 +0200359 void RecordAudioProcessingState()
360 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700361
Per Åhgren652ada52021-03-03 10:52:44 +0000362 // Ensures that overruns in the capture runtime settings queue is properly
363 // handled by the code, providing safe-fallbacks to mitigate the implications
364 // of any settings being missed.
365 void HandleOverrunInCaptureRuntimeSettingsQueue()
366 RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_);
367
aleloi868f32f2017-05-23 07:20:05 -0700368 // AecDump instance used for optionally logging APM config, input
369 // and output to file in the AEC-dump format defined in debug.proto.
370 std::unique_ptr<AecDump> aec_dump_;
371
372 // Hold the last config written with AecDump for avoiding writing
373 // the same config twice.
Markus Handell0df0fae2020-07-07 15:53:34 +0200374 InternalAPMConfig apm_config_for_aec_dump_ RTC_GUARDED_BY(mutex_capture_);
aleloi868f32f2017-05-23 07:20:05 -0700375
peahdf3efa82015-11-28 12:35:15 -0800376 // Critical sections.
Markus Handell0df0fae2020-07-07 15:53:34 +0200377 mutable Mutex mutex_render_ RTC_ACQUIRED_BEFORE(mutex_capture_);
378 mutable Mutex mutex_capture_;
peahdf3efa82015-11-28 12:35:15 -0800379
peahc19f3122016-10-07 14:54:10 -0700380 // Struct containing the Config specifying the behavior of APM.
381 AudioProcessing::Config config_;
382
Sam Zackrissonb37e59d2020-04-27 08:39:33 +0200383 // Overrides for testing the exclusion of some submodules from the build.
384 ApmSubmoduleCreationOverrides submodule_creation_overrides_
Markus Handell0df0fae2020-07-07 15:53:34 +0200385 RTC_GUARDED_BY(mutex_capture_);
Sam Zackrissonb37e59d2020-04-27 08:39:33 +0200386
peah2ace3f92016-09-10 04:42:27 -0700387 // Class containing information about what submodules are active.
saza1d600522019-10-18 13:29:43 +0200388 SubmoduleStates submodule_states_;
peah2ace3f92016-09-10 04:42:27 -0700389
saza1d600522019-10-18 13:29:43 +0200390 // Struct containing the pointers to the submodules.
391 struct Submodules {
392 Submodules(std::unique_ptr<CustomProcessing> capture_post_processor,
393 std::unique_ptr<CustomProcessing> render_pre_processor,
394 rtc::scoped_refptr<EchoDetector> echo_detector,
Per Åhgren3daedb62019-11-22 12:11:40 +0100395 std::unique_ptr<CustomAudioAnalyzer> capture_analyzer)
saza1d600522019-10-18 13:29:43 +0200396 : echo_detector(std::move(echo_detector)),
397 capture_post_processor(std::move(capture_post_processor)),
398 render_pre_processor(std::move(render_pre_processor)),
Per Åhgren3daedb62019-11-22 12:11:40 +0100399 capture_analyzer(std::move(capture_analyzer)) {}
saza1d600522019-10-18 13:29:43 +0200400 // Accessed internally from capture or during initialization.
Sam Zackrisson03cb7e52021-12-06 15:40:04 +0100401 const rtc::scoped_refptr<EchoDetector> echo_detector;
402 const std::unique_ptr<CustomProcessing> capture_post_processor;
403 const std::unique_ptr<CustomProcessing> render_pre_processor;
404 const std::unique_ptr<CustomAudioAnalyzer> capture_analyzer;
saza1d600522019-10-18 13:29:43 +0200405 std::unique_ptr<AgcManagerDirect> agc_manager;
406 std::unique_ptr<GainControlImpl> gain_control;
saza1d600522019-10-18 13:29:43 +0200407 std::unique_ptr<GainController2> gain_controller2;
Hanna Silen0c1ad292022-06-16 16:35:45 +0200408 std::unique_ptr<VoiceActivityDetectorWrapper> voice_activity_detector;
saza1d600522019-10-18 13:29:43 +0200409 std::unique_ptr<HighPassFilter> high_pass_filter;
saza1d600522019-10-18 13:29:43 +0200410 std::unique_ptr<EchoControl> echo_controller;
411 std::unique_ptr<EchoControlMobileImpl> echo_control_mobile;
Per Åhgren0cbb58e2019-10-29 22:59:44 +0100412 std::unique_ptr<NoiseSuppressor> noise_suppressor;
saza1d600522019-10-18 13:29:43 +0200413 std::unique_ptr<TransientSuppressor> transient_suppressor;
Per Åhgrendb5d7282021-03-15 16:31:04 +0000414 std::unique_ptr<CaptureLevelsAdjuster> capture_levels_adjuster;
saza1d600522019-10-18 13:29:43 +0200415 } submodules_;
peahdf3efa82015-11-28 12:35:15 -0800416
peah192164e2015-11-17 02:16:45 -0800417 // State that is written to while holding both the render and capture locks
peahdf3efa82015-11-28 12:35:15 -0800418 // but can be read without any lock being held.
419 // As this is only accessed internally of APM, and all internal methods in APM
420 // either are holding the render or capture locks, this construct is safe as
421 // it is not possible to read the variables while writing them.
422 struct ApmFormatState {
423 ApmFormatState()
peah192164e2015-11-17 02:16:45 -0800424 : // Format of processing streams at input/output call sites.
Henrik Lundin64253a92022-02-04 09:02:48 +0000425 api_format({{{kSampleRate16kHz, 1},
426 {kSampleRate16kHz, 1},
427 {kSampleRate16kHz, 1},
428 {kSampleRate16kHz, 1}}}),
peahde65ddc2016-09-16 15:02:15 -0700429 render_processing_format(kSampleRate16kHz, 1) {}
peahdf3efa82015-11-28 12:35:15 -0800430 ProcessingConfig api_format;
peahde65ddc2016-09-16 15:02:15 -0700431 StreamConfig render_processing_format;
peahdf3efa82015-11-28 12:35:15 -0800432 } formats_;
Michael Graczyk86c6d332015-07-23 11:41:39 -0700433
peahdf3efa82015-11-28 12:35:15 -0800434 // APM constants.
435 const struct ApmConstants {
Per Åhgren0695df12020-01-13 14:43:13 +0100436 ApmConstants(bool multi_channel_render_support,
Per Åhgrenc0424252019-12-10 13:04:15 +0100437 bool multi_channel_capture_support,
Per Åhgren19775cb2021-03-12 23:08:09 +0000438 bool enforce_split_band_hpf,
Gustaf Ullberga399c822021-05-18 12:17:56 +0200439 bool minimize_processing_for_unused_output,
440 bool transient_suppressor_forced_off)
Per Åhgren0695df12020-01-13 14:43:13 +0100441 : multi_channel_render_support(multi_channel_render_support),
Per Åhgrenc0424252019-12-10 13:04:15 +0100442 multi_channel_capture_support(multi_channel_capture_support),
Per Åhgren19775cb2021-03-12 23:08:09 +0000443 enforce_split_band_hpf(enforce_split_band_hpf),
444 minimize_processing_for_unused_output(
Gustaf Ullberga399c822021-05-18 12:17:56 +0200445 minimize_processing_for_unused_output),
446 transient_suppressor_forced_off(transient_suppressor_forced_off) {}
Per Åhgrene14cb992019-11-27 09:34:22 +0100447 bool multi_channel_render_support;
448 bool multi_channel_capture_support;
Per Åhgrenc0424252019-12-10 13:04:15 +0100449 bool enforce_split_band_hpf;
Per Åhgren19775cb2021-03-12 23:08:09 +0000450 bool minimize_processing_for_unused_output;
Gustaf Ullberga399c822021-05-18 12:17:56 +0200451 bool transient_suppressor_forced_off;
peahdf3efa82015-11-28 12:35:15 -0800452 } constants_;
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000453
peahdf3efa82015-11-28 12:35:15 -0800454 struct ApmCaptureState {
Per Åhgrenc0734712020-01-02 15:15:36 +0100455 ApmCaptureState();
kwiberg83ffe452016-08-29 14:46:07 -0700456 ~ApmCaptureState();
peahdf3efa82015-11-28 12:35:15 -0800457 bool was_stream_delay_set;
Per Åhgren0a144a72021-02-09 08:47:51 +0100458 bool capture_output_used;
Per Åhgren55bc0772021-03-12 14:18:36 +0000459 bool capture_output_used_last_frame;
peahdf3efa82015-11-28 12:35:15 -0800460 bool key_pressed;
kwiberg88788ad2016-02-19 07:04:49 -0800461 std::unique_ptr<AudioBuffer> capture_audio;
Gustaf Ullberg422b9e02019-10-09 13:02:14 +0200462 std::unique_ptr<AudioBuffer> capture_fullband_audio;
Per Åhgrenc20a19c2019-11-13 11:12:29 +0100463 std::unique_ptr<AudioBuffer> linear_aec_output;
peahde65ddc2016-09-16 15:02:15 -0700464 // Only the rate and samples fields of capture_processing_format_ are used
465 // because the capture processing number of channels is mutable and is
466 // tracked by the capture_audio_.
467 StreamConfig capture_processing_format;
peahdf3efa82015-11-28 12:35:15 -0800468 int split_rate;
peah67995532017-04-10 14:12:41 -0700469 bool echo_path_gain_change;
Per Åhgrendb5d7282021-03-15 16:31:04 +0000470 float prev_pre_adjustment_gain;
Fredrik Hernqvistca362852019-05-10 15:50:02 +0200471 int playout_volume;
472 int prev_playout_volume;
Sam Zackrissonb24c00f2018-11-26 16:18:25 +0100473 AudioProcessingStats stats;
Alessio Bazzicafcf1af32022-09-07 17:14:26 +0200474 // Input volume applied on the audio input device when the audio is
475 // acquired. Unspecified when unknown.
476 absl::optional<int> applied_input_volume;
477 bool applied_input_volume_changed;
Alessio Bazzica533e4612022-09-07 16:58:33 +0200478 // Recommended input volume to apply on the audio input device the next time
479 // that audio is acquired. Unspecified when no input volume can be
480 // recommended.
481 absl::optional<int> recommended_input_volume;
Markus Handell0df0fae2020-07-07 15:53:34 +0200482 } capture_ RTC_GUARDED_BY(mutex_capture_);
niklase@google.com470e71d2011-07-07 08:21:25 +0000483
peahdf3efa82015-11-28 12:35:15 -0800484 struct ApmCaptureNonLockedState {
Alessio Bazzicacc22f512018-08-30 13:01:34 +0200485 ApmCaptureNonLockedState()
peahde65ddc2016-09-16 15:02:15 -0700486 : capture_processing_format(kSampleRate16kHz),
peahdf3efa82015-11-28 12:35:15 -0800487 split_rate(kSampleRate16kHz),
Alessio Bazzicacc22f512018-08-30 13:01:34 +0200488 stream_delay_ms(0) {}
peahde65ddc2016-09-16 15:02:15 -0700489 // Only the rate and samples fields of capture_processing_format_ are used
490 // because the forward processing number of channels is mutable and is
491 // tracked by the capture_audio_.
492 StreamConfig capture_processing_format;
peahdf3efa82015-11-28 12:35:15 -0800493 int split_rate;
494 int stream_delay_ms;
Gustaf Ullbergce045ac2017-10-16 13:49:04 +0200495 bool echo_controller_enabled = false;
peahdf3efa82015-11-28 12:35:15 -0800496 } capture_nonlocked_;
andrew@webrtc.org75dd2882014-02-11 20:52:30 +0000497
peahdf3efa82015-11-28 12:35:15 -0800498 struct ApmRenderState {
kwiberg83ffe452016-08-29 14:46:07 -0700499 ApmRenderState();
500 ~ApmRenderState();
kwiberg88788ad2016-02-19 07:04:49 -0800501 std::unique_ptr<AudioConverter> render_converter;
502 std::unique_ptr<AudioBuffer> render_audio;
Markus Handell0df0fae2020-07-07 15:53:34 +0200503 } render_ RTC_GUARDED_BY(mutex_render_);
peah764e3642016-10-22 05:04:30 -0700504
Per Åhgrencf4c8722019-12-30 14:32:14 +0100505 // Class for statistics reporting. The class is thread-safe and no lock is
506 // needed when accessing it.
507 class ApmStatsReporter {
508 public:
509 ApmStatsReporter();
510 ~ApmStatsReporter();
511
512 // Returns the most recently reported statistics.
513 AudioProcessingStats GetStatistics();
514
515 // Update the cached statistics.
516 void UpdateStatistics(const AudioProcessingStats& new_stats);
517
518 private:
Markus Handell0df0fae2020-07-07 15:53:34 +0200519 Mutex mutex_stats_;
520 AudioProcessingStats cached_stats_ RTC_GUARDED_BY(mutex_stats_);
Per Åhgrencf4c8722019-12-30 14:32:14 +0100521 SwapQueue<AudioProcessingStats> stats_message_queue_;
522 } stats_reporter_;
523
Markus Handell0df0fae2020-07-07 15:53:34 +0200524 std::vector<int16_t> aecm_render_queue_buffer_ RTC_GUARDED_BY(mutex_render_);
525 std::vector<int16_t> aecm_capture_queue_buffer_
526 RTC_GUARDED_BY(mutex_capture_);
peah701d6282016-10-25 05:42:20 -0700527
Markus Handell0df0fae2020-07-07 15:53:34 +0200528 size_t agc_render_queue_element_max_size_ RTC_GUARDED_BY(mutex_render_)
529 RTC_GUARDED_BY(mutex_capture_) = 0;
530 std::vector<int16_t> agc_render_queue_buffer_ RTC_GUARDED_BY(mutex_render_);
531 std::vector<int16_t> agc_capture_queue_buffer_ RTC_GUARDED_BY(mutex_capture_);
peah764e3642016-10-22 05:04:30 -0700532
Markus Handell0df0fae2020-07-07 15:53:34 +0200533 size_t red_render_queue_element_max_size_ RTC_GUARDED_BY(mutex_render_)
534 RTC_GUARDED_BY(mutex_capture_) = 0;
535 std::vector<float> red_render_queue_buffer_ RTC_GUARDED_BY(mutex_render_);
536 std::vector<float> red_capture_queue_buffer_ RTC_GUARDED_BY(mutex_capture_);
ivoc9f4a4a02016-10-28 05:39:16 -0700537
Markus Handell0df0fae2020-07-07 15:53:34 +0200538 RmsLevel capture_input_rms_ RTC_GUARDED_BY(mutex_capture_);
539 RmsLevel capture_output_rms_ RTC_GUARDED_BY(mutex_capture_);
540 int capture_rms_interval_counter_ RTC_GUARDED_BY(mutex_capture_) = 0;
henrik.lundin290d43a2016-11-29 08:09:09 -0800541
Alessio Bazzicac34a8c12022-10-26 13:30:25 +0000542 InputVolumeStatsReporter applied_input_volume_stats_reporter_
Hanna Silen529131d2021-10-29 14:55:45 +0200543 RTC_GUARDED_BY(mutex_capture_);
Alessio Bazzicafbe5d7c2022-10-27 00:05:32 +0200544 InputVolumeStatsReporter recommended_input_volume_stats_reporter_
545 RTC_GUARDED_BY(mutex_capture_);
Hanna Silen529131d2021-10-29 14:55:45 +0200546
peah764e3642016-10-22 05:04:30 -0700547 // Lock protection not needed.
peaha0624602016-10-25 04:45:24 -0700548 std::unique_ptr<
549 SwapQueue<std::vector<int16_t>, RenderQueueItemVerifier<int16_t>>>
peah701d6282016-10-25 05:42:20 -0700550 aecm_render_signal_queue_;
551 std::unique_ptr<
552 SwapQueue<std::vector<int16_t>, RenderQueueItemVerifier<int16_t>>>
553 agc_render_signal_queue_;
ivoc9f4a4a02016-10-28 05:39:16 -0700554 std::unique_ptr<SwapQueue<std::vector<float>, RenderQueueItemVerifier<float>>>
555 red_render_signal_queue_;
niklase@google.com470e71d2011-07-07 08:21:25 +0000556};
andrew@webrtc.orgddbb8a22014-04-22 21:00:04 +0000557
niklase@google.com470e71d2011-07-07 08:21:25 +0000558} // namespace webrtc
559
Mirko Bonadei92ea95e2017-09-15 06:47:31 +0200560#endif // MODULES_AUDIO_PROCESSING_AUDIO_PROCESSING_IMPL_H_