mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 06:10:40 +01:00
a63d152423
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}
112 lines
4.2 KiB
C++
112 lines
4.2 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_ERLE_ESTIMATOR_H_
|
|
#define MODULES_AUDIO_PROCESSING_AEC3_ERLE_ESTIMATOR_H_
|
|
|
|
#include <stddef.h>
|
|
|
|
#include <array>
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/array_view.h"
|
|
#include "api/audio/echo_canceller3_config.h"
|
|
#include "modules/audio_processing/aec3/aec3_common.h"
|
|
#include "modules/audio_processing/aec3/fullband_erle_estimator.h"
|
|
#include "modules/audio_processing/aec3/render_buffer.h"
|
|
#include "modules/audio_processing/aec3/signal_dependent_erle_estimator.h"
|
|
#include "modules/audio_processing/aec3/subband_erle_estimator.h"
|
|
#include "modules/audio_processing/logging/apm_data_dumper.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// Estimates the echo return loss enhancement. One estimate is done per subband
|
|
// and another one is done using the aggreation of energy over all the subbands.
|
|
class ErleEstimator {
|
|
public:
|
|
ErleEstimator(size_t startup_phase_length_blocks,
|
|
const EchoCanceller3Config& config,
|
|
size_t num_capture_channels);
|
|
~ErleEstimator();
|
|
|
|
// Resets the fullband ERLE estimator and the subbands ERLE estimators.
|
|
void Reset(bool delay_change);
|
|
|
|
// Updates the ERLE estimates.
|
|
void Update(
|
|
const RenderBuffer& render_buffer,
|
|
rtc::ArrayView<const std::vector<std::array<float, kFftLengthBy2Plus1>>>
|
|
filter_frequency_responses,
|
|
rtc::ArrayView<const float, kFftLengthBy2Plus1>
|
|
avg_render_spectrum_with_reverb,
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>>
|
|
capture_spectra,
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>>
|
|
subtractor_spectra,
|
|
const std::vector<bool>& converged_filters);
|
|
|
|
// Returns the most recent subband ERLE estimates.
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>> Erle(
|
|
bool onset_compensated) const {
|
|
return signal_dependent_erle_estimator_
|
|
? signal_dependent_erle_estimator_->Erle(onset_compensated)
|
|
: subband_erle_estimator_.Erle(onset_compensated);
|
|
}
|
|
|
|
// Returns the non-capped subband ERLE.
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>> ErleUnbounded()
|
|
const {
|
|
// Unbounded ERLE is only used with the subband erle estimator where the
|
|
// ERLE is often capped at low values. When the signal dependent ERLE
|
|
// estimator is used the capped ERLE is returned.
|
|
return !signal_dependent_erle_estimator_
|
|
? subband_erle_estimator_.ErleUnbounded()
|
|
: signal_dependent_erle_estimator_->Erle(
|
|
/*onset_compensated=*/false);
|
|
}
|
|
|
|
// Returns the subband ERLE that are estimated during onsets (only used for
|
|
// testing).
|
|
rtc::ArrayView<const std::array<float, kFftLengthBy2Plus1>> ErleDuringOnsets()
|
|
const {
|
|
return subband_erle_estimator_.ErleDuringOnsets();
|
|
}
|
|
|
|
// Returns the fullband ERLE estimate.
|
|
float FullbandErleLog2() const {
|
|
return fullband_erle_estimator_.FullbandErleLog2();
|
|
}
|
|
|
|
// Returns an estimation of the current linear filter quality based on the
|
|
// current and past fullband ERLE estimates. The returned value is a float
|
|
// vector with content between 0 and 1 where 1 indicates that, at this current
|
|
// time instant, the linear filter is reaching its maximum subtraction
|
|
// performance.
|
|
rtc::ArrayView<const absl::optional<float>> GetInstLinearQualityEstimates()
|
|
const {
|
|
return fullband_erle_estimator_.GetInstLinearQualityEstimates();
|
|
}
|
|
|
|
void Dump(const std::unique_ptr<ApmDataDumper>& data_dumper) const;
|
|
|
|
private:
|
|
const size_t startup_phase_length_blocks_;
|
|
FullBandErleEstimator fullband_erle_estimator_;
|
|
SubbandErleEstimator subband_erle_estimator_;
|
|
std::unique_ptr<SignalDependentErleEstimator>
|
|
signal_dependent_erle_estimator_;
|
|
size_t blocks_since_reset_ = 0;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AEC3_ERLE_ESTIMATOR_H_
|