No description
Find a file
Sam Zackrisson 03cb7e5a61 APM: Make echo detector an optionally compilable and injectable component
Important: This change does not in any way affect echo cancellation or standardized stats. The user audio experience is unchanged. Only non-standard stats are affected. Echo return loss metrics are unchanged. Residual echo likelihood {recent max} will no longer be computed by default.

Important: The echo detector is no longer enabled by default.

API change, PSA: https://groups.google.com/g/discuss-webrtc/c/mJV5cDysBDI/m/7PTPBjVHCgAJ

This CL removes the default usage of the residual echo detector in APM.
It can now only be used via injection and the helper function webrtc::CreateEchoDetector. See how the function audio_processing_unittest.cc:CreateApm() changed, for an example.

The echo detector implementation is marked poisonous, to avoid accidental dependencies.

Some cleanup is done:
- EchoDetector::PackRenderAudioBuffer is declared in one target but is defined in another target. It is not necessary to keep in the API. It is made an implementation detail, and the echo detector input is documented in the API.
- The internal state of APM is large and difficult to track. Submodule pointers that are set permanently on construction are now appropriately marked const.

Tested:
- existing + new unit tests
- audioproc_f is bitexact on a large number of aecdumps

Bug: webrtc:11539
Change-Id: I00cc2ee112fedb06451a533409311605220064d0
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/239652
Reviewed-by: Ivo Creusen <ivoc@webrtc.org>
Reviewed-by: Per Kjellander <perkj@webrtc.org>
Reviewed-by: Mirko Bonadei <mbonadei@webrtc.org>
Commit-Queue: Sam Zackrisson <saza@webrtc.org>
Cr-Commit-Position: refs/heads/main@{#35550}
2021-12-16 17:39:11 +00:00
api APM: Make echo detector an optionally compilable and injectable component 2021-12-16 17:39:11 +00:00
audio Fix mb.py presubmit issues. 2021-12-08 08:53:00 +00:00
build_overrides Roll chromium + fix: blacklist -> ignorelist for sanitizers suppressions 2021-05-27 16:16:01 +00:00
call Update WebRTC code version (2021-12-16T04:04:48). 2021-12-16 05:52:50 +00:00
common_audio Prepare to rename RTC_NOTREACHED to RTC_DCHECK_NOTREACHED 2021-11-15 21:44:59 +00:00
common_video Prepare to rename RTC_NOTREACHED to RTC_DCHECK_NOTREACHED 2021-11-15 21:44:59 +00:00
data Remove old data files. 2018-10-05 14:40:21 +00:00
docs Add contributing.md 2021-11-03 14:59:46 +00:00
examples Implement JNI and objc implementation for icecandidateerror event 2021-12-14 14:19:38 +00:00
g3doc Add static AsString functions for PeerConnectionInterface enums 2021-11-02 12:29:50 +00:00
logging Prepare to rename RTC_NOTREACHED to RTC_DCHECK_NOTREACHED 2021-11-15 21:44:59 +00:00
media APM: Make echo detector an optionally compilable and injectable component 2021-12-16 17:39:11 +00:00
modules APM: Make echo detector an optionally compilable and injectable component 2021-12-16 17:39:11 +00:00
net/dcsctp Revert "dcsctp: Use rtc::CopyOnWriteBuffer" 2021-12-02 12:33:46 +00:00
p2p Fix TestTurnServer to not depend on rtc::Thread::socketserver() accessor 2021-11-29 21:10:31 +00:00
pc Remove unused 4-argument version of OnIceCandidateError. 2021-12-15 09:55:30 +00:00
resources Remove perf test isac_fix_test. 2021-12-14 16:52:58 +00:00
rtc_base Deprecate BasicNetworkManager default constructor 2021-12-09 12:10:20 +00:00
rtc_tools Prepare to rename RTC_NOTREACHED to RTC_DCHECK_NOTREACHED 2021-11-15 21:44:59 +00:00
sdk Implement JNI and objc implementation for icecandidateerror event 2021-12-14 14:19:38 +00:00
stats Implement missing candidate pair packets/bytes sent/received stats. 2021-09-28 23:27:05 +00:00
system_wrappers Prepare to rename RTC_NOTREACHED to RTC_DCHECK_NOTREACHED 2021-11-15 21:44:59 +00:00
test APM: Make echo detector an optionally compilable and injectable component 2021-12-16 17:39:11 +00:00
tools_webrtc Remove perf test isac_fix_test. 2021-12-14 16:52:58 +00:00
video ZeroHertzAdapterMode: slow down repeats on quality convergence. 2021-12-16 12:01:30 +00:00
.clang-format Add IncludeBlocks to clang-format. 2021-02-03 16:29:07 +00:00
.git-blame-ignore-revs Let git-hyper-blame ignore new format cleanup. 2019-07-11 16:18:51 +00:00
.gitignore Add .cache to .gitignore. 2021-01-20 15:01:07 +00:00
.gn Roll chromium_revision 867b87eb29..b56d8868f3 (933713:941610) 2021-11-15 17:34:08 +00:00
.style.yapf Fix mb.py presubmit issues. 2021-12-08 08:53:00 +00:00
.vpython Update links to point at main branch 2021-07-22 16:41:26 +00:00
.vpython3 DEPS: use python3 2021-11-29 07:27:52 +00:00
AUTHORS Added main profile to supported H264 codecs 2021-11-10 10:56:13 +00:00
BUILD.gn APM: Make echo detector an optionally compilable and injectable component 2021-12-16 17:39:11 +00:00
CODE_OF_CONDUCT.md Reference "main" branches instead of "master" branches. 2021-07-15 11:07:44 +00:00
codereview.settings Don't add webrtc-reviews@ to CC, it can be added globally on Gerrit 2018-10-25 08:19:53 +00:00
DEPS Roll chromium_revision 7eb19998e7..389e3b2529 (952228:952342) 2021-12-16 14:49:52 +00:00
DIR_METADATA Move metadata in OWNERS files to DIR_METADATA files. 2021-02-08 19:09:33 +00:00
ENG_REVIEW_OWNERS Remove phoglund from ENG_REVIEW_OWNERS 2021-10-08 08:29:42 +00:00
g3doc.lua Improve webrtc documentation infra. Preview at: 2021-03-30 10:29:30 +00:00
LICENSE Moving src/webrtc into src/. 2017-09-15 04:25:06 +00:00
license_template.txt Update template to follow chromium copyright style 2013-04-24 01:01:28 +00:00
native-api.md Reference "main" branches instead of "master" branches. 2021-07-15 11:07:44 +00:00
OWNERS Fix mb.py presubmit issues. 2021-12-08 08:53:00 +00:00
PATENTS Moving src/webrtc into src/. 2017-09-15 04:25:06 +00:00
PRESUBMIT.py fix some typos 2021-08-12 18:37:10 +00:00
presubmit_test.py Add presubmit check to guard against assert() usage. 2021-07-22 17:08:26 +00:00
presubmit_test_mocks.py Add presubmit check to guard against assert() usage. 2021-07-22 17:08:26 +00:00
pylintrc Fix mb.py presubmit issues. 2021-12-08 08:53:00 +00:00
README.chromium Add CPEPrefix. 2020-07-13 11:42:07 +00:00
README.md doc: add g3doc sitemap to toplevel readme 2021-07-23 07:55:17 +00:00
WATCHLISTS Update WATCHLISTS 2021-08-23 13:37:55 +00:00
webrtc.gni APM: Make echo detector an optionally compilable and injectable component 2021-12-16 17:39:11 +00:00
webrtc_lib_link_test.cc Deprecate PeerConnectionFactory::CreatePeerConnection 2021-05-10 08:47:48 +00:00
whitespace.txt Test LKGR finder. 2021-09-24 20:09:34 +00:00

WebRTC is a free, open software project that provides browsers and mobile applications with Real-Time Communications (RTC) capabilities via simple APIs. The WebRTC components have been optimized to best serve this purpose.

Our mission: To enable rich, high-quality RTC applications to be developed for the browser, mobile platforms, and IoT devices, and allow them all to communicate via a common set of protocols.

The WebRTC initiative is a project supported by Google, Mozilla and Opera, amongst others.

Development

See here for instructions on how to get started developing with the native code.

Authoritative list of directories that contain the native API header files.

More info