OLD | NEW |
---|---|
1 /* | 1 /* |
2 * Copyright (c) 2017 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2017 The WebRTC project authors. All Rights Reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 #ifndef WEBRTC_API_VIDEO_VIDEO_TIMING_H_ | 11 #ifndef WEBRTC_API_VIDEO_VIDEO_TIMING_H_ |
12 #define WEBRTC_API_VIDEO_VIDEO_TIMING_H_ | 12 #define WEBRTC_API_VIDEO_VIDEO_TIMING_H_ |
13 | 13 |
14 #include <stdint.h> | 14 #include <stdint.h> |
15 #include <limits> | 15 |
16 #include <string> | |
17 | |
16 #include "webrtc/base/checks.h" | 18 #include "webrtc/base/checks.h" |
17 #include "webrtc/base/safe_conversions.h" | 19 #include "webrtc/base/safe_conversions.h" |
18 | 20 |
19 namespace webrtc { | 21 namespace webrtc { |
20 | 22 |
21 // Video timing timstamps in ms counted from capture_time_ms of a frame. | 23 // Video timing timestamps in ms counted from capture_time_ms of a frame. |
22 struct VideoTiming { | 24 // This structure represents data sent in video-timing RTP header extension. |
25 struct VideoSendTiming { | |
23 static const uint8_t kEncodeStartDeltaIdx = 0; | 26 static const uint8_t kEncodeStartDeltaIdx = 0; |
24 static const uint8_t kEncodeFinishDeltaIdx = 1; | 27 static const uint8_t kEncodeFinishDeltaIdx = 1; |
25 static const uint8_t kPacketizationFinishDeltaIdx = 2; | 28 static const uint8_t kPacketizationFinishDeltaIdx = 2; |
26 static const uint8_t kPacerExitDeltaIdx = 3; | 29 static const uint8_t kPacerExitDeltaIdx = 3; |
27 static const uint8_t kNetworkTimestampDeltaIdx = 4; | 30 static const uint8_t kNetworkTimestampDeltaIdx = 4; |
28 static const uint8_t kNetwork2TimestampDeltaIdx = 5; | 31 static const uint8_t kNetwork2TimestampDeltaIdx = 5; |
29 | 32 |
30 // Returns |time_ms - base_ms| capped at max 16-bit value. | 33 // Returns |time_ms - base_ms| capped at max 16-bit value. |
31 // Used to fill this data structure as per | 34 // Used to fill this data structure as per |
32 // https://webrtc.org/experiments/rtp-hdrext/video-timing/ extension stores | 35 // https://webrtc.org/experiments/rtp-hdrext/video-timing/ extension stores |
33 // 16-bit deltas of timestamps from packet capture time. | 36 // 16-bit deltas of timestamps from packet capture time. |
34 static uint16_t GetDeltaCappedMs(int64_t base_ms, int64_t time_ms) { | 37 static uint16_t GetDeltaCappedMs(int64_t base_ms, int64_t time_ms) { |
35 RTC_DCHECK_GE(time_ms, base_ms); | 38 RTC_DCHECK_GE(time_ms, base_ms); |
36 return rtc::saturated_cast<uint16_t>(time_ms - base_ms); | 39 return rtc::saturated_cast<uint16_t>(time_ms - base_ms); |
37 } | 40 } |
38 | 41 |
39 uint16_t encode_start_delta_ms; | 42 uint16_t encode_start_delta_ms; |
40 uint16_t encode_finish_delta_ms; | 43 uint16_t encode_finish_delta_ms; |
41 uint16_t packetization_finish_delta_ms; | 44 uint16_t packetization_finish_delta_ms; |
42 uint16_t pacer_exit_delta_ms; | 45 uint16_t pacer_exit_delta_ms; |
43 uint16_t network_timstamp_delta_ms; | 46 uint16_t network_timstamp_delta_ms; |
44 uint16_t network2_timstamp_delta_ms; | 47 uint16_t network2_timstamp_delta_ms; |
45 bool is_timing_frame; | 48 bool is_timing_frame; |
46 }; | 49 }; |
47 | 50 |
51 // Used to report precise timings of a 'timing frames'. Contains all important | |
52 // timestamps for a lifetime of that specific frame. Reported as a string via | |
53 // GetStats(). Only frame which took the longest between two GetStats calls is | |
54 // reported. | |
55 struct TimingFrameInfo { | |
56 TimingFrameInfo(); | |
57 | |
58 // Returns end-to-end delay of a frame, if sender and receiver timestamps are | |
59 // synchronized, -1 otherwise. | |
60 int64_t EndToEndDelay() const; | |
hbos
2017/06/27 14:08:30
Generally speaking, is there any way to know if th
ilnik
2017/06/27 15:23:56
We know when timestamps are synchronised, because
hbos
2017/07/06 13:27:29
Is this synchronization method and the video-timin
ilnik
2017/07/06 14:30:56
I don't know about synchronization method standard
| |
61 | |
62 // Returns true if current frame took longer to process than |other| frame. | |
63 // If other frame's clocks are not synchronized, current frame is always | |
64 // preferred. | |
65 bool IsLongerThan(const TimingFrameInfo& other) const; | |
66 | |
67 std::string ToString() const; | |
68 | |
69 uint32_t rtp_timestamp; // Identifier of a frame. | |
70 int64_t capture_time_ms; | |
hbos
2017/06/27 14:08:30
Are these relative to session or relative to unix
ilnik
2017/06/27 15:23:56
These are in some local monotonous clock. Added cl
| |
71 int64_t encode_start_ms; | |
72 int64_t encode_finish_ms; | |
73 int64_t packetization_finish_ms; | |
74 int64_t pacer_exit_ms; | |
75 int64_t network_timestamp_ms; // In network RTP processor timestamps: | |
76 int64_t network2_timestamp_ms; // Meaning is application specific. | |
hbos
2017/06/27 14:08:30
nit: If comment spans more than one line add it to
ilnik
2017/06/27 15:23:56
Done.
| |
77 int64_t receive_start_ms; // First received packet time. | |
78 int64_t receive_finish_ms; // Last received packet time. | |
79 int64_t decode_start_ms; | |
80 int64_t decode_finish_ms; | |
81 int64_t render_time_ms; // Inferred smooth render time. | |
hbos
2017/06/27 14:08:31
What does "Inferred smooth render time" mean?
ilnik
2017/06/27 15:23:56
WebRTC provides intended render time for each fram
| |
82 }; | |
83 | |
48 } // namespace webrtc | 84 } // namespace webrtc |
49 | 85 |
50 #endif // WEBRTC_API_VIDEO_VIDEO_TIMING_H_ | 86 #endif // WEBRTC_API_VIDEO_VIDEO_TIMING_H_ |
OLD | NEW |