aosp12/external/webrtc/api/test/neteq_simulator_factory.h

68 lines
2.4 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_NETEQ_SIMULATOR_FACTORY_H_
#define API_TEST_NETEQ_SIMULATOR_FACTORY_H_
#include <memory>
#include <string>
#include "absl/strings/string_view.h"
#include "absl/types/optional.h"
#include "api/neteq/neteq_factory.h"
#include "api/test/neteq_simulator.h"
namespace webrtc {
namespace test {
class NetEqTestFactory;
class NetEqSimulatorFactory {
public:
NetEqSimulatorFactory();
~NetEqSimulatorFactory();
struct Config {
// The maximum allowed number of packets in the jitter buffer.
int max_nr_packets_in_buffer = 0;
// The number of audio packets to insert at the start of the simulation.
// Since the simulation is done with a replacement audio file, these
// artificial packets will take a small piece of that replacement audio.
int initial_dummy_packets = 0;
// The number of simulation steps to skip at the start of the simulation.
// This removes incoming packets and GetAudio events from the start of the
// simulation, until the requested number of GetAudio events has been
// removed.
int skip_get_audio_events = 0;
// A WebRTC field trial string to be used during the simulation.
std::string field_trial_string;
// A filename for the generated output audio file.
absl::optional<std::string> output_audio_filename;
// A custom NetEqFactory can be used.
NetEqFactory* neteq_factory = nullptr;
};
std::unique_ptr<NetEqSimulator> CreateSimulatorFromFile(
absl::string_view event_log_filename,
absl::string_view replacement_audio_filename,
Config simulation_config);
// The same as above, but pass the file contents as a string.
std::unique_ptr<NetEqSimulator> CreateSimulatorFromString(
absl::string_view event_log_file_contents,
absl::string_view replacement_audio_file,
Config simulation_config);
private:
std::unique_ptr<NetEqTestFactory> factory_;
};
} // namespace test
} // namespace webrtc
#endif // API_TEST_NETEQ_SIMULATOR_FACTORY_H_