/* * Copyright (c) 2016 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 MODULES_AUDIO_CODING_NETEQ_TOOLS_NETEQ_INPUT_H_ #define MODULES_AUDIO_CODING_NETEQ_TOOLS_NETEQ_INPUT_H_ #include #include #include #include "absl/types/optional.h" #include "modules/audio_coding/neteq/tools/packet.h" #include "modules/audio_coding/neteq/tools/packet_source.h" #include "rtc_base/buffer.h" namespace webrtc { namespace test { // Interface class for input to the NetEqTest class. class NetEqInput { public: class Event { public: enum class Type { kPacketData, kGetAudio, kSetMinimumDelay }; virtual Type type() = 0; virtual int64_t timestamp_ms() const = 0; virtual ~Event() = default; }; class PacketData : public Event { public: PacketData(); ~PacketData(); Type type() override { return Type::kPacketData; } int64_t timestamp_ms() const override { return timestamp_ms_; } std::string ToString() const; RTPHeader header; rtc::Buffer payload; int64_t timestamp_ms_; }; class SetMinimumDelay : public Event { public: SetMinimumDelay(int64_t timestamp_ms_in, int delay_ms_in) : timestamp_ms_(timestamp_ms_in), delay_ms_(delay_ms_in) {} Type type() override { return Type::kSetMinimumDelay; } int64_t timestamp_ms() const override { return timestamp_ms_; } int delay_ms() { return delay_ms_; } private: int64_t timestamp_ms_; int delay_ms_; }; class GetAudio : public Event { public: explicit GetAudio(int64_t timestamp_ms_in) : timestamp_ms_(timestamp_ms_in) {} Type type() override { return Type::kGetAudio; } int64_t timestamp_ms() const override { return timestamp_ms_; } private: int64_t timestamp_ms_; }; virtual ~NetEqInput() = default; virtual std::unique_ptr PopEvent() = 0; // Returns true if the source has come to an end. An implementation must // eventually return true from this method, or the test will end up in an // infinite loop. virtual bool ended() const = 0; // Returns the RTP header for the next packet, i.e., the packet that will be // delivered next by PopPacket(). virtual absl::optional NextHeader() const = 0; // Returns the time (in ms) for the next event, or empty if both are out of // events. virtual absl::optional NextEventTime() const = 0; }; // Wrapper class to impose a time limit on a NetEqInput object, typically // another time limit than what the object itself provides. For example, an // input taken from a file can be cut shorter by wrapping it in this class. class TimeLimitedNetEqInput : public NetEqInput { public: TimeLimitedNetEqInput(std::unique_ptr input, int64_t duration_ms); ~TimeLimitedNetEqInput() override; absl::optional NextEventTime() const override; std::unique_ptr PopEvent() override; bool ended() const override; absl::optional NextHeader() const override; private: void MaybeSetEnded(); std::unique_ptr input_; const absl::optional start_time_ms_; const int64_t duration_ms_; bool ended_ = false; }; } // namespace test } // namespace webrtc #endif // MODULES_AUDIO_CODING_NETEQ_TOOLS_NETEQ_INPUT_H_