mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-17 07:37:51 +01:00
777cf26328
This change introduces a clockdrift detector operating on the estimated delay of the echo path delay estimator. Each time the delay estimate changes it is compared to previous estimates. If the estimates are slowly increasing or decreasing, clockdrift is detected. Four different patterns are considered clockdrift: - k, k+1, k+2, k+3 - k, k+2, k+1, k+3 - k, k-1, k-2, k-3 - k, k-2, k-1, k-3 A delay estimate history matching the three last elements in one of the patterns is considered probable clockdrift. Matching all four elements is considered verified clockdrift. If the delay is constant for some time after clockdrift is detected the clockdrift detector will revert to no detected clockdrift. The level of clockdrift is reported via an UMA histogram. Bug: webrtc:10014 Change-Id: I1cce4d593e101a8b3fa99df6935e59b4243cb97a Reviewed-on: https://webrtc-review.googlesource.com/c/111381 Commit-Queue: Gustaf Ullberg <gustaf@webrtc.org> Reviewed-by: Per Åhgren <peah@webrtc.org> Cr-Commit-Position: refs/heads/master@{#25758}
76 lines
2.7 KiB
C++
76 lines
2.7 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_ECHO_PATH_DELAY_ESTIMATOR_H_
|
|
#define MODULES_AUDIO_PROCESSING_AEC3_ECHO_PATH_DELAY_ESTIMATOR_H_
|
|
|
|
#include <stddef.h>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/array_view.h"
|
|
#include "modules/audio_processing/aec3/clockdrift_detector.h"
|
|
#include "modules/audio_processing/aec3/decimator.h"
|
|
#include "modules/audio_processing/aec3/delay_estimate.h"
|
|
#include "modules/audio_processing/aec3/matched_filter.h"
|
|
#include "modules/audio_processing/aec3/matched_filter_lag_aggregator.h"
|
|
#include "rtc_base/constructormagic.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class ApmDataDumper;
|
|
struct DownsampledRenderBuffer;
|
|
struct EchoCanceller3Config;
|
|
|
|
// Estimates the delay of the echo path.
|
|
class EchoPathDelayEstimator {
|
|
public:
|
|
EchoPathDelayEstimator(ApmDataDumper* data_dumper,
|
|
const EchoCanceller3Config& config);
|
|
~EchoPathDelayEstimator();
|
|
|
|
// Resets the estimation. If the delay confidence is reset, the reset behavior
|
|
// is as if the call is restarted.
|
|
void Reset(bool reset_delay_confidence);
|
|
|
|
// Produce a delay estimate if such is avaliable.
|
|
absl::optional<DelayEstimate> EstimateDelay(
|
|
const DownsampledRenderBuffer& render_buffer,
|
|
rtc::ArrayView<const float> capture);
|
|
|
|
// Log delay estimator properties.
|
|
void LogDelayEstimationProperties(int sample_rate_hz, size_t shift) const {
|
|
matched_filter_.LogFilterProperties(sample_rate_hz, shift,
|
|
down_sampling_factor_);
|
|
}
|
|
|
|
// Returns the level of detected clockdrift.
|
|
ClockdriftDetector::Level Clockdrift() const {
|
|
return clockdrift_detector_.ClockdriftLevel();
|
|
}
|
|
|
|
private:
|
|
ApmDataDumper* const data_dumper_;
|
|
const size_t down_sampling_factor_;
|
|
const size_t sub_block_size_;
|
|
Decimator capture_decimator_;
|
|
MatchedFilter matched_filter_;
|
|
MatchedFilterLagAggregator matched_filter_lag_aggregator_;
|
|
absl::optional<DelayEstimate> old_aggregated_lag_;
|
|
size_t consistent_estimate_counter_ = 0;
|
|
ClockdriftDetector clockdrift_detector_;
|
|
|
|
// Internal reset method with more granularity.
|
|
void Reset(bool reset_lag_aggregator, bool reset_delay_confidence);
|
|
|
|
RTC_DISALLOW_COPY_AND_ASSIGN(EchoPathDelayEstimator);
|
|
};
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AEC3_ECHO_PATH_DELAY_ESTIMATOR_H_
|