niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 1 | /* |
andrew@webrtc.org | 6f9f817 | 2012-03-06 19:03:39 +0000 | [diff] [blame] | 2 | * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 3 | * |
| 4 | * Use of this source code is governed by a BSD-style license |
| 5 | * that can be found in the LICENSE file in the root of the source |
| 6 | * tree. An additional intellectual property rights grant can be found |
| 7 | * in the file PATENTS. All contributing project authors may |
| 8 | * be found in the AUTHORS file in the root of the source tree. |
| 9 | */ |
| 10 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 11 | #ifndef MODULES_AUDIO_PROCESSING_AUDIO_PROCESSING_IMPL_H_ |
| 12 | #define MODULES_AUDIO_PROCESSING_AUDIO_PROCESSING_IMPL_H_ |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 13 | |
Per Åhgren | 09e9a83 | 2020-05-11 11:03:47 +0200 | [diff] [blame] | 14 | #include <stdio.h> |
| 15 | |
Niels Möller | 7a66900 | 2022-06-27 09:47:02 +0200 | [diff] [blame] | 16 | #include <atomic> |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 17 | #include <list> |
kwiberg | 88788ad | 2016-02-19 07:04:49 -0800 | [diff] [blame] | 18 | #include <memory> |
Per Åhgren | 09e9a83 | 2020-05-11 11:03:47 +0200 | [diff] [blame] | 19 | #include <string> |
Michael Graczyk | 86c6d33 | 2015-07-23 11:41:39 -0700 | [diff] [blame] | 20 | #include <vector> |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 21 | |
Ali Tofigh | 1fa87c4 | 2022-07-25 22:07:08 +0200 | [diff] [blame] | 22 | #include "absl/strings/string_view.h" |
Alessio Bazzica | fcf1af3 | 2022-09-07 17:14:26 +0200 | [diff] [blame] | 23 | #include "absl/types/optional.h" |
Alessio Bazzica | bab1285 | 2022-02-03 16:30:25 +0100 | [diff] [blame] | 24 | #include "api/array_view.h" |
Artem Titov | 741daaf | 2019-03-21 14:37:36 +0100 | [diff] [blame] | 25 | #include "api/function_view.h" |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 26 | #include "modules/audio_processing/aec3/echo_canceller3.h" |
| 27 | #include "modules/audio_processing/agc/agc_manager_direct.h" |
Sam Zackrisson | 41478c7 | 2019-10-15 10:10:26 +0200 | [diff] [blame] | 28 | #include "modules/audio_processing/agc/gain_control.h" |
Alessio Bazzica | d226c57 | 2022-10-24 22:05:19 +0200 | [diff] [blame] | 29 | #include "modules/audio_processing/agc2/input_volume_stats_reporter.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 30 | #include "modules/audio_processing/audio_buffer.h" |
Per Åhgren | db5d728 | 2021-03-15 16:31:04 +0000 | [diff] [blame] | 31 | #include "modules/audio_processing/capture_levels_adjuster/capture_levels_adjuster.h" |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 32 | #include "modules/audio_processing/echo_control_mobile_impl.h" |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 33 | #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 Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 36 | #include "modules/audio_processing/include/aec_dump.h" |
Per Åhgren | 71652f4 | 2020-03-17 13:23:58 +0100 | [diff] [blame] | 37 | #include "modules/audio_processing/include/audio_frame_proxies.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 38 | #include "modules/audio_processing/include/audio_processing.h" |
Sam Zackrisson | b24c00f | 2018-11-26 16:18:25 +0100 | [diff] [blame] | 39 | #include "modules/audio_processing/include/audio_processing_statistics.h" |
Per Åhgren | 0cbb58e | 2019-10-29 22:59:44 +0100 | [diff] [blame] | 40 | #include "modules/audio_processing/ns/noise_suppressor.h" |
Sam Zackrisson | b37e59d | 2020-04-27 08:39:33 +0200 | [diff] [blame] | 41 | #include "modules/audio_processing/optionally_built_submodule_creators.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 42 | #include "modules/audio_processing/render_queue_item_verifier.h" |
| 43 | #include "modules/audio_processing/rms_level.h" |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 44 | #include "modules/audio_processing/transient/transient_suppressor.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 45 | #include "rtc_base/gtest_prod_util.h" |
| 46 | #include "rtc_base/ignore_wundef.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 47 | #include "rtc_base/swap_queue.h" |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 48 | #include "rtc_base/synchronization/mutex.h" |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 49 | #include "rtc_base/thread_annotations.h" |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 50 | |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 51 | namespace webrtc { |
andrew@webrtc.org | ddbb8a2 | 2014-04-22 21:00:04 +0000 | [diff] [blame] | 52 | |
Per Åhgren | 1373582 | 2018-02-12 21:42:56 +0100 | [diff] [blame] | 53 | class ApmDataDumper; |
ekmeyerson | 60d9b33 | 2015-08-14 10:35:55 -0700 | [diff] [blame] | 54 | class AudioConverter; |
Michael Graczyk | dfa3605 | 2015-03-25 16:37:27 -0700 | [diff] [blame] | 55 | |
Henrik Lundin | 8a9aa55 | 2022-02-08 09:15:12 +0000 | [diff] [blame] | 56 | constexpr int RuntimeSettingQueueSize() { |
| 57 | return 100; |
| 58 | } |
| 59 | |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 60 | class AudioProcessingImpl : public AudioProcessing { |
| 61 | public: |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 62 | // Methods forcing APM to run in a single-threaded manner. |
| 63 | // Acquires both the render and capture locks. |
Alessio Bazzica | be1b898 | 2021-09-17 08:26:10 +0200 | [diff] [blame] | 64 | AudioProcessingImpl(); |
Alessio Bazzica | 20a9ac6 | 2021-10-14 10:55:08 +0200 | [diff] [blame] | 65 | AudioProcessingImpl(const AudioProcessing::Config& config, |
| 66 | std::unique_ptr<CustomProcessing> capture_post_processor, |
Alex Loiko | 5825aa6 | 2017-12-18 16:02:40 +0100 | [diff] [blame] | 67 | std::unique_ptr<CustomProcessing> render_pre_processor, |
Gustaf Ullberg | 002ef28 | 2017-10-12 15:13:17 +0200 | [diff] [blame] | 68 | std::unique_ptr<EchoControlFactory> echo_control_factory, |
Valeriia Nemychnikova | f06eb57 | 2018-08-29 10:37:09 +0200 | [diff] [blame] | 69 | rtc::scoped_refptr<EchoDetector> echo_detector, |
| 70 | std::unique_ptr<CustomAudioAnalyzer> capture_analyzer); |
kwiberg | 83ffe45 | 2016-08-29 14:46:07 -0700 | [diff] [blame] | 71 | ~AudioProcessingImpl() override; |
kjellander@webrtc.org | 14665ff | 2015-03-04 12:58:35 +0000 | [diff] [blame] | 72 | int Initialize() override; |
Michael Graczyk | 86c6d33 | 2015-07-23 11:41:39 -0700 | [diff] [blame] | 73 | int Initialize(const ProcessingConfig& processing_config) override; |
peah | 88ac853 | 2016-09-12 16:47:25 -0700 | [diff] [blame] | 74 | void ApplyConfig(const AudioProcessing::Config& config) override; |
Ali Tofigh | 1fa87c4 | 2022-07-25 22:07:08 +0200 | [diff] [blame] | 75 | bool CreateAndAttachAecDump(absl::string_view file_name, |
| 76 | int64_t max_log_size_bytes, |
| 77 | rtc::TaskQueue* worker_queue) override; |
Per Åhgren | 09e9a83 | 2020-05-11 11:03:47 +0200 | [diff] [blame] | 78 | bool CreateAndAttachAecDump(FILE* handle, |
| 79 | int64_t max_log_size_bytes, |
| 80 | rtc::TaskQueue* worker_queue) override; |
| 81 | // TODO(webrtc:5298) Deprecated variant. |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 82 | void AttachAecDump(std::unique_ptr<AecDump> aec_dump) override; |
| 83 | void DetachAecDump() override; |
Alessio Bazzica | c054e78 | 2018-04-16 12:10:09 +0200 | [diff] [blame] | 84 | void SetRuntimeSetting(RuntimeSetting setting) override; |
Per Åhgren | 0a144a7 | 2021-02-09 08:47:51 +0100 | [diff] [blame] | 85 | bool PostRuntimeSetting(RuntimeSetting setting) override; |
Alessio Bazzica | c054e78 | 2018-04-16 12:10:09 +0200 | [diff] [blame] | 86 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 87 | // Capture-side exclusive methods possibly running APM in a |
| 88 | // multi-threaded manner. Acquire the capture lock. |
Per Åhgren | 645f24c | 2020-03-16 12:06:02 +0100 | [diff] [blame] | 89 | int ProcessStream(const int16_t* const src, |
| 90 | const StreamConfig& input_config, |
| 91 | const StreamConfig& output_config, |
Per Åhgren | dc5522b | 2020-03-19 14:55:58 +0100 | [diff] [blame] | 92 | int16_t* const dest) override; |
kjellander@webrtc.org | 14665ff | 2015-03-04 12:58:35 +0000 | [diff] [blame] | 93 | int ProcessStream(const float* const* src, |
Michael Graczyk | 86c6d33 | 2015-07-23 11:41:39 -0700 | [diff] [blame] | 94 | const StreamConfig& input_config, |
| 95 | const StreamConfig& output_config, |
| 96 | float* const* dest) override; |
Per Åhgren | c20a19c | 2019-11-13 11:12:29 +0100 | [diff] [blame] | 97 | bool GetLinearAecOutput( |
| 98 | rtc::ArrayView<std::array<float, 160>> linear_output) const override; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 99 | void set_output_will_be_muted(bool muted) override; |
Per Åhgren | 0a144a7 | 2021-02-09 08:47:51 +0100 | [diff] [blame] | 100 | void HandleCaptureOutputUsedSetting(bool capture_output_used) |
| 101 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 102 | int set_stream_delay_ms(int delay) override; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 103 | void set_stream_key_pressed(bool key_pressed) override; |
Sam Zackrisson | f0d1c03 | 2019-03-27 13:28:08 +0100 | [diff] [blame] | 104 | void set_stream_analog_level(int level) override; |
Markus Handell | 02ba1d2 | 2020-05-14 14:31:18 +0200 | [diff] [blame] | 105 | int recommended_stream_analog_level() const |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 106 | RTC_LOCKS_EXCLUDED(mutex_capture_) override; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 107 | |
| 108 | // Render-side exclusive methods possibly running APM in a |
| 109 | // multi-threaded manner. Acquire the render lock. |
Per Åhgren | 645f24c | 2020-03-16 12:06:02 +0100 | [diff] [blame] | 110 | 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.org | 14665ff | 2015-03-04 12:58:35 +0000 | [diff] [blame] | 114 | int AnalyzeReverseStream(const float* const* data, |
Gustaf Ullberg | 8c51f2e | 2019-10-22 15:21:31 +0200 | [diff] [blame] | 115 | const StreamConfig& reverse_config) override; |
ekmeyerson | 60d9b33 | 2015-08-14 10:35:55 -0700 | [diff] [blame] | 116 | int ProcessReverseStream(const float* const* src, |
peah | de65ddc | 2016-09-16 15:02:15 -0700 | [diff] [blame] | 117 | const StreamConfig& input_config, |
| 118 | const StreamConfig& output_config, |
ekmeyerson | 60d9b33 | 2015-08-14 10:35:55 -0700 | [diff] [blame] | 119 | float* const* dest) override; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 120 | |
| 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 Kasting | 6955870 | 2016-01-12 16:26:35 -0800 | [diff] [blame] | 126 | 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.org | 14665ff | 2015-03-04 12:58:35 +0000 | [diff] [blame] | 130 | int stream_delay_ms() const override; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 131 | |
Per Åhgren | cf4c872 | 2019-12-30 14:32:14 +0100 | [diff] [blame] | 132 | AudioProcessingStats GetStatistics(bool has_remote_tracks) override { |
| 133 | return GetStatistics(); |
| 134 | } |
| 135 | AudioProcessingStats GetStatistics() override { |
| 136 | return stats_reporter_.GetStatistics(); |
| 137 | } |
ivoc | 3e9a537 | 2016-10-28 07:55:33 -0700 | [diff] [blame] | 138 | |
henrik.lundin | adf0635 | 2017-04-05 05:48:24 -0700 | [diff] [blame] | 139 | AudioProcessing::Config GetConfig() const override; |
peah | 8271d04 | 2016-11-22 07:24:52 -0800 | [diff] [blame] | 140 | |
andrew@webrtc.org | 60730cf | 2014-01-07 17:45:09 +0000 | [diff] [blame] | 141 | protected: |
andrew@webrtc.org | a8b9737 | 2014-03-10 22:26:12 +0000 | [diff] [blame] | 142 | // Overridden in a mock. |
Per Åhgren | 0ade983 | 2020-09-01 23:57:20 +0200 | [diff] [blame] | 143 | virtual void InitializeLocked() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 144 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_); |
Niels Möller | 5b74723 | 2021-07-26 17:16:25 +0200 | [diff] [blame] | 145 | void AssertLockedForTest() |
| 146 | RTC_ASSERT_EXCLUSIVE_LOCK(mutex_render_, mutex_capture_) { |
| 147 | mutex_render_.AssertHeld(); |
| 148 | mutex_capture_.AssertHeld(); |
| 149 | } |
andrew@webrtc.org | 60730cf | 2014-01-07 17:45:09 +0000 | [diff] [blame] | 150 | |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 151 | private: |
peah | c19f312 | 2016-10-07 14:54:10 -0700 | [diff] [blame] | 152 | // 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 Zackrisson | b37e59d | 2020-04-27 08:39:33 +0200 | [diff] [blame] | 157 | 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 Bazzica | 0c0c602 | 2022-09-07 15:15:52 +0200 | [diff] [blame] | 164 | void set_stream_analog_level_locked(int level) |
| 165 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Alessio Bazzica | 533e461 | 2022-09-07 16:58:33 +0200 | [diff] [blame] | 166 | void UpdateRecommendedInputVolumeLocked() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 167 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Markus Handell | 02ba1d2 | 2020-05-14 14:31:18 +0200 | [diff] [blame] | 168 | |
Sam Zackrisson | b37e59d | 2020-04-27 08:39:33 +0200 | [diff] [blame] | 169 | void OverrideSubmoduleCreationForTesting( |
| 170 | const ApmSubmoduleCreationOverrides& overrides); |
Alessio Bazzica | c054e78 | 2018-04-16 12:10:09 +0200 | [diff] [blame] | 171 | |
| 172 | // Class providing thread-safe message pipe functionality for |
Artem Titov | 0b48930 | 2021-07-28 20:50:03 +0200 | [diff] [blame] | 173 | // `runtime_settings_`. |
Alessio Bazzica | c054e78 | 2018-04-16 12:10:09 +0200 | [diff] [blame] | 174 | class RuntimeSettingEnqueuer { |
| 175 | public: |
| 176 | explicit RuntimeSettingEnqueuer( |
| 177 | SwapQueue<RuntimeSetting>* runtime_settings); |
| 178 | ~RuntimeSettingEnqueuer(); |
Per Åhgren | 0a144a7 | 2021-02-09 08:47:51 +0100 | [diff] [blame] | 179 | |
| 180 | // Enqueue setting and return whether the setting was successfully enqueued. |
| 181 | bool Enqueue(RuntimeSetting setting); |
Alessio Bazzica | c054e78 | 2018-04-16 12:10:09 +0200 | [diff] [blame] | 182 | |
| 183 | private: |
Alessio Bazzica | 33444dc | 2018-04-20 13:16:55 +0200 | [diff] [blame] | 184 | SwapQueue<RuntimeSetting>& runtime_settings_; |
Alex Loiko | 73ec019 | 2018-05-15 10:52:28 +0200 | [diff] [blame] | 185 | }; |
Alex Loiko | 73ec019 | 2018-05-15 10:52:28 +0200 | [diff] [blame] | 186 | |
Sam Zackrisson | 03cb7e5 | 2021-12-06 15:40:04 +0100 | [diff] [blame] | 187 | const std::unique_ptr<ApmDataDumper> data_dumper_; |
Niels Möller | 7a66900 | 2022-06-27 09:47:02 +0200 | [diff] [blame] | 188 | static std::atomic<int> instance_count_; |
Per Åhgren | b2b58d8 | 2019-12-02 14:59:40 +0100 | [diff] [blame] | 189 | const bool use_setup_specific_default_aec3_config_; |
Alex Loiko | 73ec019 | 2018-05-15 10:52:28 +0200 | [diff] [blame] | 190 | |
Alessio Bazzica | 0441bb6 | 2021-08-10 15:23:23 +0200 | [diff] [blame] | 191 | const bool use_denormal_disabler_; |
| 192 | |
Alessio Bazzica | efbe3af | 2022-03-18 12:39:00 +0100 | [diff] [blame] | 193 | const TransientSuppressor::VadMode transient_suppressor_vad_mode_; |
| 194 | |
Alex Loiko | 73ec019 | 2018-05-15 10:52:28 +0200 | [diff] [blame] | 195 | 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 Bazzica | c054e78 | 2018-04-16 12:10:09 +0200 | [diff] [blame] | 200 | |
Gustaf Ullberg | 002ef28 | 2017-10-12 15:13:17 +0200 | [diff] [blame] | 201 | // EchoControl factory. |
Sam Zackrisson | 03cb7e5 | 2021-12-06 15:40:04 +0100 | [diff] [blame] | 202 | const std::unique_ptr<EchoControlFactory> echo_control_factory_; |
Gustaf Ullberg | d8579e0 | 2017-10-11 16:29:02 +0200 | [diff] [blame] | 203 | |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 204 | class SubmoduleStates { |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 205 | public: |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 206 | SubmoduleStates(bool capture_post_processor_enabled, |
| 207 | bool render_pre_processor_enabled, |
| 208 | bool capture_analyzer_enabled); |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 209 | // Updates the submodule state and returns true if it has changed. |
Sam Zackrisson | cb1b556 | 2018-09-28 14:15:09 +0200 | [diff] [blame] | 210 | bool Update(bool high_pass_filter_enabled, |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 211 | bool mobile_echo_controller_enabled, |
| 212 | bool noise_suppressor_enabled, |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 213 | bool adaptive_gain_controller_enabled, |
alessiob | 3ec96df | 2017-05-22 06:57:06 -0700 | [diff] [blame] | 214 | bool gain_controller2_enabled, |
Hanna Silen | 0c1ad29 | 2022-06-16 16:35:45 +0200 | [diff] [blame] | 215 | bool voice_activity_detector_enabled, |
Per Åhgren | db5d728 | 2021-03-15 16:31:04 +0000 | [diff] [blame] | 216 | bool gain_adjustment_enabled, |
Gustaf Ullberg | ce045ac | 2017-10-16 13:49:04 +0200 | [diff] [blame] | 217 | bool echo_controller_enabled, |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 218 | bool transient_suppressor_enabled); |
| 219 | bool CaptureMultiBandSubModulesActive() const; |
Gustaf Ullberg | 8675eee | 2019-10-09 13:34:36 +0200 | [diff] [blame] | 220 | bool CaptureMultiBandProcessingPresent() const; |
| 221 | bool CaptureMultiBandProcessingActive(bool ec_processing_active) const; |
peah | 23ac8b4 | 2017-05-23 05:33:56 -0700 | [diff] [blame] | 222 | bool CaptureFullBandProcessingActive() const; |
Valeriia Nemychnikova | f06eb57 | 2018-08-29 10:37:09 +0200 | [diff] [blame] | 223 | bool CaptureAnalyzerActive() const; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 224 | bool RenderMultiBandSubModulesActive() const; |
Alex Loiko | 5825aa6 | 2017-12-18 16:02:40 +0100 | [diff] [blame] | 225 | bool RenderFullBandProcessingActive() const; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 226 | bool RenderMultiBandProcessingActive() const; |
Per Åhgren | 0aefbf0 | 2019-08-23 21:29:17 +0200 | [diff] [blame] | 227 | bool HighPassFilteringRequired() const; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 228 | |
| 229 | private: |
Sam Zackrisson | 0beac58 | 2017-09-25 12:04:02 +0200 | [diff] [blame] | 230 | const bool capture_post_processor_enabled_ = false; |
Alex Loiko | 5825aa6 | 2017-12-18 16:02:40 +0100 | [diff] [blame] | 231 | const bool render_pre_processor_enabled_ = false; |
Valeriia Nemychnikova | f06eb57 | 2018-08-29 10:37:09 +0200 | [diff] [blame] | 232 | const bool capture_analyzer_enabled_ = false; |
Sam Zackrisson | cb1b556 | 2018-09-28 14:15:09 +0200 | [diff] [blame] | 233 | bool high_pass_filter_enabled_ = false; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 234 | bool mobile_echo_controller_enabled_ = false; |
| 235 | bool noise_suppressor_enabled_ = false; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 236 | bool adaptive_gain_controller_enabled_ = false; |
Hanna Silen | 0c1ad29 | 2022-06-16 16:35:45 +0200 | [diff] [blame] | 237 | bool voice_activity_detector_enabled_ = false; |
alessiob | 3ec96df | 2017-05-22 06:57:06 -0700 | [diff] [blame] | 238 | bool gain_controller2_enabled_ = false; |
Per Åhgren | db5d728 | 2021-03-15 16:31:04 +0000 | [diff] [blame] | 239 | bool gain_adjustment_enabled_ = false; |
Gustaf Ullberg | ce045ac | 2017-10-16 13:49:04 +0200 | [diff] [blame] | 240 | bool echo_controller_enabled_ = false; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 241 | bool transient_suppressor_enabled_ = false; |
| 242 | bool first_update_ = true; |
| 243 | }; |
| 244 | |
Sam Zackrisson | 12e319a | 2020-01-03 14:54:20 +0100 | [diff] [blame] | 245 | // 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. |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 251 | int MaybeInitializeRender(const ProcessingConfig& processing_config) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 252 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
Sam Zackrisson | 12e319a | 2020-01-03 14:54:20 +0100 | [diff] [blame] | 253 | // 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); |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 257 | |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 258 | // Method for updating the state keeping track of the active submodules. |
| 259 | // Returns a bool indicating whether the state has changed. |
danilchap | 56359be | 2017-09-07 07:53:45 -0700 | [diff] [blame] | 260 | bool UpdateActiveSubmoduleStates() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 261 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 262 | |
Per Åhgren | c073471 | 2020-01-02 15:15:36 +0100 | [diff] [blame] | 263 | // Methods requiring APM running in a single-threaded manner, requiring both |
| 264 | // the render and capture lock to be acquired. |
Michael Graczyk | 86c6d33 | 2015-07-23 11:41:39 -0700 | [diff] [blame] | 265 | int InitializeLocked(const ProcessingConfig& config) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 266 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_); |
ivoc | 9f4a4a0 | 2016-10-28 05:39:16 -0700 | [diff] [blame] | 267 | void InitializeResidualEchoDetector() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 268 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_); |
Per Åhgren | f204faf | 2019-04-25 15:18:06 +0200 | [diff] [blame] | 269 | void InitializeEchoController() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 270 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_); |
Per Åhgren | c073471 | 2020-01-02 15:15:36 +0100 | [diff] [blame] | 271 | |
Alessio Bazzica | 3890104 | 2021-10-14 12:14:21 +0200 | [diff] [blame] | 272 | // Initializations of capture-only sub-modules, requiring the capture lock |
Per Åhgren | c073471 | 2020-01-02 15:15:36 +0100 | [diff] [blame] | 273 | // already acquired. |
Per Åhgren | 0f14db2 | 2020-01-03 14:27:14 +0100 | [diff] [blame] | 274 | void InitializeHighPassFilter(bool forced_reset) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 275 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 276 | void InitializeGainController1() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Per Åhgren | c073471 | 2020-01-02 15:15:36 +0100 | [diff] [blame] | 277 | void InitializeTransientSuppressor() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 278 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Alessio Bazzica | 3890104 | 2021-10-14 12:14:21 +0200 | [diff] [blame] | 279 | // 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 Silen | 0c1ad29 | 2022-06-16 16:35:45 +0200 | [diff] [blame] | 283 | // 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 Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 288 | void InitializeNoiseSuppressor() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Per Åhgren | db5d728 | 2021-03-15 16:31:04 +0000 | [diff] [blame] | 289 | void InitializeCaptureLevelsAdjuster() |
| 290 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 291 | void InitializePostProcessor() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
| 292 | void InitializeAnalyzer() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Per Åhgren | c073471 | 2020-01-02 15:15:36 +0100 | [diff] [blame] | 293 | |
| 294 | // Initializations of render-only submodules, requiring the render lock |
| 295 | // already acquired. |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 296 | void InitializePreProcessor() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 297 | |
Gustaf Ullberg | 422b9e0 | 2019-10-09 13:02:14 +0200 | [diff] [blame] | 298 | // Sample rate used for the fullband processing. |
| 299 | int proc_fullband_sample_rate_hz() const |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 300 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
Gustaf Ullberg | 422b9e0 | 2019-10-09 13:02:14 +0200 | [diff] [blame] | 301 | |
Alex Loiko | 73ec019 | 2018-05-15 10:52:28 +0200 | [diff] [blame] | 302 | // Empties and handles the respective RuntimeSetting queues. |
| 303 | void HandleCaptureRuntimeSettings() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 304 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
| 305 | void HandleRenderRuntimeSettings() |
| 306 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
Sam Zackrisson | f0d1c03 | 2019-03-27 13:28:08 +0100 | [diff] [blame] | 307 | |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 308 | void EmptyQueuedRenderAudio() RTC_LOCKS_EXCLUDED(mutex_capture_); |
Markus Handell | 02ba1d2 | 2020-05-14 14:31:18 +0200 | [diff] [blame] | 309 | void EmptyQueuedRenderAudioLocked() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 310 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
peah | 764e364 | 2016-10-22 05:04:30 -0700 | [diff] [blame] | 311 | void AllocateRenderQueue() |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 312 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_, mutex_capture_); |
peah | 9e6a290 | 2017-05-15 07:19:21 -0700 | [diff] [blame] | 313 | void QueueBandedRenderAudio(AudioBuffer* audio) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 314 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
peah | 9e6a290 | 2017-05-15 07:19:21 -0700 | [diff] [blame] | 315 | void QueueNonbandedRenderAudio(AudioBuffer* audio) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 316 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
peah | 764e364 | 2016-10-22 05:04:30 -0700 | [diff] [blame] | 317 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 318 | // Capture-side exclusive methods possibly running APM in a multi-threaded |
| 319 | // manner that are called with the render lock already acquired. |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 320 | int ProcessCaptureStreamLocked() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 321 | |
| 322 | // Render-side exclusive methods possibly running APM in a multi-threaded |
| 323 | // manner that are called with the render lock already acquired. |
ekmeyerson | 60d9b33 | 2015-08-14 10:35:55 -0700 | [diff] [blame] | 324 | // TODO(ekm): Remove once all clients updated to new interface. |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 325 | int AnalyzeReverseStreamLocked(const float* const* src, |
| 326 | const StreamConfig& input_config, |
| 327 | const StreamConfig& output_config) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 328 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
| 329 | int ProcessRenderStreamLocked() RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_render_); |
andrew@webrtc.org | 17e4064 | 2014-03-04 20:58:13 +0000 | [diff] [blame] | 330 | |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 331 | // Collects configuration settings from public and private |
| 332 | // submodules to be saved as an audioproc::Config message on the |
Artem Titov | 0b48930 | 2021-07-28 20:50:03 +0200 | [diff] [blame] | 333 | // 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`, |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 335 | // writes the config regardless of the last saved. |
| 336 | void WriteAecDumpConfigMessage(bool forced) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 337 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 338 | |
| 339 | // Notifies attached AecDump of current configuration and capture data. |
| 340 | void RecordUnprocessedCaptureStream(const float* const* capture_stream) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 341 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 342 | |
Per Åhgren | 645f24c | 2020-03-16 12:06:02 +0100 | [diff] [blame] | 343 | void RecordUnprocessedCaptureStream(const int16_t* const data, |
| 344 | const StreamConfig& config) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 345 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 346 | |
| 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 Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 352 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 353 | |
Per Åhgren | 645f24c | 2020-03-16 12:06:02 +0100 | [diff] [blame] | 354 | void RecordProcessedCaptureStream(const int16_t* const data, |
| 355 | const StreamConfig& config) |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 356 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 357 | |
| 358 | // Notifies attached AecDump about current state (delay, drift, etc). |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 359 | void RecordAudioProcessingState() |
| 360 | RTC_EXCLUSIVE_LOCKS_REQUIRED(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 361 | |
Per Åhgren | 652ada5 | 2021-03-03 10:52:44 +0000 | [diff] [blame] | 362 | // 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 | |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 368 | // 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 Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 374 | InternalAPMConfig apm_config_for_aec_dump_ RTC_GUARDED_BY(mutex_capture_); |
aleloi | 868f32f | 2017-05-23 07:20:05 -0700 | [diff] [blame] | 375 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 376 | // Critical sections. |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 377 | mutable Mutex mutex_render_ RTC_ACQUIRED_BEFORE(mutex_capture_); |
| 378 | mutable Mutex mutex_capture_; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 379 | |
peah | c19f312 | 2016-10-07 14:54:10 -0700 | [diff] [blame] | 380 | // Struct containing the Config specifying the behavior of APM. |
| 381 | AudioProcessing::Config config_; |
| 382 | |
Sam Zackrisson | b37e59d | 2020-04-27 08:39:33 +0200 | [diff] [blame] | 383 | // Overrides for testing the exclusion of some submodules from the build. |
| 384 | ApmSubmoduleCreationOverrides submodule_creation_overrides_ |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 385 | RTC_GUARDED_BY(mutex_capture_); |
Sam Zackrisson | b37e59d | 2020-04-27 08:39:33 +0200 | [diff] [blame] | 386 | |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 387 | // Class containing information about what submodules are active. |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 388 | SubmoduleStates submodule_states_; |
peah | 2ace3f9 | 2016-09-10 04:42:27 -0700 | [diff] [blame] | 389 | |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 390 | // 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 Åhgren | 3daedb6 | 2019-11-22 12:11:40 +0100 | [diff] [blame] | 395 | std::unique_ptr<CustomAudioAnalyzer> capture_analyzer) |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 396 | : 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 Åhgren | 3daedb6 | 2019-11-22 12:11:40 +0100 | [diff] [blame] | 399 | capture_analyzer(std::move(capture_analyzer)) {} |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 400 | // Accessed internally from capture or during initialization. |
Sam Zackrisson | 03cb7e5 | 2021-12-06 15:40:04 +0100 | [diff] [blame] | 401 | 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; |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 405 | std::unique_ptr<AgcManagerDirect> agc_manager; |
| 406 | std::unique_ptr<GainControlImpl> gain_control; |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 407 | std::unique_ptr<GainController2> gain_controller2; |
Hanna Silen | 0c1ad29 | 2022-06-16 16:35:45 +0200 | [diff] [blame] | 408 | std::unique_ptr<VoiceActivityDetectorWrapper> voice_activity_detector; |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 409 | std::unique_ptr<HighPassFilter> high_pass_filter; |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 410 | std::unique_ptr<EchoControl> echo_controller; |
| 411 | std::unique_ptr<EchoControlMobileImpl> echo_control_mobile; |
Per Åhgren | 0cbb58e | 2019-10-29 22:59:44 +0100 | [diff] [blame] | 412 | std::unique_ptr<NoiseSuppressor> noise_suppressor; |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 413 | std::unique_ptr<TransientSuppressor> transient_suppressor; |
Per Åhgren | db5d728 | 2021-03-15 16:31:04 +0000 | [diff] [blame] | 414 | std::unique_ptr<CaptureLevelsAdjuster> capture_levels_adjuster; |
saza | 1d60052 | 2019-10-18 13:29:43 +0200 | [diff] [blame] | 415 | } submodules_; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 416 | |
peah | 192164e | 2015-11-17 02:16:45 -0800 | [diff] [blame] | 417 | // State that is written to while holding both the render and capture locks |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 418 | // 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() |
peah | 192164e | 2015-11-17 02:16:45 -0800 | [diff] [blame] | 424 | : // Format of processing streams at input/output call sites. |
Henrik Lundin | 64253a9 | 2022-02-04 09:02:48 +0000 | [diff] [blame] | 425 | api_format({{{kSampleRate16kHz, 1}, |
| 426 | {kSampleRate16kHz, 1}, |
| 427 | {kSampleRate16kHz, 1}, |
| 428 | {kSampleRate16kHz, 1}}}), |
peah | de65ddc | 2016-09-16 15:02:15 -0700 | [diff] [blame] | 429 | render_processing_format(kSampleRate16kHz, 1) {} |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 430 | ProcessingConfig api_format; |
peah | de65ddc | 2016-09-16 15:02:15 -0700 | [diff] [blame] | 431 | StreamConfig render_processing_format; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 432 | } formats_; |
Michael Graczyk | 86c6d33 | 2015-07-23 11:41:39 -0700 | [diff] [blame] | 433 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 434 | // APM constants. |
| 435 | const struct ApmConstants { |
Per Åhgren | 0695df1 | 2020-01-13 14:43:13 +0100 | [diff] [blame] | 436 | ApmConstants(bool multi_channel_render_support, |
Per Åhgren | c042425 | 2019-12-10 13:04:15 +0100 | [diff] [blame] | 437 | bool multi_channel_capture_support, |
Per Åhgren | 19775cb | 2021-03-12 23:08:09 +0000 | [diff] [blame] | 438 | bool enforce_split_band_hpf, |
Gustaf Ullberg | a399c82 | 2021-05-18 12:17:56 +0200 | [diff] [blame] | 439 | bool minimize_processing_for_unused_output, |
| 440 | bool transient_suppressor_forced_off) |
Per Åhgren | 0695df1 | 2020-01-13 14:43:13 +0100 | [diff] [blame] | 441 | : multi_channel_render_support(multi_channel_render_support), |
Per Åhgren | c042425 | 2019-12-10 13:04:15 +0100 | [diff] [blame] | 442 | multi_channel_capture_support(multi_channel_capture_support), |
Per Åhgren | 19775cb | 2021-03-12 23:08:09 +0000 | [diff] [blame] | 443 | enforce_split_band_hpf(enforce_split_band_hpf), |
| 444 | minimize_processing_for_unused_output( |
Gustaf Ullberg | a399c82 | 2021-05-18 12:17:56 +0200 | [diff] [blame] | 445 | minimize_processing_for_unused_output), |
| 446 | transient_suppressor_forced_off(transient_suppressor_forced_off) {} |
Per Åhgren | e14cb99 | 2019-11-27 09:34:22 +0100 | [diff] [blame] | 447 | bool multi_channel_render_support; |
| 448 | bool multi_channel_capture_support; |
Per Åhgren | c042425 | 2019-12-10 13:04:15 +0100 | [diff] [blame] | 449 | bool enforce_split_band_hpf; |
Per Åhgren | 19775cb | 2021-03-12 23:08:09 +0000 | [diff] [blame] | 450 | bool minimize_processing_for_unused_output; |
Gustaf Ullberg | a399c82 | 2021-05-18 12:17:56 +0200 | [diff] [blame] | 451 | bool transient_suppressor_forced_off; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 452 | } constants_; |
andrew@webrtc.org | ddbb8a2 | 2014-04-22 21:00:04 +0000 | [diff] [blame] | 453 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 454 | struct ApmCaptureState { |
Per Åhgren | c073471 | 2020-01-02 15:15:36 +0100 | [diff] [blame] | 455 | ApmCaptureState(); |
kwiberg | 83ffe45 | 2016-08-29 14:46:07 -0700 | [diff] [blame] | 456 | ~ApmCaptureState(); |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 457 | bool was_stream_delay_set; |
Per Åhgren | 0a144a7 | 2021-02-09 08:47:51 +0100 | [diff] [blame] | 458 | bool capture_output_used; |
Per Åhgren | 55bc077 | 2021-03-12 14:18:36 +0000 | [diff] [blame] | 459 | bool capture_output_used_last_frame; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 460 | bool key_pressed; |
kwiberg | 88788ad | 2016-02-19 07:04:49 -0800 | [diff] [blame] | 461 | std::unique_ptr<AudioBuffer> capture_audio; |
Gustaf Ullberg | 422b9e0 | 2019-10-09 13:02:14 +0200 | [diff] [blame] | 462 | std::unique_ptr<AudioBuffer> capture_fullband_audio; |
Per Åhgren | c20a19c | 2019-11-13 11:12:29 +0100 | [diff] [blame] | 463 | std::unique_ptr<AudioBuffer> linear_aec_output; |
peah | de65ddc | 2016-09-16 15:02:15 -0700 | [diff] [blame] | 464 | // 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; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 468 | int split_rate; |
peah | 6799553 | 2017-04-10 14:12:41 -0700 | [diff] [blame] | 469 | bool echo_path_gain_change; |
Per Åhgren | db5d728 | 2021-03-15 16:31:04 +0000 | [diff] [blame] | 470 | float prev_pre_adjustment_gain; |
Fredrik Hernqvist | ca36285 | 2019-05-10 15:50:02 +0200 | [diff] [blame] | 471 | int playout_volume; |
| 472 | int prev_playout_volume; |
Sam Zackrisson | b24c00f | 2018-11-26 16:18:25 +0100 | [diff] [blame] | 473 | AudioProcessingStats stats; |
Alessio Bazzica | fcf1af3 | 2022-09-07 17:14:26 +0200 | [diff] [blame] | 474 | // 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 Bazzica | 533e461 | 2022-09-07 16:58:33 +0200 | [diff] [blame] | 478 | // 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 Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 482 | } capture_ RTC_GUARDED_BY(mutex_capture_); |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 483 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 484 | struct ApmCaptureNonLockedState { |
Alessio Bazzica | cc22f51 | 2018-08-30 13:01:34 +0200 | [diff] [blame] | 485 | ApmCaptureNonLockedState() |
peah | de65ddc | 2016-09-16 15:02:15 -0700 | [diff] [blame] | 486 | : capture_processing_format(kSampleRate16kHz), |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 487 | split_rate(kSampleRate16kHz), |
Alessio Bazzica | cc22f51 | 2018-08-30 13:01:34 +0200 | [diff] [blame] | 488 | stream_delay_ms(0) {} |
peah | de65ddc | 2016-09-16 15:02:15 -0700 | [diff] [blame] | 489 | // 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; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 493 | int split_rate; |
| 494 | int stream_delay_ms; |
Gustaf Ullberg | ce045ac | 2017-10-16 13:49:04 +0200 | [diff] [blame] | 495 | bool echo_controller_enabled = false; |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 496 | } capture_nonlocked_; |
andrew@webrtc.org | 75dd288 | 2014-02-11 20:52:30 +0000 | [diff] [blame] | 497 | |
peah | df3efa8 | 2015-11-28 12:35:15 -0800 | [diff] [blame] | 498 | struct ApmRenderState { |
kwiberg | 83ffe45 | 2016-08-29 14:46:07 -0700 | [diff] [blame] | 499 | ApmRenderState(); |
| 500 | ~ApmRenderState(); |
kwiberg | 88788ad | 2016-02-19 07:04:49 -0800 | [diff] [blame] | 501 | std::unique_ptr<AudioConverter> render_converter; |
| 502 | std::unique_ptr<AudioBuffer> render_audio; |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 503 | } render_ RTC_GUARDED_BY(mutex_render_); |
peah | 764e364 | 2016-10-22 05:04:30 -0700 | [diff] [blame] | 504 | |
Per Åhgren | cf4c872 | 2019-12-30 14:32:14 +0100 | [diff] [blame] | 505 | // 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 Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 519 | Mutex mutex_stats_; |
| 520 | AudioProcessingStats cached_stats_ RTC_GUARDED_BY(mutex_stats_); |
Per Åhgren | cf4c872 | 2019-12-30 14:32:14 +0100 | [diff] [blame] | 521 | SwapQueue<AudioProcessingStats> stats_message_queue_; |
| 522 | } stats_reporter_; |
| 523 | |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 524 | 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_); |
peah | 701d628 | 2016-10-25 05:42:20 -0700 | [diff] [blame] | 527 | |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 528 | 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_); |
peah | 764e364 | 2016-10-22 05:04:30 -0700 | [diff] [blame] | 532 | |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 533 | 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_); |
ivoc | 9f4a4a0 | 2016-10-28 05:39:16 -0700 | [diff] [blame] | 537 | |
Markus Handell | 0df0fae | 2020-07-07 15:53:34 +0200 | [diff] [blame] | 538 | 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.lundin | 290d43a | 2016-11-29 08:09:09 -0800 | [diff] [blame] | 541 | |
Alessio Bazzica | c34a8c1 | 2022-10-26 13:30:25 +0000 | [diff] [blame] | 542 | InputVolumeStatsReporter applied_input_volume_stats_reporter_ |
Hanna Silen | 529131d | 2021-10-29 14:55:45 +0200 | [diff] [blame] | 543 | RTC_GUARDED_BY(mutex_capture_); |
Alessio Bazzica | fbe5d7c | 2022-10-27 00:05:32 +0200 | [diff] [blame^] | 544 | InputVolumeStatsReporter recommended_input_volume_stats_reporter_ |
| 545 | RTC_GUARDED_BY(mutex_capture_); |
Hanna Silen | 529131d | 2021-10-29 14:55:45 +0200 | [diff] [blame] | 546 | |
peah | 764e364 | 2016-10-22 05:04:30 -0700 | [diff] [blame] | 547 | // Lock protection not needed. |
peah | a062460 | 2016-10-25 04:45:24 -0700 | [diff] [blame] | 548 | std::unique_ptr< |
| 549 | SwapQueue<std::vector<int16_t>, RenderQueueItemVerifier<int16_t>>> |
peah | 701d628 | 2016-10-25 05:42:20 -0700 | [diff] [blame] | 550 | aecm_render_signal_queue_; |
| 551 | std::unique_ptr< |
| 552 | SwapQueue<std::vector<int16_t>, RenderQueueItemVerifier<int16_t>>> |
| 553 | agc_render_signal_queue_; |
ivoc | 9f4a4a0 | 2016-10-28 05:39:16 -0700 | [diff] [blame] | 554 | std::unique_ptr<SwapQueue<std::vector<float>, RenderQueueItemVerifier<float>>> |
| 555 | red_render_signal_queue_; |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 556 | }; |
andrew@webrtc.org | ddbb8a2 | 2014-04-22 21:00:04 +0000 | [diff] [blame] | 557 | |
niklase@google.com | 470e71d | 2011-07-07 08:21:25 +0000 | [diff] [blame] | 558 | } // namespace webrtc |
| 559 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 560 | #endif // MODULES_AUDIO_PROCESSING_AUDIO_PROCESSING_IMPL_H_ |