summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/api/test/neteq_simulator_factory.h
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/libwebrtc/api/test/neteq_simulator_factory.h')
-rw-r--r--third_party/libwebrtc/api/test/neteq_simulator_factory.h71
1 files changed, 71 insertions, 0 deletions
diff --git a/third_party/libwebrtc/api/test/neteq_simulator_factory.h b/third_party/libwebrtc/api/test/neteq_simulator_factory.h
new file mode 100644
index 0000000000..2a716e665e
--- /dev/null
+++ b/third_party/libwebrtc/api/test/neteq_simulator_factory.h
@@ -0,0 +1,71 @@
+/*
+ * 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 filename for the python plot.
+ absl::optional<std::string> python_plot_filename;
+ // A filename for the text log.
+ absl::optional<std::string> text_log_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_