webrtc/modules/audio_processing/test/conversational_speech
Mirko Bonadei 86d053c2db Use source_sets in component builds and static_library in release builds.
Static libraries don't guarantee that an exported symbol gets linked
into a shared library (and in order to support Chromium's component
build mode, WebRTC needs to be linked as a shared library).

Source sets always pass all the object files to the linker.

On the flip side, source_sets link more object files in release builds
and to avoid this, this CL introduces a the GN template "rtc_library" that
expands to static_library during release builds and to source_set during
component builds.

See: https://gn.googlesource.com/gn/+/master/docs/reference.md#func_source_set

Bug: webrtc:9419
Change-Id: I4667e820c2b3fcec417becbd2034acc13e4f04fe
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/157168
Commit-Queue: Mirko Bonadei <mbonadei@webrtc.org>
Reviewed-by: Karl Wiberg <kwiberg@webrtc.org>
Reviewed-by: Nico Weber <thakis@chromium.org>
Cr-Commit-Position: refs/heads/master@{#29525}
2019-10-17 21:17:18 +00:00
..
BUILD.gn Use source_sets in component builds and static_library in release builds. 2019-10-17 21:17:18 +00:00
config.cc
config.h
generator.cc Use std::make_unique instead of absl::make_unique. 2019-09-17 15:47:29 +00:00
generator_unittest.cc Format almost everything. 2019-07-08 13:45:15 +00:00
mock_wavreader.cc Fully qualify googletest symbols. 2019-04-09 17:18:20 +00:00
mock_wavreader.h Delete root header file typedef.h. 2018-07-25 14:59:26 +00:00
mock_wavreader_factory.cc Fully qualify googletest symbols. 2019-04-09 17:18:20 +00:00
mock_wavreader_factory.h Reformat the WebRTC code base 2018-06-19 14:00:39 +00:00
multiend_call.cc (4) Rename files to snake_case: update BUILD.gn, include paths, header guards, and DEPS entries 2019-01-11 17:11:39 +00:00
multiend_call.h Format almost everything. 2019-07-08 13:45:15 +00:00
OWNERS
README.md Change levels of different speech signal in tool. 2018-01-22 14:19:28 +00:00
simulator.cc Use std::make_unique instead of absl::make_unique. 2019-09-17 15:47:29 +00:00
simulator.h (4) Rename files to snake_case: update BUILD.gn, include paths, header guards, and DEPS entries 2019-01-11 17:11:39 +00:00
timing.cc (4) Rename files to snake_case: update BUILD.gn, include paths, header guards, and DEPS entries 2019-01-11 17:11:39 +00:00
timing.h Reformat the WebRTC code base 2018-06-19 14:00:39 +00:00
wavreader_abstract_factory.h
wavreader_factory.cc Delete root header file typedef.h. 2018-07-25 14:59:26 +00:00
wavreader_factory.h Reformat the WebRTC code base 2018-06-19 14:00:39 +00:00
wavreader_interface.h Delete root header file typedef.h. 2018-07-25 14:59:26 +00:00

Conversational Speech generator tool

Tool to generate multiple-end audio tracks to simulate conversational speech with two or more participants.

The input to the tool is a directory containing a number of audio tracks and a text file indicating how to time the sequence of speech turns (see the Example section).

Since the timing of the speaking turns is specified by the user, the generated tracks may not be suitable for testing scenarios in which there is unpredictable network delay (e.g., end-to-end RTC assessment).

Instead, the generated pairs can be used when the delay is constant (obviously including the case in which there is no delay). For instance, echo cancellation in the APM module can be evaluated using two-end audio tracks as input and reverse input.

By indicating negative and positive time offsets, one can reproduce cross-talk (aka double-talk) and silence in the conversation.

Example

For each end, there is a set of audio tracks, e.g., a1, a2 and a3 (speaker A) and b1, b2 (speaker B). The text file with the timing information may look like this:

A a1 0
B b1 0
A a2 100
B b2 -200
A a3 0
A a4 0

The first column indicates the speaker name, the second contains the audio track file names, and the third the offsets (in milliseconds) used to concatenate the chunks. An optional fourth column contains positive or negative integral gains in dB that will be applied to the tracks. It's possible to specify the gain for some turns but not for others. If the gain is left out, no gain is applied.

Assume that all the audio tracks in the example above are 1000 ms long. The tool will then generate two tracks (A and B) that look like this:

Track A

  a1 (1000 ms)
  silence (1100 ms)
  a2 (1000 ms)
  silence (800 ms)
  a3 (1000 ms)
  a4 (1000 ms)

Track B

  silence (1000 ms)
  b1 (1000 ms)
  silence (900 ms)
  b2 (1000 ms)
  silence (2000 ms)

The two tracks can be also visualized as follows (one characheter represents 100 ms, "." is silence and "*" is speech).

t: 0         1        2        3        4        5        6 (s)
A: **********...........**********........********************
B: ..........**********.........**********....................
                                ^ 200 ms cross-talk
        100 ms silence ^