kjellander@webrtc.org | 8e70108 | 2013-10-10 08:48:16 +0000 | [diff] [blame] | 1 | The tools here run an end-to-end audio quality test on Linux using PulseAudio. |
| 2 | |
| 3 | INSTALLATION |
| 4 | The test depends on PulseAudio virtual devices (null sinks). Without additional |
| 5 | arguments, run_audio_test.py expects a pair of sinks named "capture" and |
| 6 | "render". To create these devices at machine startup, place the provided |
| 7 | default.pa file in ~/.pulse. Alternately, the "pacmd" commands therein can be |
| 8 | run on the command-line to create the devices. |
| 9 | |
| 10 | Similarly, place the provided daemon.conf file in ~/.pulse to use high quality |
| 11 | resampling in PulseAudio. This will reduce the resampling impact on the outcome |
| 12 | of the test. |
| 13 | |
| 14 | Build all WebRTC targets as usual (or just the audio_e2e_harness target) to |
| 15 | generate the VoiceEngine harness. |
| 16 | |
| 17 | USAGE |
| 18 | Run run_audio_test.py to start. The script has reasonable defaults and will |
| 19 | use the expected location of audio_e2e_harness. Some settings will usually |
| 20 | be provided by the user, particularly the comparison tool command-line and |
| 21 | regular expression to extract the quality metric. |
| 22 | |
| 23 | An example command-line, run from trunk/ |
| 24 | |
| 25 | webrtc/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})" |