mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 06:10:40 +01:00
8f32b6c18c
This change makes it possible to disable AEC3's render delay controller and delay estimator, and instead rely on an external delay estimator. The delay is communicated via SetAudioBufferDelay. When the feature is enabled, no echo removal will be performed until the first delay is provided. The delay is Bug: b/130016532 Change-Id: I16643109d78d770ff1d2713cf247b0b9cce1bc1c Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/131327 Commit-Queue: Gustaf Ullberg <gustaf@webrtc.org> Reviewed-by: Per Åhgren <peah@webrtc.org> Cr-Commit-Position: refs/heads/master@{#27467}
81 lines
2.7 KiB
C++
81 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_RENDER_DELAY_BUFFER_H_
|
|
#define MODULES_AUDIO_PROCESSING_AEC3_RENDER_DELAY_BUFFER_H_
|
|
|
|
#include <stddef.h>
|
|
#include <vector>
|
|
|
|
#include "api/audio/echo_canceller3_config.h"
|
|
#include "modules/audio_processing/aec3/downsampled_render_buffer.h"
|
|
#include "modules/audio_processing/aec3/render_buffer.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// Class for buffering the incoming render blocks such that these may be
|
|
// extracted with a specified delay.
|
|
class RenderDelayBuffer {
|
|
public:
|
|
enum class BufferingEvent {
|
|
kNone,
|
|
kRenderUnderrun,
|
|
kRenderOverrun,
|
|
kApiCallSkew
|
|
};
|
|
|
|
static RenderDelayBuffer* Create(const EchoCanceller3Config& config,
|
|
size_t num_bands);
|
|
virtual ~RenderDelayBuffer() = default;
|
|
|
|
// Resets the buffer alignment.
|
|
virtual void Reset() = 0;
|
|
|
|
// Inserts a block into the buffer.
|
|
virtual BufferingEvent Insert(
|
|
const std::vector<std::vector<float>>& block) = 0;
|
|
|
|
// Updates the buffers one step based on the specified buffer delay. Returns
|
|
// an enum indicating whether there was a special event that occurred.
|
|
virtual BufferingEvent PrepareCaptureProcessing() = 0;
|
|
|
|
// Sets the buffer delay and returns a bool indicating whether the delay
|
|
// changed.
|
|
virtual bool AlignFromDelay(size_t delay) = 0;
|
|
|
|
// Sets the buffer delay from the most recently reported external delay.
|
|
virtual void AlignFromExternalDelay() = 0;
|
|
|
|
// Gets the buffer delay.
|
|
virtual size_t Delay() const = 0;
|
|
|
|
// Gets the buffer delay.
|
|
virtual size_t MaxDelay() const = 0;
|
|
|
|
// Returns the render buffer for the echo remover.
|
|
virtual RenderBuffer* GetRenderBuffer() = 0;
|
|
|
|
// Returns the downsampled render buffer.
|
|
virtual const DownsampledRenderBuffer& GetDownsampledRenderBuffer() const = 0;
|
|
|
|
// Returns the maximum non calusal offset that can occur in the delay buffer.
|
|
static int DelayEstimatorOffset(const EchoCanceller3Config& config);
|
|
|
|
// Provides an optional external estimate of the audio buffer delay.
|
|
virtual void SetAudioBufferDelay(size_t delay_ms) = 0;
|
|
|
|
// Returns whether an external delay estimate has been reported via
|
|
// SetAudioBufferDelay.
|
|
virtual bool HasReceivedBufferDelay() = 0;
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_AEC3_RENDER_DELAY_BUFFER_H_
|