1 /* 2 * Copyright (c) 2017 The WebRTC project authors. All Rights Reserved. 3 * 4 * Use of this source code is governed by a BSD-style license 5 * that can be found in the LICENSE file in the root of the source 6 * tree. An additional intellectual property rights grant can be found 7 * in the file PATENTS. All contributing project authors may 8 * be found in the AUTHORS file in the root of the source tree. 9 */ 10 11 #ifndef MODULES_AUDIO_PROCESSING_AEC3_RENDER_SIGNAL_ANALYZER_H_ 12 #define MODULES_AUDIO_PROCESSING_AEC3_RENDER_SIGNAL_ANALYZER_H_ 13 14 #include <algorithm> 15 #include <array> 16 #include <cstddef> 17 18 #include "absl/types/optional.h" 19 #include "api/audio/echo_canceller3_config.h" 20 #include "modules/audio_processing/aec3/aec3_common.h" 21 #include "modules/audio_processing/aec3/render_buffer.h" 22 #include "rtc_base/checks.h" 23 24 namespace webrtc { 25 26 // Provides functionality for analyzing the properties of the render signal. 27 class RenderSignalAnalyzer { 28 public: 29 explicit RenderSignalAnalyzer(const EchoCanceller3Config& config); 30 ~RenderSignalAnalyzer(); 31 32 RenderSignalAnalyzer(const RenderSignalAnalyzer&) = delete; 33 RenderSignalAnalyzer& operator=(const RenderSignalAnalyzer&) = delete; 34 35 // Updates the render signal analysis with the most recent render signal. 36 void Update(const RenderBuffer& render_buffer, 37 const absl::optional<size_t>& delay_partitions); 38 39 // Returns true if the render signal is poorly exciting. PoorSignalExcitation()40 bool PoorSignalExcitation() const { 41 RTC_DCHECK_LT(2, narrow_band_counters_.size()); 42 return std::any_of(narrow_band_counters_.begin(), 43 narrow_band_counters_.end(), 44 [](size_t a) { return a > 10; }); 45 } 46 47 // Zeros the array around regions with narrow bands signal characteristics. 48 void MaskRegionsAroundNarrowBands( 49 std::array<float, kFftLengthBy2Plus1>* v) const; 50 NarrowPeakBand()51 absl::optional<int> NarrowPeakBand() const { return narrow_peak_band_; } 52 53 private: 54 const int strong_peak_freeze_duration_; 55 std::array<size_t, kFftLengthBy2 - 1> narrow_band_counters_; 56 absl::optional<int> narrow_peak_band_; 57 size_t narrow_peak_counter_; 58 }; 59 60 } // namespace webrtc 61 62 #endif // MODULES_AUDIO_PROCESSING_AEC3_RENDER_SIGNAL_ANALYZER_H_ 63