ce014d97cd
> Add an extended filter mode to AEC. > > This mode extends the filter length from the current 48 ms to 128 ms. > It is runtime selectable which allows it to be enabled through > experiment. We reuse the DelayCorrection infrastructure to avoid having > to replumb everything up to libjingle. > > Increases AEC complexity by ~50% on modern x86 CPUs. > Measurements (in percent of usage on one core): > > Machine/CPU Normal Extended > MacBook Retina (Early 2013), > Core i7 Ivy Bridge (2.7 GHz, hyperthreaded) 0.6% 0.9% > > MacBook Air (Late 2010), Core 2 Duo (2.13 GHz) 1.4% 2.7% > > Chromebook Pixel, Core i5 Ivy Bridge (1.8 GHz) 0.6% 1.0% > > Samsung ARM Chromebook, > Samsung Exynos 5 Dual (1.7 GHz) 3.2% 5.6% > > The relative value is large of course but the absolute should be > acceptable in order to have a working AEC on some platforms. > > Detailed changes to the algorithm: > - The filter length is changed from 48 to 128 ms. This comes with tuning > of several parameters: i) filter adaptation stepsize and error > threshold; ii) non-linear processing smoothing and overdrive. > - Option to ignore the reported delays on platforms which we deem > sufficiently unreliable. Currently this will be enabled in Chromium for > Mac. > - Faster startup times by removing the excessive "startup phase" > processing of reported delays. > - Much more conservative adjustments to the far-end read pointer. We > smooth the delay difference more heavily, and back off from the > difference more. Adjustments force a readaptation of the filter, so they > should be avoided except when really necessary. > > Corresponds to these changes: > https://chromereviews.googleplex.com/9412014 > https://chromereviews.googleplex.com/9514013 > https://chromereviews.googleplex.com/9960013 > > BUG=454,827,1261 > R=bjornv@webrtc.org > > Review URL: https://webrtc-codereview.appspot.com/2151007 TBR=andrew@webrtc.org Review URL: https://webrtc-codereview.appspot.com/2296005 git-svn-id: http://webrtc.googlecode.com/svn/trunk@4839 4adac7df-926f-26a2-2b94-8c16560cd09d
78 lines
2.9 KiB
C++
78 lines
2.9 KiB
C++
/*
|
|
* Copyright (c) 2012 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 WEBRTC_MODULES_AUDIO_PROCESSING_ECHO_CANCELLATION_IMPL_H_
|
|
#define WEBRTC_MODULES_AUDIO_PROCESSING_ECHO_CANCELLATION_IMPL_H_
|
|
|
|
#include "webrtc/modules/audio_processing/echo_cancellation_impl_wrapper.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class AudioProcessingImpl;
|
|
class AudioBuffer;
|
|
|
|
class EchoCancellationImpl : public EchoCancellationImplWrapper {
|
|
public:
|
|
explicit EchoCancellationImpl(const AudioProcessingImpl* apm);
|
|
virtual ~EchoCancellationImpl();
|
|
|
|
// EchoCancellationImplWrapper implementation.
|
|
virtual int ProcessRenderAudio(const AudioBuffer* audio) OVERRIDE;
|
|
virtual int ProcessCaptureAudio(AudioBuffer* audio) OVERRIDE;
|
|
|
|
// EchoCancellation implementation.
|
|
virtual bool is_enabled() const OVERRIDE;
|
|
virtual int device_sample_rate_hz() const OVERRIDE;
|
|
virtual int stream_drift_samples() const OVERRIDE;
|
|
|
|
// ProcessingComponent implementation.
|
|
virtual int Initialize() OVERRIDE;
|
|
|
|
private:
|
|
// EchoCancellation implementation.
|
|
virtual int Enable(bool enable) OVERRIDE;
|
|
virtual int enable_drift_compensation(bool enable) OVERRIDE;
|
|
virtual bool is_drift_compensation_enabled() const OVERRIDE;
|
|
virtual int set_device_sample_rate_hz(int rate) OVERRIDE;
|
|
virtual void set_stream_drift_samples(int drift) OVERRIDE;
|
|
virtual int set_suppression_level(SuppressionLevel level) OVERRIDE;
|
|
virtual SuppressionLevel suppression_level() const OVERRIDE;
|
|
virtual int enable_metrics(bool enable) OVERRIDE;
|
|
virtual bool are_metrics_enabled() const OVERRIDE;
|
|
virtual bool stream_has_echo() const OVERRIDE;
|
|
virtual int GetMetrics(Metrics* metrics) OVERRIDE;
|
|
virtual int enable_delay_logging(bool enable) OVERRIDE;
|
|
virtual bool is_delay_logging_enabled() const OVERRIDE;
|
|
virtual int GetDelayMetrics(int* median, int* std) OVERRIDE;
|
|
virtual struct AecCore* aec_core() const OVERRIDE;
|
|
|
|
// ProcessingComponent implementation.
|
|
virtual void* CreateHandle() const OVERRIDE;
|
|
virtual int InitializeHandle(void* handle) const OVERRIDE;
|
|
virtual int ConfigureHandle(void* handle) const OVERRIDE;
|
|
virtual int DestroyHandle(void* handle) const OVERRIDE;
|
|
virtual int num_handles_required() const OVERRIDE;
|
|
virtual int GetHandleError(void* handle) const OVERRIDE;
|
|
|
|
const AudioProcessingImpl* apm_;
|
|
bool drift_compensation_enabled_;
|
|
bool metrics_enabled_;
|
|
SuppressionLevel suppression_level_;
|
|
int device_sample_rate_hz_;
|
|
int stream_drift_samples_;
|
|
bool was_stream_drift_set_;
|
|
bool stream_has_echo_;
|
|
bool delay_logging_enabled_;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // WEBRTC_MODULES_AUDIO_PROCESSING_ECHO_CANCELLATION_IMPL_H_
|