The dominant nearend detector uses the residual echo spectrum for determining whether in nearend state. The residual echo spectrum in computed using the ERLE. To reduce the risk of echo leaks in the suppressor, the ERLE is capped. While minimizing echo leaks, the capping of the ERLE can affect the dominant nearend classification negatively as the residual echo spectrum is often over estimated. This change enables the dominant nearend detector to use a residual echo spectrum computed with a virtually non-capped ERLE. This ERLE is only used for dominant nearend detection and leads to increased transparency. The feature is currently disabled by default and can be enabled with the field trial "WebRTC-Aec3UseUnboundedEchoSpectrum". Bug: webrtc:12870 Change-Id: Icb675c6f5d42ab9286e623b5fb38424d5c9cbee4 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/221920 Reviewed-by: Jesus de Vicente Pena <devicentepena@webrtc.org> Commit-Queue: Gustaf Ullberg <gustaf@webrtc.org> Cr-Commit-Position: refs/heads/master@{#34270}
85 lines
3.0 KiB
C++
85 lines
3.0 KiB
C++
/*
|
|
* Copyright (c) 2017 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef MODULES_AUDIO_PROCESSING_AEC3_RESIDUAL_ECHO_ESTIMATOR_H_
|
|
#define MODULES_AUDIO_PROCESSING_AEC3_RESIDUAL_ECHO_ESTIMATOR_H_
|
|
|
|
#include <array>
|
|
#include <memory>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/audio/echo_canceller3_config.h"
|
|
#include "modules/audio_processing/aec3/aec3_common.h"
|
|
#include "modules/audio_processing/aec3/aec_state.h"
|
|
#include "modules/audio_processing/aec3/render_buffer.h"
|
|
#include "modules/audio_processing/aec3/reverb_model.h"
|
|
#include "modules/audio_processing/aec3/spectrum_buffer.h"
|
|
#include "rtc_base/checks.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class ResidualEchoEstimator {
|
|
public:
|
|
ResidualEchoEstimator(const EchoCanceller3Config& config,
|
|
size_t num_render_channels);
|
|
~ResidualEchoEstimator();
|
|
|
|
ResidualEchoEstimator(const ResidualEchoEstimator&) = delete;
|
|
ResidualEchoEstimator& operator=(const ResidualEchoEstimator&) = delete;
|
|
|
|
void Estimate(
|
|
const AecState& aec_state,
|
|
const RenderBuffer& render_buffer,
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>> S2_linear,
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>> Y2,
|
|
bool dominant_nearend,
|
|
rtc::ArrayView<std::array<float, kFftLengthBy2Plus1>> R2,
|
|
rtc::ArrayView<std::array<float, kFftLengthBy2Plus1>> R2_unbounded);
|
|
|
|
private:
|
|
enum class ReverbType { kLinear, kNonLinear };
|
|
|
|
// Resets the state.
|
|
void Reset();
|
|
|
|
// Updates estimate for the power of the stationary noise component in the
|
|
// render signal.
|
|
void UpdateRenderNoisePower(const RenderBuffer& render_buffer);
|
|
|
|
// Updates the reverb estimation.
|
|
void UpdateReverb(ReverbType reverb_type,
|
|
const AecState& aec_state,
|
|
const RenderBuffer& render_buffer);
|
|
|
|
// Adds the estimated unmodelled echo power to the residual echo power
|
|
// estimate.
|
|
void AddReverb(
|
|
rtc::ArrayView<std::array<float, kFftLengthBy2Plus1>> R2) const;
|
|
|
|
// Gets the echo path gain to apply.
|
|
float GetEchoPathGain(const AecState& aec_state,
|
|
bool gain_for_early_reflections) const;
|
|
|
|
const EchoCanceller3Config config_;
|
|
const size_t num_render_channels_;
|
|
const float early_reflections_transparent_mode_gain_;
|
|
const float late_reflections_transparent_mode_gain_;
|
|
const float early_reflections_general_gain_;
|
|
const float late_reflections_general_gain_;
|
|
const bool erle_onset_compensation_in_dominant_nearend_;
|
|
std::array<float, kFftLengthBy2Plus1> X2_noise_floor_;
|
|
std::array<int, kFftLengthBy2Plus1> X2_noise_floor_counter_;
|
|
ReverbModel echo_reverb_;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AEC3_RESIDUAL_ECHO_ESTIMATOR_H_
|