webrtc/modules/audio_processing/include
Alessio Bazzica fcf1af3049 APM: add AudioProcessingImpl::capture_::applied_input_volume(_changed)
The `recommended_stream_analog_level()` getter is used to retrieve
both the applied and the recommended input volume. This behavior is
error-prone since the caller must know what is returned based on
the point in the code (namely, before/after the AGC has changed
the last applied input volume into a recommended level).

This CL is a first step to make clarity on which input volume is
handled in different parts of APM. Next in the pipeline: make
`recommended_stream_analog_level()` a trivial getter that always
returns the recommended level.

Main changes:
- When `recommended_stream_analog_level()` is called but
  `set_stream_analog_level()` is not called, APM logs an error
  and returns a fall-back volume (which should not be applied
  since, when `set_stream_analog_level()` is not called, no
  external input volume is expected to be present
- When APM is used without calling the `*_stream_analog_level()`
  methods (e.g., when the caller does not provide any input volume),
  the recorded AEC dumps won't store `Stream::applied_input_level`

Other changes:
- Removed `AudioProcessingImpl::capture_::prev_analog_mic_level`
- Removed redundant code in `GainController2` around detecting
  input volume changes (already done by APM)
- Adapted the `audioproc_f` and `unpack_aecdump` tools
- Data dumps clean-up: the applied and the recommended input
  volumes are now recorded in an AGC implementation agnostic way

Bug: webrtc:7494, b/241923537
Change-Id: I3cb4a731fd9f3dc19bf6ac679b7ed8c969ea283b
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/271544
Reviewed-by: Per Åhgren <peah@webrtc.org>
Reviewed-by: Hanna Silen <silen@webrtc.org>
Commit-Queue: Alessio Bazzica <alessiob@webrtc.org>
Cr-Commit-Position: refs/heads/main@{#38054}
2022-09-09 17:36:05 +00:00
..
aec_dump.cc Fixes to support building in -std=c++20 mode. 2022-05-05 17:15:58 +00:00
aec_dump.h APM: add AudioProcessingImpl::capture_::applied_input_volume(_changed) 2022-09-09 17:36:05 +00:00
audio_frame_proxies.cc Remove more traces of keyboard mic support from APM 2022-02-04 14:27:51 +00:00
audio_frame_proxies.h Use backticks not vertical bars to denote variables in comments for /modules/audio_processing 2021-08-09 21:49:02 +00:00
audio_frame_view.h AudioFrameView: size_t -> int 2021-10-07 14:41:03 +00:00
audio_processing.cc Reland "Reland "Remove unused APM voice activity detection sub-module"" 2022-02-16 08:41:30 +00:00
audio_processing.h APM: add AudioProcessingImpl::capture_::applied_input_volume(_changed) 2022-09-09 17:36:05 +00:00
audio_processing_statistics.cc Use the new AudioProcessing statistics everywhere. 2017-11-24 18:17:39 +00:00
audio_processing_statistics.h Reland "Reland "Remove unused APM voice activity detection sub-module"" 2022-02-16 08:41:30 +00:00
mock_audio_processing.h Remove unnecessary overload 2022-08-11 12:34:32 +00:00