2019-06-04 10:14:50 +00:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2018 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_ECHO_AUDIBILITY_H_
|
|
|
|
#define MODULES_AUDIO_PROCESSING_AEC3_ECHO_AUDIBILITY_H_
|
|
|
|
|
|
|
|
#include <stddef.h>
|
|
|
|
|
|
|
|
#include "absl/types/optional.h"
|
|
|
|
#include "api/array_view.h"
|
2020-08-14 16:58:22 +00:00
|
|
|
#include "modules/audio_processing/aec3/block_buffer.h"
|
2019-06-04 10:14:50 +00:00
|
|
|
#include "modules/audio_processing/aec3/render_buffer.h"
|
2020-08-14 16:58:22 +00:00
|
|
|
#include "modules/audio_processing/aec3/spectrum_buffer.h"
|
2019-06-04 10:14:50 +00:00
|
|
|
#include "modules/audio_processing/aec3/stationarity_estimator.h"
|
2020-08-14 16:58:22 +00:00
|
|
|
#include "rtc_base/constructor_magic.h"
|
2019-06-04 10:14:50 +00:00
|
|
|
|
|
|
|
namespace webrtc {
|
|
|
|
|
|
|
|
class EchoAudibility {
|
|
|
|
public:
|
|
|
|
explicit EchoAudibility(bool use_render_stationarity_at_init);
|
|
|
|
~EchoAudibility();
|
|
|
|
|
2020-08-14 16:58:22 +00:00
|
|
|
EchoAudibility(const EchoAudibility&) = delete;
|
|
|
|
EchoAudibility& operator=(const EchoAudibility&) = delete;
|
|
|
|
|
2019-06-04 10:14:50 +00:00
|
|
|
// Feed new render data to the echo audibility estimator.
|
|
|
|
void Update(const RenderBuffer& render_buffer,
|
2020-08-14 16:58:22 +00:00
|
|
|
rtc::ArrayView<const float> average_reverb,
|
|
|
|
int min_channel_delay_blocks,
|
2019-06-04 10:14:50 +00:00
|
|
|
bool external_delay_seen);
|
|
|
|
// Get the residual echo scaling.
|
|
|
|
void GetResidualEchoScaling(bool filter_has_had_time_to_converge,
|
|
|
|
rtc::ArrayView<float> residual_scaling) const {
|
|
|
|
for (size_t band = 0; band < residual_scaling.size(); ++band) {
|
|
|
|
if (render_stationarity_.IsBandStationary(band) &&
|
2020-08-14 16:58:22 +00:00
|
|
|
(filter_has_had_time_to_converge ||
|
|
|
|
use_render_stationarity_at_init_)) {
|
2019-06-04 10:14:50 +00:00
|
|
|
residual_scaling[band] = 0.f;
|
|
|
|
} else {
|
|
|
|
residual_scaling[band] = 1.0f;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Returns true if the current render block is estimated as stationary.
|
|
|
|
bool IsBlockStationary() const {
|
|
|
|
return render_stationarity_.IsBlockStationary();
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
// Reset the EchoAudibility class.
|
|
|
|
void Reset();
|
|
|
|
|
|
|
|
// Updates the render stationarity flags for the current frame.
|
2020-08-14 16:58:22 +00:00
|
|
|
void UpdateRenderStationarityFlags(const RenderBuffer& render_buffer,
|
|
|
|
rtc::ArrayView<const float> average_reverb,
|
|
|
|
int delay_blocks);
|
2019-06-04 10:14:50 +00:00
|
|
|
|
|
|
|
// Updates the noise estimator with the new render data since the previous
|
|
|
|
// call to this method.
|
2020-08-14 16:58:22 +00:00
|
|
|
void UpdateRenderNoiseEstimator(const SpectrumBuffer& spectrum_buffer,
|
|
|
|
const BlockBuffer& block_buffer,
|
2019-06-04 10:14:50 +00:00
|
|
|
bool external_delay_seen);
|
|
|
|
|
|
|
|
// Returns a bool being true if the render signal contains just close to zero
|
|
|
|
// values.
|
2020-08-14 16:58:22 +00:00
|
|
|
bool IsRenderTooLow(const BlockBuffer& block_buffer);
|
2019-06-04 10:14:50 +00:00
|
|
|
|
|
|
|
absl::optional<int> render_spectrum_write_prev_;
|
|
|
|
int render_block_write_prev_;
|
|
|
|
bool non_zero_render_seen_;
|
|
|
|
const bool use_render_stationarity_at_init_;
|
|
|
|
StationarityEstimator render_stationarity_;
|
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace webrtc
|
|
|
|
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AEC3_ECHO_AUDIBILITY_H_
|