Files
platform-external-webrtc/api/test/neteq_simulator.h
Ivo Creusen 55de08e7ef Restructure neteq_rtpplay into a library with small executable wrapper.
Most of the code in neteq_rtpplay is moved into a factory class for
NetEqTest. The factory method takes the same argc and argv arguments as
neteq_rtpplay.
This CL also adds a small public API for neteq_test to allow easy
integration into external software.

Bug: webrtc:9667
Change-Id: I5241c1f51736cb6fbe47b0ad25f4bc83dabd727d
Reviewed-on: https://webrtc-review.googlesource.com/96100
Commit-Queue: Ivo Creusen <ivoc@webrtc.org>
Reviewed-by: Karl Wiberg <kwiberg@webrtc.org>
Reviewed-by: Henrik Lundin <henrik.lundin@webrtc.org>
Reviewed-by: Minyue Li <minyue@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#24531}
2018-09-03 10:42:40 +00:00

64 lines
2.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_NETEQ_SIMULATOR_H_
#define API_TEST_NETEQ_SIMULATOR_H_
#include <stdint.h>
#include <map>
namespace webrtc {
namespace test {
class NetEqSimulator {
public:
virtual ~NetEqSimulator() = default;
enum class Action { kNormal, kExpand, kAccelerate, kPreemptiveExpand };
// The results of one simulation step.
struct SimulationStepResult {
SimulationStepResult();
SimulationStepResult(const SimulationStepResult& other);
~SimulationStepResult();
bool is_simulation_finished = false;
// The amount of audio produced (in ms) with the actions in this time step.
std::map<Action, int> action_times_ms;
// The amount of wall clock time (in ms) that elapsed since the previous
// event. This is not necessarily equal to the sum of the values in
// action_times_ms.
int64_t simulation_step_ms = 0;
};
struct NetEqState {
// The sum of the packet buffer and sync buffer delay.
int current_delay_ms = 0;
// TODO(ivoc): Expand this struct with more useful metrics.
};
// Runs the simulation until we hit the next GetAudio event. If the simulation
// is finished, is_simulation_finished will be set to true in the returned
// SimulationStepResult.
virtual SimulationStepResult RunToNextGetAudio() = 0;
// Set the next action to be taken by NetEq. This will override any action
// that NetEq would normally decide to take.
virtual void SetNextAction(Action next_operation) = 0;
// Get the current state of NetEq.
virtual NetEqState GetNetEqState() = 0;
};
} // namespace test
} // namespace webrtc
#endif // API_TEST_NETEQ_SIMULATOR_H_