/* * 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. */ #include "media/engine/apm_helpers.h" #include "modules/audio_device/include/audio_device.h" #include "modules/audio_processing/include/audio_processing.h" #include "rtc_base/logging.h" #include "voice_engine/transmit_mixer.h" namespace webrtc { namespace apm_helpers { void Init(AudioProcessing* apm) { RTC_DCHECK(apm); constexpr int kMinVolumeLevel = 0; constexpr int kMaxVolumeLevel = 255; // This is the initialization which used to happen in VoEBase::Init(), but // which is not covered by the WVoE::ApplyOptions(). if (apm->echo_cancellation()->enable_drift_compensation(false) != 0) { RTC_DLOG(LS_ERROR) << "Failed to disable drift compensation."; } GainControl* gc = apm->gain_control(); if (gc->set_analog_level_limits(kMinVolumeLevel, kMaxVolumeLevel) != 0) { RTC_DLOG(LS_ERROR) << "Failed to set analog level limits with minimum: " << kMinVolumeLevel << " and maximum: " << kMaxVolumeLevel; } } AgcConfig GetAgcConfig(AudioProcessing* apm) { RTC_DCHECK(apm); AgcConfig result; result.targetLeveldBOv = apm->gain_control()->target_level_dbfs(); result.digitalCompressionGaindB = apm->gain_control()->compression_gain_db(); result.limiterEnable = apm->gain_control()->is_limiter_enabled(); return result; } void SetAgcConfig(AudioProcessing* apm, const AgcConfig& config) { RTC_DCHECK(apm); GainControl* gc = apm->gain_control(); if (gc->set_target_level_dbfs(config.targetLeveldBOv) != 0) { RTC_LOG(LS_ERROR) << "Failed to set target level: " << config.targetLeveldBOv; } if (gc->set_compression_gain_db(config.digitalCompressionGaindB) != 0) { RTC_LOG(LS_ERROR) << "Failed to set compression gain: " << config.digitalCompressionGaindB; } if (gc->enable_limiter(config.limiterEnable) != 0) { RTC_LOG(LS_ERROR) << "Failed to set limiter on/off: " << config.limiterEnable; } } void SetAgcStatus(AudioProcessing* apm, AudioDeviceModule* adm, bool enable) { RTC_DCHECK(apm); RTC_DCHECK(adm); #if defined(WEBRTC_IOS) || defined(WEBRTC_ANDROID) GainControl::Mode agc_mode = GainControl::kFixedDigital; #else GainControl::Mode agc_mode = GainControl::kAdaptiveAnalog; #endif GainControl* gc = apm->gain_control(); if (gc->set_mode(agc_mode) != 0) { RTC_LOG(LS_ERROR) << "Failed to set AGC mode: " << agc_mode; return; } if (gc->Enable(enable) != 0) { RTC_LOG(LS_ERROR) << "Failed to enable/disable AGC: " << enable; return; } // Set AGC state in the ADM when adaptive AGC mode has been selected. if (adm->SetAGC(enable && agc_mode == GainControl::kAdaptiveAnalog) != 0) { RTC_LOG(LS_ERROR) << "Failed to set AGC mode in ADM: " << enable; return; } RTC_LOG(LS_INFO) << "AGC set to " << enable << " with mode " << agc_mode; } void SetEcStatus(AudioProcessing* apm, bool enable, EcModes mode) { RTC_DCHECK(apm); RTC_DCHECK(mode == kEcConference || mode == kEcAecm) << "mode: " << mode; EchoCancellation* ec = apm->echo_cancellation(); EchoControlMobile* ecm = apm->echo_control_mobile(); if (mode == kEcConference) { // Disable the AECM before enabling the AEC. if (enable && ecm->is_enabled() && ecm->Enable(false) != 0) { RTC_LOG(LS_ERROR) << "Failed to disable AECM."; return; } if (ec->Enable(enable) != 0) { RTC_LOG(LS_ERROR) << "Failed to enable/disable AEC: " << enable; return; } if (ec->set_suppression_level(EchoCancellation::kHighSuppression) != 0) { RTC_LOG(LS_ERROR) << "Failed to set high AEC aggressiveness."; return; } } else { // Disable the AEC before enabling the AECM. if (enable && ec->is_enabled() && ec->Enable(false) != 0) { RTC_LOG(LS_ERROR) << "Failed to disable AEC."; return; } if (ecm->Enable(enable) != 0) { RTC_LOG(LS_ERROR) << "Failed to enable/disable AECM: " << enable; return; } } RTC_LOG(LS_INFO) << "Echo control set to " << enable << " with mode " << mode; } void SetEcMetricsStatus(AudioProcessing* apm, bool enable) { RTC_DCHECK(apm); if ((apm->echo_cancellation()->enable_metrics(enable) != 0) || (apm->echo_cancellation()->enable_delay_logging(enable) != 0)) { RTC_LOG(LS_ERROR) << "Failed to enable/disable EC metrics: " << enable; return; } RTC_LOG(LS_INFO) << "EC metrics set to " << enable; } void SetAecmMode(AudioProcessing* apm, bool enable) { RTC_DCHECK(apm); EchoControlMobile* ecm = apm->echo_control_mobile(); RTC_DCHECK_EQ(EchoControlMobile::kSpeakerphone, ecm->routing_mode()); if (ecm->enable_comfort_noise(enable) != 0) { RTC_LOG(LS_ERROR) << "Failed to enable/disable CNG: " << enable; return; } RTC_LOG(LS_INFO) << "CNG set to " << enable; } void SetNsStatus(AudioProcessing* apm, bool enable) { RTC_DCHECK(apm); NoiseSuppression* ns = apm->noise_suppression(); if (ns->set_level(NoiseSuppression::kHigh) != 0) { RTC_LOG(LS_ERROR) << "Failed to set high NS level."; return; } if (ns->Enable(enable) != 0) { RTC_LOG(LS_ERROR) << "Failed to enable/disable NS: " << enable; return; } RTC_LOG(LS_INFO) << "NS set to " << enable; } void SetTypingDetectionStatus(AudioProcessing* apm, bool enable) { RTC_DCHECK(apm); #if WEBRTC_VOICE_ENGINE_TYPING_DETECTION // Typing detection takes place in TransmitMixer::PrepareDemux() and // TransmitMixer::TypingDetection(). The typing detection algorithm takes as // input two booleans: // 1. A signal whether a key was pressed during the audio frame. // 2. Whether VAD is active or not. // TransmitMixer will not even call the detector if APM has set kVadUnknown in // the audio frame after near end processing, so enabling/disabling VAD is // sufficient for turning typing detection on/off. // TODO(solenberg): Rather than relying on a side effect, consider forcing the // feature on/off in TransmitMixer. VoiceDetection* vd = apm->voice_detection(); if (vd->Enable(enable)) { RTC_LOG(LS_ERROR) << "Failed to enable/disable VAD: " << enable; return; } if (vd->set_likelihood(VoiceDetection::kVeryLowLikelihood)) { RTC_LOG(LS_ERROR) << "Failed to set low VAD likelihood."; return; } RTC_LOG(LS_INFO) << "VAD set to " << enable << " for typing detection."; #endif } } // namespace apm_helpers } // namespace webrtc