mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 14:20:45 +01:00
e9cd6177eb
This CL extends the WebRTC testing API to allow audioproc_f -based testing using a pre-created AudioProcessing object. This is an important feature to allow testing any AudioProcessing objects that are injected into WebRTC. Beyond adding this, the CL also changes the simulation code to operate on a scoped_refptr<AudioProcessing> object instead of a std::unique<AudioProcessing> object Bug: webrtc:5298 Change-Id: I70179f19518fc583ad0101bd59c038478a3cc23d Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/175568 Commit-Queue: Per Åhgren <peah@webrtc.org> Reviewed-by: Karl Wiberg <kwiberg@webrtc.org> Reviewed-by: Sam Zackrisson <saza@webrtc.org> Cr-Commit-Position: refs/heads/master@{#31319}
71 lines
3.5 KiB
C++
71 lines
3.5 KiB
C++
/*
|
|
* Copyright (c) 2018 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef API_TEST_AUDIOPROC_FLOAT_H_
|
|
#define API_TEST_AUDIOPROC_FLOAT_H_
|
|
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include "modules/audio_processing/include/audio_processing.h"
|
|
|
|
namespace webrtc {
|
|
namespace test {
|
|
|
|
// This is an interface for the audio processing simulation utility. This
|
|
// utility can be used to simulate the audioprocessing module using a recording
|
|
// (either an AEC dump or wav files), and generate the output as a wav file.
|
|
// Any audio_processing object specified in the input is used for the
|
|
// simulation. The optional |audio_processing| object provides the
|
|
// AudioProcessing instance that is used during the simulation. Note that when
|
|
// the audio_processing object is specified all functionality that relies on
|
|
// using the AudioProcessingBuilder is deactivated, since the AudioProcessing
|
|
// object is already created and the builder is not used in the simulation. It
|
|
// is needed to pass the command line flags as |argc| and |argv|, so these can
|
|
// be interpreted properly by the utility. To see a list of all supported
|
|
// command line flags, run the executable with the '--help' flag.
|
|
int AudioprocFloat(rtc::scoped_refptr<AudioProcessing> audio_processing,
|
|
int argc,
|
|
char* argv[]);
|
|
|
|
// This is an interface for the audio processing simulation utility. This
|
|
// utility can be used to simulate the audioprocessing module using a recording
|
|
// (either an AEC dump or wav files), and generate the output as a wav file.
|
|
// The |ap_builder| object will be used to create the AudioProcessing instance
|
|
// that is used during the simulation. The |ap_builder| supports setting of
|
|
// injectable components, which will be passed on to the created AudioProcessing
|
|
// instance. It is needed to pass the command line flags as |argc| and |argv|,
|
|
// so these can be interpreted properly by the utility.
|
|
// To get a fully-working audioproc_f utility, all that is needed is to write a
|
|
// main function, create an AudioProcessingBuilder, optionally set custom
|
|
// processing components on it, and pass the builder together with the command
|
|
// line arguments into this function.
|
|
// To see a list of all supported command line flags, run the executable with
|
|
// the '--help' flag.
|
|
int AudioprocFloat(std::unique_ptr<AudioProcessingBuilder> ap_builder,
|
|
int argc,
|
|
char* argv[]);
|
|
|
|
// Interface for the audio processing simulation utility, which is similar to
|
|
// the one above, but which adds the option of receiving the input as a string
|
|
// and returning the output as an array. The first three arguments fulfill the
|
|
// same purpose as above. Pass the |input_aecdump| to provide the content of an
|
|
// AEC dump file as a string. After the simulation is completed,
|
|
// |processed_capture_samples| will contain the the samples processed on the
|
|
// capture side.
|
|
int AudioprocFloat(std::unique_ptr<AudioProcessingBuilder> ap_builder,
|
|
int argc,
|
|
char* argv[],
|
|
absl::string_view input_aecdump,
|
|
std::vector<float>* processed_capture_samples);
|
|
} // namespace test
|
|
} // namespace webrtc
|
|
|
|
#endif // API_TEST_AUDIOPROC_FLOAT_H_
|