README
1The tools here run an end-to-end audio quality test on Linux using PulseAudio.
2
3INSTALLATION
4The test depends on PulseAudio virtual devices (null sinks). Without additional
5arguments, run_audio_test.py expects a pair of sinks named "capture" and
6"render". To create these devices at machine startup, place the provided
7default.pa file in ~/.pulse. Alternately, the "pacmd" commands therein can be
8run on the command-line to create the devices.
9
10Similarly, place the provided daemon.conf file in ~/.pulse to use high quality
11resampling in PulseAudio. This will reduce the resampling impact on the outcome
12of the test.
13
14Build all WebRTC targets as usual (or just the audio_e2e_harness target) to
15generate the VoiceEngine harness.
16
17USAGE
18Run run_audio_test.py to start. The script has reasonable defaults and will
19use the expected location of audio_e2e_harness. Some settings will usually
20be provided by the user, particularly the comparison tool command-line and
21regular expression to extract the quality metric.
22
23An example command-line, run from trunk/
24
25webrtc/tools/e2e_quality/audio/run_audio_test.py \
26--input=data/voice_engine/audio_short16.pcm --output=e2e_audio_out.pcm \
27--codec=L16 --compare="comparison-tool" --regexp="(\d\.\d{3})"
28