24c35756f4
New api ensures field trials are available at construction time of the AudioProcessing object. This would allow AudioProcessing implementation to use propagated field trials during construction. Also, short term, it ensures AudioProcessing is constructed after global field trials are set. Bug: webrtc:369904700 Change-Id: If3d00c8a3a509299cd0915d55f13a9a3ce4a7140 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/367201 Reviewed-by: Sam Zackrisson <saza@webrtc.org> Reviewed-by: Harald Alvestrand <hta@webrtc.org> Commit-Queue: Danil Chapovalov <danilchap@webrtc.org> Cr-Commit-Position: refs/heads/main@{#43340}
88 lines
4.0 KiB
C++
88 lines
4.0 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 "absl/base/nullability.h"
|
|
#include "api/audio/audio_processing.h"
|
|
#include "api/audio/builtin_audio_processing_builder.h"
|
|
#include "api/scoped_refptr.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.
|
|
//
|
|
// 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 '--helpfull' flag.
|
|
//
|
|
// The optional `ap_builder` object will be used to create the AudioProcessing
|
|
// instance that is used during the simulation. BuiltinAudioProcessingBuilder
|
|
// `ap_builder` supports setting of injectable components, which will be passed
|
|
// on to the created AudioProcessing instance. When generic
|
|
// `AudioProcessingBuilderInterface` is used, all functionality that relies on
|
|
// using the BuiltinAudioProcessingBuilder is deactivated.
|
|
int AudioprocFloat(int argc, char* argv[]);
|
|
int AudioprocFloat(
|
|
absl::Nonnull<std::unique_ptr<BuiltinAudioProcessingBuilder>> ap_builder,
|
|
int argc,
|
|
char* argv[]);
|
|
int AudioprocFloat(
|
|
absl::Nonnull<std::unique_ptr<AudioProcessingBuilderInterface>> ap_builder,
|
|
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.
|
|
// 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.
|
|
[[deprecated]] 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.
|
|
[[deprecated]] int AudioprocFloat(
|
|
std::unique_ptr<AudioProcessingBuilder> ap_builder,
|
|
int argc,
|
|
char* argv[]);
|
|
|
|
} // namespace test
|
|
} // namespace webrtc
|
|
|
|
#endif // API_TEST_AUDIOPROC_FLOAT_H_
|