20ed36dada
The goal with this new clock interface is to have something which is used all over WebRTC to make it easier to switch clock implementation depending on where the components are used. This is a first step in that direction. Next steps will be to, step by step, move all modules, video engine and voice engine over to the new interface, effectively deprecating the old clock interfaces. Long-term my vision is that we should be able to deprecate the clock of WebRTC and rely on the user providing the implementation. TEST=vie_auto_test, rtp_rtcp_unittests, trybots Review URL: https://webrtc-codereview.appspot.com/1041004 git-svn-id: http://webrtc.googlecode.com/svn/trunk@3381 4adac7df-926f-26a2-2b94-8c16560cd09d
74 lines
2.2 KiB
C++
74 lines
2.2 KiB
C++
/*
|
|
* Copyright (c) 2013 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 WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CLOCK_H_
|
|
#define WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CLOCK_H_
|
|
|
|
#include "webrtc/typedefs.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// January 1970, in NTP seconds.
|
|
const uint32_t kNtpJan1970 = 2208988800UL;
|
|
|
|
// Magic NTP fractional unit.
|
|
const double kMagicNtpFractionalUnit = 4.294967296E+9;
|
|
|
|
// A clock interface that allows reading of absolute and relative timestamps.
|
|
class Clock {
|
|
public:
|
|
virtual ~Clock() {}
|
|
|
|
// Return a timestamp in milliseconds relative to some arbitrary source; the
|
|
// source is fixed for this clock.
|
|
virtual int64_t TimeInMilliseconds() = 0;
|
|
|
|
// Return a timestamp in microseconds relative to some arbitrary source; the
|
|
// source is fixed for this clock.
|
|
virtual int64_t TimeInMicroseconds() = 0;
|
|
|
|
// Retrieve an NTP absolute timestamp.
|
|
virtual void CurrentNtp(uint32_t& seconds, uint32_t& fractions) = 0;
|
|
|
|
// Returns an instance of the real-time system clock implementation.
|
|
static Clock* GetRealTimeClock();
|
|
};
|
|
|
|
class SimulatedClock : public Clock {
|
|
public:
|
|
SimulatedClock();
|
|
explicit SimulatedClock(int64_t initial_time_us);
|
|
|
|
virtual ~SimulatedClock() {}
|
|
|
|
// Return a timestamp in milliseconds relative to some arbitrary source; the
|
|
// source is fixed for this clock.
|
|
virtual int64_t TimeInMilliseconds();
|
|
|
|
// Return a timestamp in microseconds relative to some arbitrary source; the
|
|
// source is fixed for this clock.
|
|
virtual int64_t TimeInMicroseconds();
|
|
|
|
// Retrieve an NTP absolute timestamp.
|
|
virtual void CurrentNtp(uint32_t& seconds, uint32_t& fractions);
|
|
|
|
// Advance the simulated clock with a given number of milliseconds or
|
|
// microseconds.
|
|
void AdvanceTimeMs(int64_t milliseconds);
|
|
void AdvanceTimeUs(int64_t microseconds);
|
|
|
|
private:
|
|
int64_t time_us_;
|
|
};
|
|
|
|
}; // namespace webrtc
|
|
|
|
#endif // WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CLOCK_H_
|