2019-06-04 10:14:50 +00:00
|
|
|
/*
|
|
|
|
* 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_GAIN_CONTROLLER2_H_
|
|
|
|
#define MODULES_AUDIO_PROCESSING_GAIN_CONTROLLER2_H_
|
|
|
|
|
|
|
|
#include <memory>
|
|
|
|
#include <string>
|
|
|
|
|
2022-03-11 16:49:54 +00:00
|
|
|
#include "modules/audio_processing/agc2/adaptive_digital_gain_controller.h"
|
|
|
|
#include "modules/audio_processing/agc2/cpu_features.h"
|
2019-06-04 10:14:50 +00:00
|
|
|
#include "modules/audio_processing/agc2/gain_applier.h"
|
|
|
|
#include "modules/audio_processing/agc2/limiter.h"
|
2022-03-11 16:49:54 +00:00
|
|
|
#include "modules/audio_processing/agc2/vad_wrapper.h"
|
2019-06-04 10:14:50 +00:00
|
|
|
#include "modules/audio_processing/include/audio_processing.h"
|
2021-06-25 00:43:10 +00:00
|
|
|
#include "modules/audio_processing/logging/apm_data_dumper.h"
|
2019-06-04 10:14:50 +00:00
|
|
|
|
|
|
|
namespace webrtc {
|
|
|
|
|
|
|
|
class AudioBuffer;
|
|
|
|
|
|
|
|
// Gain Controller 2 aims to automatically adjust levels by acting on the
|
|
|
|
// microphone gain and/or applying digital gain.
|
|
|
|
class GainController2 {
|
|
|
|
public:
|
2022-03-11 16:49:54 +00:00
|
|
|
GainController2(const AudioProcessing::Config::GainController2& config,
|
|
|
|
int sample_rate_hz,
|
|
|
|
int num_channels);
|
2021-06-25 00:43:10 +00:00
|
|
|
GainController2(const GainController2&) = delete;
|
|
|
|
GainController2& operator=(const GainController2&) = delete;
|
2019-06-04 10:14:50 +00:00
|
|
|
~GainController2();
|
|
|
|
|
2022-03-11 16:49:54 +00:00
|
|
|
// Detects and handles changes of sample rate and/or number of channels.
|
2021-06-25 00:43:10 +00:00
|
|
|
void Initialize(int sample_rate_hz, int num_channels);
|
2022-03-11 16:49:54 +00:00
|
|
|
|
|
|
|
// Sets the fixed digital gain.
|
|
|
|
void SetFixedGainDb(float gain_db);
|
|
|
|
|
|
|
|
// Applies fixed and adaptive digital gains to `audio` and runs a limiter.
|
2019-06-04 10:14:50 +00:00
|
|
|
void Process(AudioBuffer* audio);
|
2022-03-11 16:49:54 +00:00
|
|
|
|
|
|
|
// Handles analog level changes.
|
2019-06-04 10:14:50 +00:00
|
|
|
void NotifyAnalogLevel(int level);
|
|
|
|
|
|
|
|
static bool Validate(const AudioProcessing::Config::GainController2& config);
|
|
|
|
|
|
|
|
private:
|
|
|
|
static int instance_count_;
|
2022-03-11 16:49:54 +00:00
|
|
|
const AvailableCpuFeatures cpu_features_;
|
2021-06-25 00:43:10 +00:00
|
|
|
ApmDataDumper data_dumper_;
|
2022-03-11 16:49:54 +00:00
|
|
|
GainApplier fixed_gain_applier_;
|
|
|
|
std::unique_ptr<VoiceActivityDetectorWrapper> vad_;
|
|
|
|
std::unique_ptr<AdaptiveDigitalGainController> adaptive_digital_controller_;
|
2019-06-04 10:14:50 +00:00
|
|
|
Limiter limiter_;
|
2021-06-25 00:43:10 +00:00
|
|
|
int calls_since_last_limiter_log_;
|
2022-03-11 16:49:54 +00:00
|
|
|
int analog_level_;
|
2019-06-04 10:14:50 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace webrtc
|
|
|
|
|
|
|
|
#endif // MODULES_AUDIO_PROCESSING_GAIN_CONTROLLER2_H_
|